> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Portais de clientes: relatórios de chamadas somente leitura com sua marca

> Crie um portal de clientes do ThunderPhone, escolha agentes visíveis, adicione visualizadores, personalize a experiência com sua marca, conecte um domínio personalizado e compartilhe o histórico de chamadas somente leitura.

**Portais de clientes** oferecem a cada cliente uma visualização de marca e somente leitura das chamadas atendidas
para ele. Um portal pode incluir agentes selecionados, seus próprios visualizadores, um logotipo e
uma cor de destaque, além de um domínio personalizado opcional.

Administradores da organização gerenciam portais em **Portais de clientes**
(`/dashboard/client-portals`). Os visualizadores usam a URL do portal hospedado e nunca obtêm
acesso ao dashboard do ThunderPhone.

## Criar um portal

<Steps>
  <Step title="Escolha Novo portal">
    Insira o nome voltado ao cliente. O ThunderPhone cria um slug de URL exclusivo a partir
    dele; você pode editar o slug mais tarde.
  </Step>

  <Step title="Atribua agentes">
    Adicione os agentes cujas chamadas o cliente deve ver. Um portal sem agentes atribuídos
    não tem chamadas visíveis.
  </Step>

  <Step title="Adicione visualizadores">
    Adicione o endereço de e-mail de cada visualizador aprovado. Os visualizadores solicitam seu próprio código
    de login na página de entrada do portal.
  </Step>

  <Step title="Compartilhe a URL">
    Copie a URL do portal ou escolha **Abrir** para testá-lo. A página de lista também mostra
    o status ativo, a contagem de agentes e a contagem de visualizadores de cada portal.
  </Step>
</Steps>

## Detalhes e disponibilidade do portal

O cartão **Detalhes do portal** controla:

* **Nome** — exibido no login e no cabeçalho do portal; máximo de 255 caracteres.
* **Slug** — o segmento da URL hospedada; máximo de 100 caracteres. Use letras
  minúsculas, números e hífens simples. Os slugs devem ser exclusivos e não podem usar uma
  rota reservada da plataforma.
* **Agentes** — o conjunto exato de históricos de chamadas dos agentes visíveis no portal.
* **Portal ativo** — desative esta opção para impedir que todos os visualizadores o abram
  sem excluir a configuração.

Apenas chamadas pertencentes a um agente atribuído estão no escopo. Os visualizadores não podem editar
agentes, realizar chamadas, gerenciar faturamento nem ver outros dados da organização.

## Marca

Envie um logotipo **PNG**, **JPEG** ou **WebP** de até **2 MB**. Escolha uma cor de destaque hexadecimal
completa de seis dígitos, como `#2e8fff`; ela controla os botões principais e os destaques. Redefina qualquer
um dos valores para retornar à marca padrão.

A marca aparece tanto na página de login quanto no cabeçalho autenticado do portal.

## Acesso de visualizadores

Adicione visualizadores por e-mail. Na página de login do portal, um visualizador ativo pode:

* Solicitar um código de seis dígitos por e-mail. Um código é válido por 10 minutos.
* Entrar com uma senha, caso tenha criado uma.
* Criar uma senha de pelo menos 8 caracteres após entrar.

Você pode desativar um visualizador sem remover sua linha ou excluí-lo para
remover o acesso. As sessões do portal são separadas das sessões do dashboard.

## O que os visualizadores podem ver

A tabela de histórico de chamadas do portal mostra as chamadas no escopo dos agentes atribuídos.
Os visualizadores podem abrir uma chamada para inspecionar:

* Data, direção, parte de origem/destino, status e duração.
* Agente atribuído e resultado bem-sucedido ou malsucedido quando avaliado.
* Transcrição.
* Reprodução da gravação quando houver uma gravação disponível.

A interface é somente leitura. Ela não expõe prompts dos agentes, configurações da organização,
chaves, faturamento, ferramentas ou fluxos internos para problemas.

## Conectar um domínio personalizado

<Steps>
  <Step title="Adicione o nome de host">
    Em **Domínios personalizados**, insira um nome de host completo, como
    `calls.client.com`. Um nome de host pode pertencer a apenas um portal.
  </Step>

  <Step title="Direcione o tráfego para o portal">
    Adicione o registro **CNAME** exibido no provedor de DNS.
  </Step>

  <Step title="Comprove a propriedade do domínio">
    Adicione o registro **TXT** exibido em
    `_tp-portal-verify.<hostname>` com o valor de verificação gerado.
  </Step>

  <Step title="Verificar">
    Escolha **Verificar agora**. A propagação do DNS pode levar algum tempo; a tela de configuração pode
    verificar novamente a cada 20 segundos. Depois que a verificação for concluída, o registro TXT
    poderá ser removido, mas o CNAME deverá permanecer.
  </Step>
</Steps>

Remova um domínio do portal antes de reutilizar esse nome de host em outro lugar.

## Excluir um portal

Excluir um portal remove permanentemente o acesso de visualização e a configuração de domínio personalizado. Isso não exclui os agentes nem as chamadas da organização, mas o portal não pode ser recuperado. Use o interruptor **Portal ativo** para uma pausa reversível.

Para automação administrativa, consulte a
[API de Portais de clientes](/api-reference/client-portals).