WhatsApp Oficial (Cloud API)

Integre o Aillom MEX diretamente à WhatsApp Business Platform da Meta. Esta é a modalidade recomendada para operações em produção com alto volume de atendimento.

Vantagens em relação ao QR Code:

• ✅ Homologado pela Meta — sem risco de banimento
• ✅ Suporte a mensagens proativas via templates aprovados
• ✅ SLA de entrega garantido pela infraestrutura da Meta
• ✅ Escalabilidade sem limites de sessão

Pré-requisitos

Antes de configurar o canal, você precisará de:

1. Conta Meta Business verificada em business.facebook.com
2. Aplicativo Meta com o produto WhatsApp habilitado
3. Número de telefone registrado no WhatsApp Business (não pode estar em uso no app)
4. WABA (WhatsApp Business Account) — criada automaticamente durante o processo

1. Configurar no Meta for Developers

1.1 Criar o App

1. Acesse developers.facebook.com → Meus Apps → Criar App
2. Escolha o tipo Business
3. Adicione o produto WhatsApp ao app

1.2 Adicionar o Número de Telefone

No painel do app:

1. Vá em WhatsApp → Configuração
2. Clique em Adicionar número de telefone
3. Siga o fluxo de verificação via SMS ou chamada

1.3 Obter as Credenciais

Anote as seguintes informações — você vai precisar delas:

2. Registrar o Canal no MEX

Com as credenciais em mãos, crie o canal:

curl -X POST https://api.mex.aillom.com.br/api/whatsapp-oficial \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "atendimento-principal",
    "agent_id": "uuid-do-agente",
    "phone_number_id": "SEU_PHONE_NUMBER_ID",
    "waba_id": "SEU_WABA_ID",
    "access_token": "SEU_ACCESS_TOKEN_PERMANENTE"
  }'

Resposta:

{
  "id": "uuid-do-canal",
  "name": "atendimento-principal",
  "status": "active",
  "phone_number": "+5511999999999",
  "agent_id": "uuid-do-agente",
  "created_at": "2025-01-01T00:00:00Z"
}

3. Configurar o Webhook na Meta

O MEX precisa receber os eventos de mensagem da Meta. Configure o webhook no painel:

1. No app Meta, vá em WhatsApp → Configuração → Webhooks
2. Clique em Editar e preencha:

1. Inscreva os campos: messages
2. Clique em Verificar e Salvar

4. Verificar o Status

curl https://api.mex.aillom.com.br/api/whatsapp-oficial/{id} \
  -H "Authorization: Bearer SEU_TOKEN"

5. Enviar Templates (Mensagens Proativas)

A API oficial permite enviar mensagens fora da janela de 24h usando templates aprovados pela Meta:

curl -X POST https://api.mex.aillom.com.br/api/whatsapp-oficial/{id}/template \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+5511999999999",
    "template_name": "confirmacao_pedido",
    "language": "pt_BR",
    "variables": ["João", "Pedido #1234", "R$ 150,00"]
  }'

Templates precisam ser criados e aprovados previamente no Meta Business Manager.

Fluxo de Mensagens

Quando uma mensagem é recebida:

1. A Meta envia o evento ao webhook do MEX
2. O MEX identifica o canal e o Agente vinculado
3. A IA processa com o contexto completo (histórico, conversation_vars, ferramentas)
4. A resposta é enviada via WhatsApp Cloud API

Gerenciar Canais

# Listar canais oficiais do Workspace
curl https://api.mex.aillom.com.br/api/whatsapp-oficial \
  -H "Authorization: Bearer SEU_TOKEN"

# Atualizar agente vinculado
curl -X PUT https://api.mex.aillom.com.br/api/whatsapp-oficial/{id} \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "novo-uuid"}'

# Deletar canal
curl -X DELETE https://api.mex.aillom.com.br/api/whatsapp-oficial/{id} \
  -H "Authorization: Bearer SEU_TOKEN"

Comparativo de Modalidades