Como conectar a Twilio ao FarejaLeads (WhatsApp, SMS e ligações)
Atualizado em
Com a sua conta Twilio conectada, quem escreve para o seu número de WhatsApp ou SMS vira lead no kanban, você responde pelo FarejaLeads, dispara campanhas de modelos aprovados e liga para o lead em um clique.
O que você ganha
- Receber WhatsApp e SMS como leads
- Responder as conversas pela plataforma
- Campanhas de modelos (templates) aprovados
- Clicar para ligar (a Twilio liga para você e completa para o lead)
Antes de começar
- Conta na Twilio (twilio.com) com saldo — as mensagens e ligações são cobradas pela Twilio, direto na sua conta.
- Para WhatsApp em produção: um remetente de WhatsApp aprovado na Twilio, ligado a um Business Manager verificado na Meta. Para testar, o Sandbox de WhatsApp da Twilio serve.
- Para SMS e ligações: um número da Twilio com essas capacidades. Números do Brasil pedem o cadastro regulatório (Regulatory Compliance) na Twilio.
Passo a passo
1. Copie o Account SID e o Auth Token
No Console da Twilio, em Account Info, copie o Account SID (começa com AC) e o Auth Token (clique em mostrar).
2. Tenha os números
Phone Numbers → Manage → Buy a number: compre um número com SMS e/ou Voice.
Messaging → Senders → WhatsApp senders: registre o seu número de WhatsApp (ou use o Sandbox para testar).
3. Conecte no FarejaLeads
No app, vá em Integrações → Twilio → Conectar.
Cole o Account SID, o Auth Token e os números (WhatsApp, SMS e ligações — só os que você vai usar). Ao salvar, testamos a conexão na hora.
As chaves ficam cifradas e não aparecem de novo na tela.
4. Cole a URL do webhook na Twilio
Copie a URL do webhook mostrada no cartão da integração.
WhatsApp: Messaging → Senders → WhatsApp senders → seu número → em "Webhook URL for incoming messages", cole a URL (método HTTP POST). No Sandbox: Messaging → Try it out → WhatsApp sandbox settings → "When a message comes in".
SMS: Phone Numbers → Active numbers → seu número → Messaging configuration → "A message comes in": Webhook, cole a URL, HTTP POST.
5. Crie os modelos (templates)
Messaging → Content Template Builder: crie o modelo e envie para aprovação do WhatsApp.
Quando aprovado, ele aparece no FarejaLeads em WhatsApp e SMS → Campanha de modelo. Variáveis {{1}}, {{2}}… podem ser preenchidas com o nome do contato, da empresa, a cidade ou um texto fixo.
6. Ligações
Ao clicar em Ligar, a Twilio liga primeiro para o SEU telefone (perguntamos uma vez e guardamos no seu navegador). Quando você atende, a ligação é completada para o lead, com o seu número da Twilio como identificador.
Regras que valem sempre
- Janela de 24 h do WhatsApp: mensagem livre só até 24 h depois da última mensagem do contato. Para iniciar ou retomar a conversa depois disso, use um modelo aprovado.
- Opt-out: quem responder SAIR, PARAR ou STOP não recebe mais mensagens nem campanhas.
- LGPD: envie só para quem é cliente em potencial do seu negócio, identifique-se na mensagem e respeite os pedidos de remoção.