Como conectar a WhatsApp Cloud API (Meta) ao FarejaLeads
Atualizado em
A API oficial do WhatsApp, direto na Meta: quem escreve para o seu número vira lead no kanban, você responde pelo FarejaLeads e dispara campanhas de modelos aprovados.
O que você ganha
- Receber mensagens de WhatsApp como leads
- Responder as conversas pela plataforma
- Campanhas de modelos (templates) aprovados
Antes de começar
- Um Business Manager da Meta (business.facebook.com), de preferência verificado.
- Um número de telefone que não esteja em uso no app do WhatsApp (ou que você possa migrar).
- As conversas são cobradas pela Meta, na forma de pagamento da sua conta do WhatsApp Business.
Passo a passo
1. Crie o app
Em developers.facebook.com → Meus apps → Criar app, escolha o tipo Empresa (Business) e adicione o produto WhatsApp.
2. Copie os IDs
WhatsApp → Configuração da API: copie o Phone number ID (identificação do número de telefone) e o WhatsApp Business Account ID. Adicione o seu número de produção nessa mesma tela.
3. Gere um token permanente
Em business.facebook.com → Configurações do negócio → Usuários do sistema: crie um usuário do sistema com função de administrador.
Atribua a ele o app e a conta do WhatsApp Business, e gere um token com as permissões whatsapp_business_messaging e whatsapp_business_management, sem validade.
4. Copie a chave secreta do app
No app, Configurações → Básico → Chave secreta do aplicativo. Ela serve para conferirmos que cada webhook veio mesmo da Meta.
5. Conecte no FarejaLeads
No app, vá em Integrações → WhatsApp Cloud API → Conectar e cole o token, a chave secreta, o Phone number ID e o WABA ID. Ao salvar, testamos na hora.
6. Configure o webhook na Meta
No cartão da integração, copie a URL do webhook e o Verify token.
No app da Meta, WhatsApp → Configuração → Webhook → Editar: cole a URL de retorno de chamada e o token de verificação, clique em Verificar e salvar.
Em Campos do webhook, assine o campo messages.
7. Modelos (templates)
No WhatsApp Manager → Modelos de mensagem, crie e envie para aprovação. Aprovados aparecem em WhatsApp e SMS → Campanha de modelo.
Regras que valem sempre
- Janela de 24 h: mensagem livre só até 24 h depois da última mensagem do contato; depois disso, só modelo aprovado.
- Opt-out: quem responder SAIR, PARAR ou STOP não recebe mais mensagens nem campanhas.
- Ligações e SMS não fazem parte da WhatsApp Cloud API — para isso, conecte a Twilio.