WhatsApp Business

O Simple Agent integra diretamente com a Meta Cloud API (WhatsApp Business Platform). Seu agent responde mensagens de WhatsApp com o mesmo conhecimento do widget web — sem duplicar treinamento.

Pré-requisitos

Antes de começar, você precisa:

1. Meta Business Account — gratuito em business.facebook.com
2. Número de telefone dedicado — o número não pode estar em outro app WhatsApp ativo. Pode ser um chip novo ou uma linha VoIP.
3. Plano Simple Agent Growth ou Agency — canais estão disponíveis nesses planos.

---

Configurar no painel

1. Criar o app Meta

1. Acesse developers.facebook.com → Meus Apps → Criar App
2. Selecione Business como tipo
3. Escolha a sua Meta Business Account
4. Dentro do app, adicione o produto WhatsApp

2. Obter credenciais

No painel do seu app Meta, vá em WhatsApp → Configuração:

Campo	Onde encontrar
Phone Number ID	WhatsApp → Configuração → Número de Telefone
WhatsApp Business Account ID	WhatsApp → Configuração → Conta
Temporary Access Token	Token temporário (troque por token permanente em produção)

3. Conectar no Simple Agent

1. No dashboard do seu agent → Canais → WhatsApp
2. Cole o Phone Number ID, WABA ID e Access Token
3. Clique em Salvar e gerar Webhook URL

O sistema exibe:

Webhook URL: https://simple-agent.me/api/v1/webhooks/whatsapp/ag_xxx
Verify Token:  agt_verify_xxxxxxxxxxxx

4. Configurar o webhook na Meta

1. No painel Meta → WhatsApp → Configuração → Webhooks
2. Clique em Editar e cole a URL e o Verify Token acima
3. Marque os campos: messages
4. Clique em Verificar e salvar

Um request de verificação é enviado imediatamente — o Simple Agent responde automaticamente ao desafio.

---

Testar a integração

Após salvar, envie uma mensagem para o número configurado pelo WhatsApp. A resposta deve chegar em menos de 3 segundos.

Dica: Use o número de teste da Meta (disponível em WhatsApp → Configuração) para não precisar verificar o número real nos primeiros testes.

---

Comportamento do agent

• Texto: Respondido diretamente como mensagem de texto
• Áudio (voice note): Transcrito automaticamente via Whisper e processado como texto
• Imagem: Analisada quando o canal de visão estiver habilitado — útil para suporte com foto de produto/erro
• Documento PDF: Lido e incorporado na resposta
• Outros tipos (vídeo, localização): O agent responde com uma mensagem de fallback configurável

---

Limites e custos Meta

A Meta cobra por janela de conversa (não por mensagem). Os preços variam por país:

• Conversas de marketing iniciadas pela empresa: ~R$0,31 por conversa (BR)
• Conversas de serviço/utilidade iniciadas pelo usuário: ~R$0,06 (BR)
• Respostas dentro da janela de 24h: sem custo adicional

O Simple Agent não adiciona markup sobre esses custos — você paga direto à Meta.

---

Domínio personalizado no número

Para exibir o nome da sua empresa no WhatsApp (verified badge), complete o Business Verification na Meta Business Suite. O processo leva 3–7 dias úteis e exige CNPJ ou documentação da empresa.

---

Troubleshooting

Webhook não verifica:

• Confirme que a URL está acessível publicamente (não localhost)
• Verifique se o Verify Token está copiado sem espaços extras

Mensagens chegam mas sem resposta:

• Cheque se o Access Token não expirou (tokens temporários duram 24h)
• Troque por um System User Token permanente: Meta → Configurações → Usuários do Sistema

Erro 130429 (rate limit):

• Você excedeu o limite de mensagens por número de telefone por segundo. O Simple Agent enfileira automaticamente e reprocessa em até 5 segundos.

---

Configurações avançadas

Opção	Descrição
Mensagem de boas-vindas	Enviada automaticamente na primeira mensagem do usuário
Horário de atendimento	Fora do horário, o agent responde com mensagem customizável de "fora do ar"
Handoff humano	Se o usuário digitar "humano" ou "atendente", o agent encerra e notifica via webhook
Idioma automático	Detecta o idioma da primeira mensagem e responde no mesmo idioma

Ver todos os canais → · Configurar Instagram → · API Reference →