Três coisas, em duas telas. A terceira é a que todo mundo pula, e pulá-la produz uma linha telefônica que atende de forma convincente sem fazer nenhum do seu trabalho.
Um número
/phone-numbers → Comprar um número. Você escolhe um país e depois seleciona entre os Números disponíveis. É o caminho rápido e fica pronto em um minuto, mais ou menos.
A alternativa é Traga seu próprio número Twilio, ou uma conexão completa com uma operadora se você já tiver uma. Esse fluxo tem quatro passos — Operadora, Conexão, Números, Verificação — e pede dados SIP que você recebe da sua operadora: Host SIP, Porta SIP, Transporte, Usuário SIP, Senha SIP, ID do chamador, e um Formato de discagem com prefixo e sufixo opcionais.
Duas coisas sobre o caminho da operadora que valem saber antes de começar:
- Ele exige um proprietário ou administrador. “Adicionar uma operadora exige ser proprietário ou administrador. Nada foi criado.”
- Uma falha não deixa bagunça. Se a configuração falhar no meio do caminho, você recebe “A configuração não foi concluída — nada ficou pela metade.” Seus dados continuam preenchidos, então tentar de novo não significa digitar tudo outra vez.
O formato de discagem importa mais do que parece. Algumas operadoras querem formato nacional, e mandar E.164 para uma que espera formato nacional é uma configuração que valida tranquilamente e depois falha na hora de discar.
Um agente
/agents → crie um. No mínimo ele precisa de um nome e um prompt de sistema — “Nome do agente e prompt de sistema são obrigatórios.” — e de uma saudação, A primeira coisa que seu agente diz.
Todo o resto do agente (voz, pipeline, conhecimento) pode esperar. O que não pode esperar é que esse agente exista antes de você vincular o número, porque o vínculo é o próximo passo.
O vínculo entre os dois
Este é o passo que todo mundo pula.
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 mostrar Implantado em … em vez de Não implantado ou Nenhum canal de voz.
Se qualquer um dos dois disser outra coisa, você tem um número e um agente e nenhuma conexão entre eles.
Por que um número sem vínculo também atende
Aqui está a armadilha. Um número conectado atende antes de você ter vinculado qualquer coisa. Um agente de teste atende, soa plausível e não sabe nada do seu negócio.
Então «liguei e alguém atendeu» não é evidência de que a configuração funcionou. É evidência de que o número está conectado, o que era a metade fácil. A verificação que significa algo é a saudação: se você ouvir A primeira coisa que seu agente diz, chegou lá. Se ouvir qualquer outra coisa, falta o vínculo.
Isso custa às pessoas mais tempo do que todos os outros itens desta página somados, porque o sintoma do problema é uma ligação telefônica que funciona.
Um telefone para testar
Não o navegador. /agents oferece o Iniciar teste de microfone — “Teste de microfone via WebRTC. Não é preciso telefone — fale com o agente direto desta página.” — e ele é genuinamente útil para conferir o que o agente diz.
Ele não testa o caminho telefônico. A tela diz isso por si só: “O WebRTC funciona para testes no navegador. As rotas de telefone precisam de um número.” O teste de microfone passando diz que o agente funciona; não diz nada sobre se as ligações chegam até ele.
Use Chame este número para testar e ligue para ele de um telefone de verdade.
Um fuso horário
Configure o fuso horário do espaço de trabalho antes que qualquer coisa comece a se agendar sozinha. É o padrão que toda função futura vai ler, e corrigi-lo depois não conserta retroativamente nada que já tenha rodado no fuso errado.