Catálogo de eventos

28 eventos. Cada um alimenta tanto os webhooks de saída quanto os gatilhos das integrações nativas — é a mesma lista, porque responde à mesma pergunta.

Todo evento aqui tem um emissor verificado no servidor, conferido por um teste que varre o código. Esse teste existe por causa de um defeito real: bot.created era oferecido no painel e não disparava havia meses, porque o código tinha renomeado o conceito e o catálogo ficou parado. Quem assinava esperava entregas que não tinham como chegar, sem erro em lugar nenhum.

Conversas

Mensagens que entram e saem, status de entrega, e o ciclo de vida de uma conversa.

Evento	Observação
`message.received`
`message.sent`
`message.status`
`conversation.created`
`conversation.status.changed`
`conversation.resolved`
`conversation.escalated`

Comercial

Tudo o que o agente de IA captura ou marca em seu nome.

Evento	Observação
`lead.captured`
`order.created`
`order.updated`
`order.deleted`
`appointment.created`
`appointment.updated`
`appointment.deleted`
`crm.card.created`
`crm.card.moved`
`crm.card.updated`
`crm.card.deleted`

Plataforma

Agentes, canais de WhatsApp e sincronização de catálogo.

Evento	Observação
`bot.created`	Emitido internamente como `ai-agent.created`. O nome público é o contrato e não muda quando renomeamos as coisas por dentro.
`bot.deleted`	Emitido internamente como `ai-agent.deleted`. O nome público é o contrato e não muda quando renomeamos as coisas por dentro.
`channel.connected`
`catalog.synced`

Cobrança e cota

Marcos de uso e eventos de assinatura.

Evento	Observação
`quota.warning`
`quota.exceeded`
`trial.started`
`trial.locked`
`payment.succeeded`
`payment.failed`

Forma do payload

Toda entrega tem o mesmo envelope: id (o id estável do evento, também no cabeçalho X-ZapyFlow-Event-Id), event (o nome desta tabela) e data (o objeto específico daquele evento). Trate data como aberto — acrescentamos campos sem aviso.

O que está deliberadamente de fora

Sinais de interface em tempo real — indicador de digitação, presença, troca de foto de perfil — vivem no barramento interno e não são oferecidos aqui. Eles disparam o tempo todo, não carregam significado de negócio, e assinar isso custaria uma entrega por tecla digitada.