Chamadas de voz no Chatwoot

Fale com seus clientes por voz, diretamente da mesma caixa de entrada onde você já gerencia os chats. Este guia está dividido em três partes:

1. O que é a chamada de voz e como ela ajuda: visão geral do recurso de chamadas de voz

2. Conectando um canal de voz: configuração para cada provedor (Twilio e WhatsApp)

3. Usando chamadas de voz no dia a dia: atendimento, atribuições, quem recebe a ligação e o que acontece após a chamada

---

1. O que é a chamada de voz e como ela ajuda

A chamada de voz permite que seus agentes façam e recebam ligações telefônicas dentro do Chatwoot, sem precisar alternar para um aplicativo de telefone separado. Uma chamada fica no mesmo lugar que o restante da conversa, então o histórico de chat, detalhes do contato, anotações e a chamada ficam juntos em uma única linha do tempo.

1.1. Por que as equipes usam

• Uma tela para tudo. Quando um cliente liga, o agente já vê quem ele é e sobre o que já conversaram antes, sem precisar pedir para repetir informações.

• Sem telefones para gerenciar. Os agentes falam pelo navegador usando um headset ou o microfone e alto-falantes do computador. Não há necessidade de instalar softwares ou extensões de navegador adicionais.

• Cada chamada fica registrada. Cada ligação se torna automaticamente uma mensagem na conversa, mostrando se foi atendida, quanto tempo durou, quem atendeu, e, quando disponível, uma gravação que pode ser reproduzida e uma transcrição escrita para você ler.

• A equipe compartilha o atendimento. Uma chamada recebida toca para os agentes disponíveis corretos ao mesmo tempo, para que os clientes falem com uma pessoa real rapidamente.

1.2. Diferentes formas de receber uma chamada

O Chatwoot suporta voz através de dois provedores. Você pode usar um ou ambos:

Nota: Chamadas de voz são um recurso premium. Ele precisa estar habilitado na sua conta (o recurso Voice Channel) para que as opções abaixo apareçam. Se você não vê as configurações de voz, entre em contato com o administrador da conta ou com o seu provedor Chatwoot.

---

2. Conectando um canal de voz

A configuração do canal de voz é uma tarefa de administrador, feita uma vez por caixa de entrada. Escolha a seção que corresponde ao provedor desejado.

2.1. Twilio Voice (linha com número de telefone)

Siga este artigo para configurar o Twilio Voice: Connecting Twilio voice channel

2.2. WhatsApp Calling

Siga este artigo para configurar o WhatsApp Calling: Connecting WhatsApp voice channel

Um requisito para os agentes: o navegador deles deve ter permissão de microfone concedida para o Chatwoot.

---

3. Usando chamadas de voz no dia a dia

Uma vez que uma caixa de entrada tem voz habilitada, as chamadas funcionam da mesma forma para os agentes, independentemente do provedor.

3.1. Recebendo uma chamada

Quando um cliente liga, um widget de chamada flutuante aparece no canto da tela para os agentes que devem atender, e um toque soa. O cartão mostra o nome do chamador, número e (quando conhecido) sua localização, além de qual canal originou a chamada.

A partir desse widget, um agente pode:

• Entrar na chamada: atender e começar a falar clicando no botão verde de aceitar chamada.

• Rejeitar: recusar a chamada (o cliente para de chamar esse agente) clicando no botão vermelho de rejeitar chamada.

• Descartar: ocultar silenciosamente o popup nesta tela sem recusar a chamada, permitindo que outros agentes ainda possam atender. Você pode fazer isso clicando no “x” no canto superior direito do widget.

Se um colega (ou o mesmo agente em outra aba do navegador) já atendeu a chamada, o widget exibirá "Sendo atendida em outra aba" para que duas pessoas não atendam a mesma chamada.

Enquanto estiver conectado, o widget mostra um cronômetro em tempo real e estes controles:

• Silenciar/ativar microfone: ligar/desligar o microfone do agente clicando no botão verde de microfone.

• Encerrar chamada: desligar clicando no botão vermelho de encerrar chamada.

• Ir para o histórico da conversa / Ver chat: acessar a conversa completa sem sair da chamada, clicando em "Ir para o histórico da conversa" no rodapé do widget. Isso facilita para o agente ver o histórico prévio da conversa ou obter mais detalhes do contato.

3.2. Notificação e atribuição de chamadas

O Chatwoot faz chamadas para as pessoas com maior probabilidade de ajudar, e não chama todos indiscriminadamente. Para uma chamada recebida, a ordem de prioridade é:

1. O agente atribuído, se a conversa já tiver um. Só este irá tocar.

2. Caso contrário, os agentes online na caixa de entrada, todos os disponíveis recebem notificação da chamada ao mesmo tempo.

3. Caso contrário, todos os administradores online da conta, como último recurso para que nenhuma chamada fique sem resposta.

Algumas regras decorrentes disso:

• Apenas agentes disponíveis (online) recebem o popup de chamada para chamadas recebidas. Agentes offline ou ocupados são ignorados.

• O primeiro que atende ganha. Não há fila ou rodízio; quem atender primeiro fica com a chamada, para os outros ela para de tocar e a notificação some.

• A chamada é automaticamente atribuída para quem atender. A conversa passa a ser do agente que atendeu, para o acompanhamento posterior.

• Chamadas realizadas (saída) sempre pertencem ao agente que as iniciou.

3.3. Estados da chamada (explicação dos rótulos)

Toda chamada passa por um ciclo simples, e a conversa reflete isso:

3.4. Após a chamada

Quando uma chamada termina, ela é registrada como uma entrada de chamada na linha do tempo da conversa, então fica um registro permanente. Dependendo da sua configuração, essa entrada pode incluir:

• Resumo da chamada: Direção (entrada/saída), status final, duração e qual agente atendeu (ex: "Você atendeu", "{agente} atendeu" ou "Eles atenderam").

• Gravação: Para chamadas Twilio uma gravação é feita automaticamente e anexada para reprodução. Para chamadas WhatsApp uma gravação é anexada quando disponível.

• Transcrição: Se sua conta tem transcrição por IA habilitada (integração Captain, conforme disponibilidade de quota), a gravação é convertida em texto dentro da entrada da chamada, com um botão Mostrar mais / Mostrar menos para chamadas longas.

  
  

Uma chamada perdida ou recusada ainda gera uma entrada (ex: Chamada perdida - Nenhum agente atendeu), e o agente pode usar Ligar de volta da conversa para retornar.

3.5 Iniciando uma chamada de saída

Quando um agente perde uma chamada, o Chatwoot permite retornar facilmente a ligação ao cliente pelo painel. Dentro de uma conversa, o agente pode usar o botão de chamada no cabeçalho da conversa:

Você também pode iniciar uma chamada pela tela de informações do contato.

---

Solução rápida de problemas

• Nenhuma configuração de voz aparece. O recurso Voice Channel não está habilitado na sua conta — peça ao seu administrador ou provedor Chatwoot.

• Chamada WhatsApp não ativa. O número ainda não está ativo na API WhatsApp Business Calling, ou a caixa não é uma caixa WhatsApp Cloud. Registre o número com a Meta / seu provedor e tente novamente.

• A ligação conecta mas não há áudio, ou não inicia. Verifique se o navegador concedeu permissão de microfone ao Chatwoot, e se um headset/microfone está selecionado.

• O cliente diz que não consegue ligar para seu número WhatsApp. Talvez ele não tenha aceitado ainda a solicitação de permissão de chamada — ele receberá uma ao tentar chamar um agente, e as ligações funcionarão ao aceitar.