Canais
WhatsApp API Oficial (Meta)
Passo a passo para integrar a API Oficial do WhatsApp (WABA) ao Jarvis, do aplicativo na Meta ao token permanente.
A API Oficial é a conexão homologada pela Meta. Ela oferece mais estabilidade, melhor entregabilidade e recursos como templates, botões e listas. Em troca, segue regras próprias e as mensagens são cobradas pela Meta diretamente da sua empresa.
Antes de começar#
- A API Oficial não atende grupos e não mostra a foto dos contatos.
- Você só pode responder livremente em até 24 horas após a última mensagem do cliente. Depois disso, é preciso enviar um template.
- A conta também pode sofrer restrições se descumprir as políticas da Meta.
Você vai precisar de:
- Uma conta no Facebook com acesso ao Gerenciador de Negócios (Business Manager) da empresa.
- Um número de telefone que não esteja em uso no WhatsApp (ou use a coexistência para manter o app).
- Perfil de Administrador no Jarvis.
Parte 1 — Configurar na Meta#
- Acesse developers.facebook.com, entre com o Facebook e clique em Criar aplicativo.
- Escolha o tipo Empresa (ou Outro → Empresa, conforme a tela).
- No painel do app, localize WhatsApp em Produtos e clique em Configurar.
- Selecione o portfólio empresarial (ou crie um) e clique em Começar a usar a API.
- Em Configurações do app → Básico, preencha a URL da Política de Privacidade e a URL dos Termos de Serviço, salve e mude o app de Em desenvolvimento para Ativo.
- Vá em WhatsApp → Configuração da API e clique em Adicionar número de telefone. Conclua a verificação por SMS ou ligação.
- Na mesma tela, clique em Gerar token de acesso e copie o token temporário.
Parte 2 — Adicionar o canal no Jarvis#
- Em Cadastros → Canais, clique em Adicionar e escolha WABA API Oficial.
- Cole o Token de acesso.
- Copie da Meta, exatamente como aparecem:
- ID do número de telefone
- ID da conta do WhatsApp Business
- Informe a Versão da API sempre com v minúsculo, ponto e sem espaços:
v23.0,v24.0.
| Correto | Errado |
|---|---|
v24.0 |
24.0, V24.0, v 24.0 |
Parte 3 — Configurar o webhook#
O webhook é o caminho pelo qual a Meta entrega as mensagens recebidas ao Jarvis.
- No canal, clique em Gerar Token de Webhook. Copie o Token de Verificação e a URL de Callback.
- Salve o canal no Jarvis.
- Na Meta, abra WhatsApp → Configuração (etapa Configurar webhooks) e clique em Editar.
- Cole a URL de Callback e o Token de Verificação e clique em Verificar e salvar.
- Em Campos do webhook, assine pelo menos o campo messages.
Parte 4 — Registrar o número#
- No Jarvis, abra Ferramentas → Registrar Telefone no canal.
- Informe um PIN de 6 dígitos:
- Se o número nunca teve PIN, crie um novo agora.
- Se já teve, use o mesmo PIN de antes.
Guarde esse PIN: ele é definido uma única vez por número.
Parte 5 — Trocar pelo token permanente#
O token temporário expira em poucas horas. Para não parar de funcionar:
- Na Meta, crie um usuário do sistema no Gerenciador de Negócios, dê a ele acesso ao app e à conta do WhatsApp e gere um token permanente com as permissões
whatsapp_business_messagingewhatsapp_business_management. - No Jarvis, edite o canal e substitua o token temporário pelo permanente.
Conferindo se está tudo certo#
Em Ferramentas → Informações da Conta, o Jarvis mostra os dados do número, a conta vinculada e o webhook configurado na Meta. Use a checklist:
- O webhook aparece em Informações da Conta.
- Não existe outra URL antiga cadastrada no campo de webhook do número (ela tem prioridade sobre a do app).
- O campo messages está assinado na Meta.
- O token salvo no canal é o permanente.
Se algo estiver diferente, use Ferramentas → Atualizar URL Webhook, que reconfigura automaticamente o webhook do Jarvis na Meta.