Pular para o conteúdo
Atalho: /, ⌘K ou Ctrl+K

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.

Ver em Markdown

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; 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.

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.

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.
  • 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, 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.

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.

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.

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.

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 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 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.

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 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.

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.

As alterações ficam registradas no log de auditoria 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. 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.