# 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](https://docs.polymorfa.com/pt-br/calls); o Console revisa e gerencia
chamadas, mas não as faz nem as atende.

Chamadas têm cinco abas: **Histórico**, **Resumo**, **Política de chamadas**,
**Troncos SIP** e **Retenção de dados**. A aba **Troncos SIP** aparece quando um
projeto está aberto, para proprietários e administradores da equipe e para os
demais membros quando o projeto tem troncos.

## Resumo das chamadas

A aba **Resumo** 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, e os três horários mais
movimentados aparecem abaixo dele.

Escolha um **Número**, uma **Direção** e um intervalo de tempo acima do resumo.
Ele abre nos últimos 7 dias. O intervalo cobre 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](https://docs.polymorfa.com/pt-br/calls#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](https://docs.polymorfa.com/pt-br/numbers/analytics#chamadas).

## Encontre uma chamada

A aba **Histórico** lista as chamadas, das mais recentes para as mais antigas.
Cada linha mostra a parte, o estado, se a chamada está ao vivo, o número, a
direção, a conexão, a duração e o horário de início. Para abrir uma chamada,
digite o ID dela em **Encontrar uma chamada pelo ID** e selecione **Abrir**. A outra parte aparece como uma referência exclusiva da
equipe; a Polymorfa não armazena quem está do outro lado de uma chamada.

Selecione **Filtros** para filtrar 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**: Ao vivo ou Encerrada.
- **Número**.

Cada filtro ativo aparece como um chip acima da lista, com um botão para
removê-lo. Ao lado de **Filtros**, escolha um dia em **De**, um dia em **Até** ou
os dois; o último dia está incluído.

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. A faixa no topo mostra o
estado da chamada, se ela está ao vivo, a parte, a direção, a mídia, a
duração, o horário de início, a conexão e o **ID da chamada** e o **ID do
número** com botões de copiar. Use esses IDs para encontrar a chamada nos
handlers de webhook e nos logs. No celular, selecione **Detalhes** para mostrar
a conexão e os IDs.

As abas abaixo da faixa são:

- **Visão geral**: quem atendeu, se esse participante fez o claim da chamada
  (**Reservada**), o motivo do encerramento, os horários de conexão e
  encerramento, os eventos registrados da chamada e os participantes do
  WhatsApp de uma chamada em grupo com 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**: em **Medido pela Polymorfa**, 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. Em **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).
- **Webhooks**: 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.

## Diagnósticos informados pelo aplicativo

Quando o seu aplicativo envia
[diagnósticos de chamadas](https://docs.polymorfa.com/pt-br/calls#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 com
**Encerrar chamada**, na faixa no topo dos detalhes da chamada, ou remover uma
conexão com **Remover**, na aba **Conexões**. 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](https://docs.polymorfa.com/pt-br/development/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**, selecione **Configurações** e depois **Chamadas**. 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](https://docs.polymorfa.com/pt-br/development/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](https://docs.polymorfa.com/pt-br/calls#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](https://docs.polymorfa.com/pt-br/calls#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](https://docs.polymorfa.com/pt-br/calls#conference-mode)
para ver exemplos.

**Chamadas simultâneas** permite que um número em dispositivo vinculado mantenha
qualquer quantidade de chamadas ao mesmo tempo. Fica desativado por padrão e,
nesse caso, uma nova chamada espera a chamada atual terminar. Ativar abre uma
confirmação:

- O número vai manter qualquer quantidade de chamadas ao mesmo tempo.
- Os próprios apps do WhatsApp nunca mantêm duas chamadas ao mesmo tempo, então
  esse é um comportamento incomum para a conta.
- O [Crédito de banimento](https://docs.polymorfa.com/safety/ban-insurance#who-it-covers) não cobre um
  banimento enquanto a configuração estiver ativada, nem por 30 dias depois de
  desativá-la.

Selecione **Entendo que o Crédito de banimento não vai cobrir este número** e depois
**Ativar chamadas simultâneas**. O botão fica indisponível até você marcar a
caixa, e **Cancelar** mantém a configuração desativada. Enquanto a configuração
estiver ativada, a seção repete a exclusão do Crédito de banimento abaixo do
controle. Depois que você a desativa, a seção mostra a data e a hora antes das
quais um novo banimento ainda não é coberto, até que esse momento passe. Fora
isso, mostra que o Crédito de banimento não cobre um banimento se a configuração esteve
ativada em algum momento dos 30 dias anteriores a ele. Desativar não pede
confirmação e não encerra chamadas em andamento.

Números da Cloud API ignoram esta configuração, então o controle fica oculto
neles, a menos que já esteja ativado. Se uma alteração for recusada ou não for
aplicada, o motivo aparece abaixo do controle. Consulte
[Chamadas simultâneas](https://docs.polymorfa.com/pt-br/calls#simultaneous-calls).

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](https://docs.polymorfa.com/pt-br/calls/sip-trunks) para saber como as chamadas
roteadas se comportam.

## Troncos SIP

Abra um projeto, acesse **Chamadas** e escolha a aba **Troncos SIP**.
Proprietários e administradores da equipe sempre veem essa aba; os outros
membros a 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: selecione um tronco para abrir as
configurações dele. Os demais membros as veem somente para leitura.

Ao lado da lista de troncos, a aba **Endereço SIP** 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, a aba informa isso e não mostra host nem portas. Consulte
[Encontre o endereço SIP](https://docs.polymorfa.com/pt-br/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. Ao fechar o formulário ou sair da página com
  alterações não salvas, o Console pergunta antes de descartá-las. Os campos
  ficam bloqueados enquanto o salvamento está em andamento.
- **Ativar ou desativar** um tronco pelo menu dele na lista. 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](https://docs.polymorfa.com/pt-br/development/logs) e
chegam ao roteamento de chamadas em cerca de um minuto.

## Retenção de dados de chamadas

A aba **Retenção de dados** de 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](https://docs.polymorfa.com/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](https://docs.polymorfa.com/pt-br/calls#call-data-retention).
