WhatsApp via QR Code

Conecte qualquer número de WhatsApp ao Aillom MEX através de leitura de QR Code — sem aprovação prévia da Meta.

Qual método escolher?

• WhatsApp via QR Code (esta seção) → Configuração rápida, funciona com qualquer chip. Recomendado para testes e projetos internos.
• WhatsApp Oficial (Cloud API) → Integração direta com a Meta. Necessária para operações em produção com alto volume.

⚠️ Importante: Leia antes de usar em produção

Este método de conexão não é homologado pela Meta. Ao utilizá-lo, esteja ciente dos seguintes riscos:

Recomendação: Use este método apenas para desenvolvimento, testes e automações internas com volume baixo. Para atendimento ao cliente em escala, utilize o WhatsApp Oficial.

1. Criar a Instância

curl -X POST https://api.mex.aillom.com.br/api/whatsapp \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "meu-whatsapp",
    "agent_id": "uuid-do-agente"
  }'

Resposta:

{
  "id": "uuid-da-instancia",
  "name": "meu-whatsapp",
  "status": "connecting",
  "agent_id": "uuid-do-agente",
  "created_at": "2025-01-01T00:00:00Z"
}

2. Obter o QR Code

Após criar a instância, solicite o QR Code para vincular o número:

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

Resposta:

{
  "qrcode": "data:image/png;base64,iVBORw0KGgo..."
}

Abra o WhatsApp no celular → Dispositivos Conectados → Conectar Dispositivo → escaneie o QR Code retornado.

Dica: Use um número dedicado exclusivamente para automação. Evite usar seu número pessoal ou o número comercial principal.

3. Verificar o Status

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

4. Reconectar ou Desconectar

# Reconectar (gera novo QR Code)
curl -X POST https://api.mex.aillom.com.br/api/whatsapp/{id}/reconnect \
  -H "Authorization: Bearer SEU_TOKEN"

# Desconectar manualmente
curl -X POST https://api.mex.aillom.com.br/api/whatsapp/{id}/disconnect \
  -H "Authorization: Bearer SEU_TOKEN"

5. Fluxo de Mensagens

Quando a instância está conectada, as mensagens recebidas são automaticamente:

1. Capturadas pela plataforma
2. Roteadas ao Agente vinculado
3. Processadas pela IA com o contexto, prompt e ferramentas configuradas
4. Respondidas ao contato via WhatsApp

Gerenciar Instâncias

# Listar instâncias do Workspace
curl https://api.mex.aillom.com.br/api/whatsapp \
  -H "Authorization: Bearer SEU_TOKEN"

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

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

Limitações em relação à API Oficial

Para produção em escala, consulte a documentação do WhatsApp Oficial (Cloud API).