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

# Chamadas

> Revise as chamadas dos seus números, inspecione uma chamada, encerre chamadas ao vivo, gerencie troncos SIP, altere as configurações de chamadas e escolha por quanto tempo os dados de chamadas ficam guardados no Console.

Abra um projeto e acesse **Chamadas** para ver as chamadas de voz e vídeo feitas
ou recebidas nos números do projeto. Escolha **Todos os projetos** para ver as
chamadas de todos os projetos. Para fazer e atender chamadas no seu produto, use
os [SDKs de chamadas](/pt-br/guides/calls/overview); o Console revisa e gerencia
chamadas, mas não as faz nem as atende.

## Resumo das chamadas

Acima da lista, o resumo das chamadas mostra o número de chamadas, as chamadas
atendidas, perdidas, recusadas e com falha, a taxa de atendimento, o tempo total
em conversa e a duração média das chamadas. Dois gráficos mostram as chamadas
por resultado e o tempo em conversa de cada dia, ou de cada hora quando o
intervalo de datas cobre dois dias ou menos. Um mapa de calor mostra quais dias
da semana e horas do dia recebem mais chamadas.

O resumo segue os filtros **Número**, **Direção**, **De** e **Até**. Sem datas,
ele cobre os últimos 7 dias, e o intervalo pode cobrir no máximo 366 dias. Dias
e horas usam o fuso horário do seu navegador. Para ler os mesmos números pelo
seu código, use a
[API de estatísticas de chamadas](/pt-br/guides/calls/overview#call-analytics-and-call-records).

Para ver o tempo até o atendimento, durações medianas e de percentil 95, o
retorno de chamadas perdidas, a qualidade informada e comparações entre
números, ative a [análise do WhatsApp](/pt-br/console/analytics#chamadas).

## Encontre uma chamada

A lista mostra a parte, o número, o estado, a conexão, a duração e o horário de
início de cada chamada. A outra parte aparece como uma referência exclusiva da
equipe; a Polymorfa não armazena quem está do outro lado de uma chamada.

Filtre por:

* **Estado**: Tocando, Atendida, Recusada, Perdida ou Encerrada. Uma chamada
  recebida que um participante recusou continua como **Recusada**, e uma que
  tocou sem ser atendida continua como **Perdida**, depois que a chamada
  termina. **Encerrada** abrange todas as outras chamadas finalizadas,
  inclusive chamadas realizadas que o destinatário não atendeu; o motivo do
  encerramento informa a causa.
* **Direção**: Recebida ou Realizada.
* **Atividade**: chamadas ao vivo, chamadas encerradas ou ambas.
* **Número**.
* Datas **De** e **Até**. A data final está incluída.

Enquanto uma chamada ao vivo estiver na tela, a lista é atualizada a cada 10
segundos.

## Detalhes da chamada

Selecione uma chamada para abrir os detalhes dela:

* **Resumo**: direção, estado, conexão, mídia, duração, motivo do
  encerramento, quem atendeu e se esse participante fez o claim da chamada
  (**Reservada**).
* **Ciclo de vida**: horários de início, conexão e encerramento, e os eventos
  registrados da chamada.
* **Participantes**: os participantes do WhatsApp de uma chamada em grupo e o
  estado de cada um.
* **Conexões**: cada navegador, aplicativo, servidor ou sistema telefônico que
  entrou na chamada, quando entrou e saiu e por que saiu. Uma conexão é fechada
  quando o participante sai, se reconecta com uma nova conexão ou outro
  participante faz o claim da chamada, ou quando a chamada termina.
* **Qualidade da chamada**: tempo de configuração e de toque, codec de áudio,
  jitter, pacotes perdidos, tempo de ida e volta e taxas de bits medidos pelo
  serviço de mídia da Polymorfa. **Não informado** significa que o valor não
  foi medido.
* **Informado pelo seu aplicativo**: as medições de qualidade e os erros que o
  seu aplicativo enviou para cada uma das conexões dele. Consulte
  [Diagnósticos informados pelo aplicativo](#app-reported-diagnostics).
* **Entregas de webhook**: o status da entrega, as tentativas e o último
  resultado de cada evento de webhook da chamada. Os registros de entrega são
  mantidos por 30 dias após cada evento.
* **IDs de correlação**: o ID da chamada e o ID do número para procurar nos
  handlers de webhook e nos logs.

## Diagnósticos informados pelo aplicativo

Quando o seu aplicativo envia
[diagnósticos de chamadas](/pt-br/guides/calls/overview#report-call-diagnostics-from-your-app),
os detalhes da chamada mostram uma entrada por conexão que enviou relatórios:

* **Enviado por**: o nome do SDK, a versão e a plataforma indicados no
  relatório.
* **Último relatório de qualidade**: quando chegou o relatório de qualidade
  mais recente, com o tempo de ida e volta, o jitter, os pacotes perdidos e
  recebidos, os codecs de áudio e vídeo, o caminho da conexão e o número de
  reconexões. **Não informado** significa que o seu aplicativo não enviou esse
  valor.
* **Caminho da conexão**: **Direto na rede local**, **Direto** ou **Por um
  servidor de retransmissão**. A mídia retransmitida faz um caminho mais longo
  e muitas vezes explica um tempo de ida e volta maior.
* **Erros informados**: cada erro com o horário e uma descrição, do mais novo
  para o mais antigo. O Console mostra até 50 erros por chamada.

**O seu aplicativo não enviou relatórios para esta chamada.** significa que
nenhum relatório chegou para a chamada. A Polymorfa mantém até 200 relatórios
por chamada; quando uma chamada atinge esse limite, o Console avisa. Se o
Console não conseguir carregar os relatórios do seu aplicativo, ele informa que
eles não estão disponíveis em vez de dizer que nenhum chegou.

## Encerre uma chamada ou remova uma conexão

Proprietários e administradores da equipe podem encerrar uma chamada ao vivo ou
remover uma conexão dela na página de detalhes da chamada. Encerrar uma chamada
a encerra para todos os participantes e para a outra parte. Remover uma conexão
desconecta esse navegador, aplicativo ou servidor; a chamada continua para os
demais. As duas ações têm efeito imediato e ficam registradas no
[log de auditoria](/pt-br/console/audit-logs).

O Console recusa a ação quando a chamada não está mais ao vivo e avisa quando o
serviço de chamadas está temporariamente indisponível.

## Configurações de chamadas

Abra um número em **Números** e encontre **Chamadas** nos detalhes dele. Todos
os membros da equipe podem ver essas configurações; proprietários e
administradores da equipe podem alterá-las, e cada alteração fica registrada no
[log de auditoria](/pt-br/console/audit-logs).

**Chamadas neste número** ativa ou desativa as chamadas. Enquanto está
desativado, fazer e atender chamadas no número é recusado, as chamadas
recebidas são recusadas e os troncos SIP não podem ligar pelo número. As
chamadas em andamento continuam. Consulte
[Desativar chamadas em um número](/pt-br/guides/calls/overview#turn-calling-off-for-a-number).

Em um número da Cloud API, **Atender chamadas com o Polymorfa Calls** escolhe
quem atende as chamadas recebidas: os seus apps de chamadas quando está
ativado, ou a sua integração com a Graph API quando está desativado (o
padrão). Consulte [Números da Cloud API](/pt-br/guides/calls/overview#cloud-api-numbers).

**Modo conferência** controla se os participantes que você conecta a uma
chamada ouvem uns aos outros:

* **Ativado** (padrão): cada participante ouve as pessoas no WhatsApp e todos
  os outros participantes que você conectou.
* **Desativado**: cada participante ouve apenas as pessoas no WhatsApp.

Nos dois modos, as pessoas no WhatsApp ouvem todos os seus participantes, e
ninguém ouve a própria voz. Uma alteração vale para uma chamada na próxima vez
que um participante a atender ou se conectar a ela, inclusive em chamadas em
andamento. Consulte [Modo conferência](/pt-br/guides/calls/overview#conference-mode)
para ver exemplos.

Quando o projeto tem um tronco SIP ativado que envia chamadas para o seu
sistema telefônico, a seção também mostra **Chamadas recebidas**:

* **As chamadas recebidas tocam em**: **Seus aplicativos e navegadores** ou
  **Um tronco SIP e seus aplicativos**. Com um tronco, o seu sistema telefônico
  toca junto com os seus aplicativos, e os seus aplicativos ainda podem atender
  ou entrar.
* **Tronco SIP**: o tronco que recebe as chamadas. Troncos desativados aparecem
  na lista, mas não podem ser escolhidos. Um número que já envia chamadas para
  um tronco que você desativou depois mantém esse tronco selecionado.
* **O atendimento pelo sistema telefônico reserva a chamada**: quando ativado,
  o atendimento pelo sistema telefônico faz o claim da chamada e os seus
  aplicativos param de tocar. Vem ativado por padrão.

Escolha **Salvar** para aplicar uma alteração de roteamento. Os botões de ativar e desativar valem
assim que você os altera. Se outra pessoa alterou as configurações de chamadas
do número depois que a página carregou, o Console recusa a sua alteração,
mostra os valores mais recentes e pede que você tente novamente. As alterações
chegam às novas chamadas em cerca de um minuto. Consulte
[Troncos SIP](/pt-br/guides/calls/sip-trunks) para saber como as chamadas
roteadas se comportam.

## Troncos SIP

Abra um projeto, acesse **Chamadas** e escolha **Gerenciar troncos SIP**.
Proprietários e administradores da equipe sempre veem esse link; os outros
membros o veem quando o projeto tem troncos. A lista mostra o nome, a direção e
o status de cada tronco, a URI SIP para a qual ele envia chamadas e o usuário e
o número que ele usa para as chamadas do seu sistema telefônico. Todos os
membros da equipe podem ver os troncos.

O cartão **Endereço SIP da Polymorfa**, acima da lista, mostra o host, a porta
SIP de cada transporte, o intervalo de portas de áudio (RTP) e o que liberar no
seu firewall. O mesmo endereço vale para todos os troncos. Quando o ambiente não
tem endereço SIP, o cartão informa isso e não mostra host nem portas. Consulte
[Encontre o endereço SIP](/pt-br/guides/calls/sip-trunks#find-the-sip-address).

Proprietários e administradores da equipe podem:

* **Adicionar** um tronco. Escolha a direção: **Para o seu sistema
  telefônico**, **Do seu sistema telefônico** ou **Nos dois sentidos**, e
  preencha a seção correspondente.
* **Editar** um tronco. Deixe **Senha** em branco para manter a senha salva. Se
  outra pessoa alterou o tronco antes, o Console recusa a alteração; abra o
  tronco novamente e tente de novo.
* **Ativar ou desativar** um tronco com o botão de ativação dele. Um tronco desativado não
  recebe novas chamadas; as chamadas em andamento continuam.
* Criar uma **Nova senha** para um tronco que recebe chamadas do seu sistema
  telefônico. A senha anterior deixa de funcionar em cerca de um minuto.
* **Excluir** um tronco. Um tronco para o qual um número ainda envia chamadas
  não pode ser excluído; antes, faça esse número voltar a enviar as chamadas
  para os seus aplicativos.

> [!WARNING]
>
> Quando você adiciona um tronco que recebe chamadas do seu sistema telefônico,
> ou cria uma nova senha, o Console mostra o usuário, a senha e o realm uma
> única vez, junto com o servidor SIP e as portas. Informe esses dados no seu
> sistema telefônico antes de fechar a caixa de diálogo; a senha não pode ser
> exibida de novo.

As alterações ficam registradas no [log de auditoria](/pt-br/console/audit-logs) e
chegam ao roteamento de chamadas em cerca de um minuto.

## Retenção de dados de chamadas

O cartão **Retenção de dados de chamadas**, no fim da página Chamadas, mostra
por quanto tempo a Polymorfa mantém os dados de chamadas da sua equipe: o
histórico de chamadas, o histórico de participantes e conexões de cada chamada
e os diagnósticos que os seus aplicativos informam. A configuração vale para
todos os projetos da equipe. Equipes que nunca a alteraram mantêm os dados de
chamadas por 90 dias.

Todos os membros da equipe podem ver o período. Proprietários e administradores
da equipe podem alterá-lo:

1. Escolha um **Período de retenção**: Curta (7 dias), Padrão (30 dias),
   Estendida (90 dias), Conformidade (365 dias) ou Personalizada.
2. Em **Personalizada**, informe um número inteiro de dias de 1 a 2.555.
3. Selecione **Salvar retenção**.

A exclusão de dados de chamadas mais antigos que o período começa em uma data
anunciada no [changelog](/changelog). Até lá, salvar um período registra a sua
escolha e não exclui nada. Depois que a exclusão estiver em funcionamento, os
dados de chamadas são excluídos em até 24 horas depois que ficam mais antigos
que o período (um acúmulo grande pode levar mais tempo), e um período mais
curto também vale para os dados de chamadas já armazenados. Se você escolher um
período mais curto, o Console pede uma confirmação antes, porque os dados de
chamadas excluídos não podem ser recuperados. Um período mais longo não
restaura dados excluídos. Se outra pessoa alterou a configuração depois que você
abriu a página, o Console recusa a alteração e mostra o valor atual; revise-o e
salve de novo.

Você também pode ler e alterar o período com a
[Platform API](/pt-br/guides/calls/overview#call-data-retention).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.