Em ordem de frequência, não de gravidade. Cada verificação abaixo nomeia a tela para olhar, porque «não funciona» é quase sempre uma de quatro telas se contradizendo.
1. O número atende, mas não é o seu agente
O relato mais comum e o mais difícil de notar, porque a ligação funciona. Um número conectado atende antes que qualquer coisa esteja vinculada a ele — um agente de teste atende e soa bem.
A verificação: ligue para o número e espere A primeira coisa que seu agente diz. Ouvir qualquer outra coisa significa que o número não está vinculado ao seu agente.
O conserto: em /phone-numbers, o número deve dizer «… atende este canal» com o nome do seu agente. Em /agents, a seção Implantação deve dizer Implantado em … em vez de Não implantado ou Nenhum canal de voz. Conserte o que estiver errado.
2. O teste de microfone funciona e o telefone não
Eles testam coisas diferentes, e passar o primeiro não prova nada sobre o segundo. /agents diz isso abertamente: “O WebRTC funciona para testes no navegador. As rotas de telefone precisam de um número.”
Iniciar teste de microfone exercita o agente. Ele não exercita o número, o vínculo nem a operadora. Se o teste de microfone está bem e as ligações não, o problema está no caminho telefônico, então volte à verificação 1.
3. O agente atende mas não sabe nada
Não é uma falha. Um agente sem conhecimento anexado atende corretamente e sem servir para nada.
A verificação: /agents/knowledge. Se estiver vazio, essa é a sua resposta — “Crie um agente primeiro e depois adicione conhecimento para embasá-lo.”
Adicione horários, preços, serviços e localização, e rode de novo o teste de microfone. É o conserto de maior retorno da lista, e não é um relato de bug.
4. A ligação conecta e depois falha
Olhe /conversations e encontre a ligação. O resultado diz qual metade quebrou:
| O que você vê | O que significa |
|---|---|
| Perdida / Sem resposta | Nunca chegou ao agente |
| Conectada | Chegou ao agente e rodou |
| Interrompida | ”Conectada, mas quem ligou desligou antes de o agente terminar.” |
| Com falha | A ligação em si falhou |
A Linha do tempo da chamada mostra as fases — Conectando, Chamando, AO VIVO, Finalizando — para você ver até onde chegou antes de parar.
Uma sequência de Com falha logo depois de uma troca de operadora normalmente significa que a operadora recusou a ligação: “A operadora não aceitou a chamada — tente novamente em instantes.” Confira o Formato de discagem do número — uma operadora que espera formato nacional recusa E.164, e a configuração salvou sem reclamar.
5. Funciona, mas nada é registrado
As ligações acontecem e, depois, não há nada estruturado para olhar.
A verificação: /dialog-insights. Um insight mostrando Não vinculado nunca roda — “Um insight de conversa só é executado em conversas de um agente ou campanha a que ele esteja vinculado.” Salvar e vincular são ações diferentes.
Confira também o campo em si: “Um insight de conversa sem campos nunca produz um resultado.”
6. A voz mudou sozinha
Não mudou sozinha, mas uma troca de pipeline faz isso. Pipelines em tempo real trazem as próprias vozes e o padrão usa as do seu provedor de texto em fala, então trocar o Pipeline te deixa, em silêncio, escolhendo de uma lista que não contém a que você tinha. Veja pipelines de voz.
7. Parou de funcionar depois que você pausou algo
Pausar ou arquivar um agente o faz parar de atender e parar de ligar. Se uma campanha usando esse agente está rodando, ela se esvazia com cada ligação restante pulada e rotulada, em vez de discar em nome de um agente que você acredita estar desligado.
Se não for nenhuma destas
Ligue para o número de um telefone que nunca o chamou e observe /conversations enquanto faz isso. Se nenhuma conversa aparecer, nada chegou até nós e o problema está antes da Octo — o número, o roteamento dele ou a operadora.