Conectar sua conta Twilio para ligações por telefone
Ligue para os seus contatos por telefone comum usando a sua própria conta Twilio: os números e a fatura são seus, e o AtendeBot só opera a discagem.
🧩 Este recurso faz parte do módulo Voz. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja Planos e módulos.
🧪 As ligações por telefone estão em beta. Já funcionam, mas esta é a parte mais nova do módulo: detalhes da tela e do comportamento podem mudar nas próximas versões. Ligar pelo WhatsApp não faz parte do beta.
Objetivo
Conectar uma conta Twilio ao AtendeBot para fazer ligações telefônicas a partir das conversas.
Pré-requisitos
- Módulo Voz ativo
- Perfil de administrador
- Conta Twilio paga (o modo trial recusa a discagem)
- Permissão geográfica para o Brasil na Twilio (Voice → Settings → Geo permissions → Brazil, low risk)
Tempo estimado
15 minutos, sem contar a compra de número.
Caminho de acesso
Ajustes → Voz → seção Telefone (Twilio)
Passo a passo
- Na Twilio, crie uma API Key do tipo Standard (Console → Account → API keys & tokens → Create API key → Standard). Guarde o SID (começa com
SK) e o Secret: a Twilio mostra o Secret uma única vez.
⚠️ Não use chave Restricted nem o Auth Token da conta. A chave Restricted não tem as permissões necessárias, e o Auth Token o AtendeBot não pede e não aceita.
-
Defina de qual número as ligações vão sair. São dois caminhos:
- Número comprado na Twilio. Um número brasileiro exige documentação da empresa (CNPJ e endereço) e pode levar dias; um número americano não exige.
- O telefone que a sua empresa já usa, verificado na Twilio (Phone Numbers → Manage → Verified Caller IDs → Add). A Twilio liga para o número e alguém digita o código na hora. É o caminho mais rápido e não custa nada.
-
No AtendeBot, vá em Ajustes → Voz → Telefone (Twilio) e cole Account SID, API Key SID e Secret. Clique em Salvar e testar.
-
Escolha a origem das ligações no seletor: o número comprado ou o número verificado. Sem origem definida o telefone não disca.
-
Ainda na mesma aba, na seção Ligações por telefone, ajuste as duas proteções de gasto:
- Teto diário de minutos: padrão 120. Use
0para não ter limite. - Códigos de país permitidos: padrão
+55. Uma lista vazia desliga as ligações por telefone.
- Teto diário de minutos: padrão 120. Use
Resultado esperado
O teste de conexão responde com as credenciais validadas, o saldo da conta e a quantidade de números disponíveis e verificados. A partir daí o botão Ligar das conversas passa a oferecer a opção Telefone.
ℹ️ O AtendeBot valida antes de gravar. Credencial errada não chega a ser salva. Você pode clicar em Testar conexão a qualquer momento; se a Twilio recusar a credencial de forma definitiva, o canal aparece como desconectado.
Quanto custa
A fatura é da sua conta Twilio. Valores de referência da tabela pública da Twilio para o Brasil, consultados em agosto de 2026: ligação para celular US$ 0,0663 por minuto, para fixo US$ 0,0310 por minuto, e gravação US$ 0,0025 por minuto. Número local brasileiro custa cerca de US$ 4,25 por mês; número americano, cerca de US$ 1,15. Verificar um número que você já tem não custa nada.
Erros comuns
- Sintoma: "Conta Twilio em modo trial: faça o upgrade no console da Twilio". Solução: faça o upgrade da conta na Twilio; o modo trial não permite a discagem.
- Sintoma: "A API Key não tem permissões: crie uma chave do tipo Standard". Solução: apague a chave Restricted e crie uma do tipo Standard.
- Sintoma: "Credenciais recusadas". Solução: confira o Account SID, o API Key SID e o Secret, e cole novamente.
- Sintoma: "Este número não pertence à conta". Solução: a origem escolhida precisa ser um número comprado na Twilio ou um Caller ID verificado.
- Sintoma: "Ligações para este país não estão liberadas". Solução: inclua o código do país em Códigos de país permitidos.
- Sintoma: "Limite diário de ligações atingido". Solução: aumente o teto diário de minutos ou aguarde a virada do dia.
📞 Como o seu número aparece para quem recebe. Com um número verificado brasileiro, a ligação sai pela rota internacional da Twilio e o aparelho do contato pode mostrar o número sem o sinal de mais, algo como "(55) 3499X-XXXX". Para aparecer como número nacional, a origem precisa ser um número brasileiro comprado na Twilio. Identificação de chamada e as regras de telemarketing ativo são responsabilidade da empresa que liga.