Eventos - Notifique

Evento = nome do fato (pedido.pago). Seu backend dispara; automações ENABLED com aquele gatilho criam runs. Não confunda com webhooks da Notifique de entrega de canal.

O que é um evento?

É um contrato de nome entre seu sistema e as automações. Você cadastra (opcionalmente com schemaJson), liga automações ao eventName e dispara com Enviar evento.

Evento × webhook da automação × mensagem recebida

	Evento (API)	Webhook HTTP	Mensagem recebida
Quem inicia	Seu backend	Sistema externo (POST)	Cliente no canal
Config	Nome + schema	URL/segredo na automação	Gatilho inbound no grafo
Dados	`payload` JSON	Corpo do POST	Texto/mídia da mensagem

Este artigo foca em eventos pela API. Os outros gatilhos configuram-se no editor da automação.

Cadastrar

{
  "name": "pedido.pago",
  "schemaJson": {
    "orderId": "string",
    "total": "number"
  }
}

Escopo: events:write. Rotas na spec Automações e eventos.

Disparar

{
  "event": "pedido.pago",
  "email": "cliente@example.com",
  "payload": {
    "orderId": "ORD-99",
    "total": 150.0
  }
}

Destinatário: contactId, email ou phone
Header Idempotency-Key recomendado
Resposta: lista de runs (uma por automação ligada)

Boas práticas

Nomes estáveis: order.paid, user_created
Payload pequeno (IDs, valores, datas)
Um disparo pode acionar várias automações, planeje volume e créditos

Escopos

Ação	Escopo
Listar / buscar	`events:read`
Criar, editar, excluir, disparar	`events:write`

​O que é um evento?

​Evento × webhook da automação × mensagem recebida

​Cadastrar

​Disparar

​Boas práticas

​Escopos

​Próximos passos

O que é um evento?

Evento × webhook da automação × mensagem recebida

Cadastrar

Disparar

Boas práticas

Escopos

Próximos passos