Webhooks de Saída

Configure um webhook para receber notificações em tempo real quando eventos acontecerem na plataforma (mensagens recebidas, enviadas, etc).

Configurar Webhook (upsert)

Existe apenas uma configuração de webhook por usuário. Use PUT para criar ou atualizar:

curl -X PUT https://api.mex.aillom.com.br/api/webhooks \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://seuservidor.com/webhook",
    "events": ["message.received", "message.sent"],
    "active": true
  }'

Eventos Disponíveis

Evento	Descrição
`message.received`	Nova mensagem recebida de um usuário
`message.sent`	Mensagem enviada pelo agente

Formato do Payload

{
  "event": "message.received",
  "timestamp": "2025-01-01T12:00:00Z",
  "data": {
    "instance": "meu-whatsapp",
    "from": "5511999999999",
    "message": "Olá, preciso de ajuda!",
    "agent_id": "uuid-do-agente"
  }
}

Testar o Webhook

curl -X POST https://api.mex.aillom.com.br/api/webhooks/test \
  -H "Authorization: Bearer SEU_TOKEN"

Isso envia um evento de teste para a URL configurada.

Ver Configuração Atual

curl https://api.mex.aillom.com.br/api/webhooks \
  -H "Authorization: Bearer SEU_TOKEN"

:::tip Segurança Valide a origem das requisições verificando o IP de origem ou adicionando um token secreto na URL do webhook. :::