Como conectar a sua conta Twilio para o agente comprar números e cuidar do WhatsApp
Atualizado em
Com a API Key da sua conta Twilio em farejaleads.com/app/twilio, o seu agente (Claude, ChatGPT ou outro conectado ao MCP do FarejaLeads) busca e compra números, cria e verifica remetentes de WhatsApp e troca o nome de exibição. Tudo que gasta ou muda a conta mostra a prévia e só sai com o seu ok.
O que você ganha
- Buscar números à venda com o preço mensal e comprar (twilio_numeros_disponiveis, twilio_numero_comprar)
- Ver os números da conta e quais já são WhatsApp (twilio_numeros)
- Criar, verificar, editar e remover remetentes de WhatsApp, incluindo o nome de exibição (twilio_whatsapp_*)
- Checklist do que falta na Twilio e na Meta (twilio_conectar_status)
Antes de começar
- Uma conta na Twilio fora do Trial (com cartão): conta Trial não compra número além do de teste e só manda para números verificados.
- Para WhatsApp: um Meta Business Manager (business.facebook.com) com quem possa fazer login, e de preferência já verificado.
- Para número do Brasil (+55): um Regulatory Bundle aprovado na Twilio, com os documentos do CNPJ e o endereço.
Passo a passo
1. Crie a API Key
console.twilio.com → Account → API keys & tokens (console.twilio.com/us1/account/keys-credentials/api-keys) → Create API key. Copie o SID (começa com SK) e o Secret, que aparece uma vez só.
Main mostra também o nome e o tipo da conta; Standard faz todo o resto. Copie também o Account SID (AC…), na página inicial do Console.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
2. Cole no FarejaLeads
Abra farejaleads.com/app/twilio, cole o Account SID, o API Key SID e o Secret e clique em Testar e salvar. Ao salvar, o FarejaLeads só lê a conta para conferir: nada é criado nem cobrado.
Nunca cole a chave na conversa com o agente: ela fica cifrada só no servidor e não volta nem para a tela (só o final ••••1234).
3. Ligue a conta ao Meta Business (WhatsApp)
No Console da Twilio, em Messaging → Senders → WhatsApp senders, faça o Self Sign-up (Embedded Signup) entrando com o Facebook do Business Manager. Ao terminar, anote o WhatsApp Business Account ID (waba_id): o agente pede ele para criar o primeiro remetente.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
4. Verifique o Meta Business
Em business.facebook.com → Configurações do negócio → Central de segurança, inicie a verificação do negócio. A Meta exige o Business verificado para trocar o nome de exibição do WhatsApp e para subir os limites de envio.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
5. Número do Brasil: Regulatory Bundle
Console da Twilio → Phone Numbers → Regulatory Compliance → Bundles → Create: escolha Brasil, o tipo de número (local ou mobile) e envie os documentos do CNPJ e o endereço. Quando ficar twilio-approved, o agente usa o SID (BU…) para comprar o número +55.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
6. Peça ao agente
Exemplos: "compre um número de São Paulo com SMS", "crie o WhatsApp do número +55… com o nome Minha Loja", "troque o nome do WhatsApp para Minha Loja Oficial". O agente mostra a prévia (número, custo mensal, nome) e só faz depois do seu ok.
Regras que valem sempre
- Comprar número gasta dinheiro da sua conta Twilio (mensalidade na compra e todo mês): só com o seu ok para a prévia.
- Trocar o nome de exibição vai para a revisão da Meta (1 a 3 dias úteis); o nome antigo segue até aprovar, o número pode ficar de 20 a 30 minutos fora do ar na re-registração e a Meta limita as trocas por 30 dias.
- Esta conexão é separada da Twilio em Integrações (/app/conexoes), que recebe e manda as mensagens no CRM com o Auth Token.
- Para desligar: farejaleads.com/app/twilio → Desconectar, e revogue a API Key no Console da Twilio.