Como integrar WhatsApp no Agente Integra: guia pratico para iniciantes

Objetivo deste guia

Este passo a passo foi feito para quem nunca configurou WhatsApp API. No final, voce vai ter seu numero conectado ao Agente Integra para receber e responder mensagens automaticamente.

Antes de comecar (checklist)

• Conta no Meta Business com permissao de administrador.
• Um numero para WhatsApp Business API (nao use numero pessoal em uso no app comum).
• Acesso ao painel do Agente Integra com permissao para editar integracoes do agente.

Passo 1: criar (ou abrir) seu app no Meta Developers

1. Acesse developers.facebook.com e entre com sua conta administradora.
2. Clique em Meus Apps e depois em Criar App.
3. Escolha um tipo de app compativel com integracoes (geralmente "Business").
4. No app, adicione o produto WhatsApp.

Se voce ja tiver app pronto para WhatsApp, pode pular para o passo 2.

Passo 2: pegar os dados obrigatorios da API

No produto WhatsApp (API Setup), copie:

• Phone Number ID (ID numerico do numero conectado).
• Access Token (token de acesso para enviar/receber mensagens).

Importante: nunca compartilhe token em WhatsApp, e-mail sem criptografia ou print publico.

Passo 3: abrir o Agente Integra e configurar o canal WhatsApp

1. No painel, abra o agente que vai atender no WhatsApp.
2. Va em Integracoes e selecione WhatsApp Business.
3. Preencha:

• phone_number_id com o ID do numero da Meta.
• access_token com o token atual da Meta.
• verify_token com uma chave criada por voce (ex.: meu-token-verificacao-2026).

Ao preencher, copie tambem a URL exibida no bloco Webhook para configurar no canal.

Passo 4: validar webhook no Meta

1. No app da Meta, abra WhatsApp > Configuration (nome pode variar).
2. No campo Callback URL, cole a URL de webhook do Agente Integra.
3. No campo Verify Token, cole exatamente o mesmo valor de verify_token usado no Agente Integra.
4. Clique em validar/salvar.

Se falhar, quase sempre e diferenca de token (espaco extra, letra maiuscula/minuscula, ou token diferente).

Passo 5: assinar eventos de mensagem

Ainda no Meta, marque os eventos de mensagens (ex.: mensagens recebidas). Sem isso, o webhook valida mas o chat nao chega ao sistema.

Passo 6: testar ponta a ponta

1. No painel do Agente Integra, use o botao Testar integracao.
2. Envie uma mensagem real para o numero do WhatsApp.
3. Confirme se a conversa aparece no painel de conversas.

Fluxo 1 (configuracao inicial) x Fluxo 2 (rotina diaria)

Fluxo 1: configuracao inicial

• Criar app na Meta.
• Pegar Phone Number ID e Access Token.
• Configurar Integracao WhatsApp no Agente Integra.
• Validar webhook e assinar eventos.

Fluxo 2: rotina diaria do time

• Monitorar novas conversas no painel.
• Revisar handoff para humano quando necessario.
• Ajustar respostas e base de conhecimento conforme perguntas reais.
• Refazer teste rapido sempre que trocar token/numero.

Erros comuns e como resolver

• Erro de validacao do webhook: confira se verify token esta identico nos dois lados.
• Mensagem nao chega no painel: revise se os eventos de mensagens foram assinados na Meta.
• Erro de credencial: token expirou ou foi revogado; gere novo token e atualize no Agente Integra.
• Numero sem envio: verifique status do numero e restricoes de conta no Meta Business.

Checklist final (copie e use)

• [ ] App Meta com produto WhatsApp ativo.
• [ ] phone_number_id preenchido no Agente Integra.
• [ ] access_token preenchido no Agente Integra.
• [ ] verify_token igual no Agente Integra e Meta.
• [ ] Webhook validado com sucesso.
• [ ] Eventos de mensagens assinados.
• [ ] Teste real concluido com conversa no painel.

Com isso, sua integracao fica pronta para operacao real no dia a dia.