3 min
A Engium se conecta ao WhatsApp pela plataforma oficial WhatsApp Business da Meta. Na maioria dos casos você pode usar a configuração guiada: abra Settings → Integrations Hub → WhatsApp Business e siga as quatro etapas (conectar sua conta da Meta, escolher seu número de telefone, verificar a conexão e escolher seus modelos de mensagem). As etapas manuais abaixo são para casos avançados, como gerenciar o seu próprio app da Meta.
Se você não tem uma, acesse o Meta Business Suite e crie uma conta empresarial. É grátis e leva alguns minutos.
Abrir o Meta Business Suite ↗Acesse o Meta for Developers, clique em 'Create App' e selecione o tipo 'Business'. Adicione o produto WhatsApp ao seu app.
Ir para o Meta for Developers ↗Na seção WhatsApp do seu app, adicione um número de telefone. A Meta enviará um código de verificação por SMS ou ligação. Importante: esse número NÃO pode estar registrado no WhatsApp - se for o caso, remova-o do WhatsApp antes.
Em Meta Business Suite → Settings → Business Settings → Users → System Users: crie um System User com a função 'Admin' e depois clique em 'Generate New Token'. Selecione o app do WhatsApp e conceda as permissões whatsapp_business_management e whatsapp_business_messaging. Copie o token - você não poderá vê-lo de novo.
Em Meta for Developers → seu app → WhatsApp → API Setup: você encontra tanto o seu Phone Number ID (numérico) quanto o WhatsApp Business Account ID.
Documentação da WhatsApp Cloud API ↗Na Engium, abra Settings → Integrations Hub → WhatsApp Business e escolha a opção de conexão manual. Informe seu Phone Number ID, seu Business Account ID e seu Access Token, depois verifique e conecte.
Depois da verificação bem-sucedida, a Engium fornece uma URL de webhook. Copie-a e cole em Meta App → WhatsApp → Configuration → Callback URL. Assine os eventos 'messages'. A Engium passará a receber todas as mensagens recebidas do WhatsApp.
| Campo (* = obrigatório) | Onde encontrar |
|---|---|
| Phone Number ID * | Meta for Developers → App → WhatsApp → API Setup → Phone Number ID |
| Business Account ID * | Meta for Developers → App → WhatsApp → API Setup → Business Account ID |
| Access Token * | Meta Business Suite → Settings → System Users → Generate Token (use o token permanente de System User, NÃO o token temporário de teste) |
A Meta cobra pelos modelos de mensagem que você envia (de marketing, utilidade e autenticação), com um valor que depende do país. As respostas que você envia dentro de 24 horas após a mensagem de um cliente são gratuitas. Veja na página de preços da Meta os valores atuais.
Use um Access Token permanente de System User em produção. O token temporário de teste do API Setup expira em 24 horas e vai quebrar a sua integração.
As primeiras mensagens aos clientes precisam usar Modelos de mensagem pré-aprovados (aprovados no WhatsApp Manager). Depois que o cliente responde, você tem uma janela de 24 horas para mensagens livres.