Primeiros passos

Módulo

Eventos de webhook

Auditoria dos eventos recebidos dos providers, com o payload nativo preservado.

GETListar eventos
GET/webhook-eventsEscopo: readOficial + Básico

Lista eventos recebidos.

Retorna os eventos brutos (mensagens, status, QR) recebidos das conexões, para auditoria e reprocessamento externo.

Parâmetros de caminho

Sem parâmetros adicionais.

Parâmetros de query
CampoTipoDescrição
connection_idopcionaluuidFiltra por conexão.
sourceopcionalmeta | freemiumFiltra pela origem do evento: conexão Oficial (meta) ou conexão do plano Básico (freemium).
eventopcionalstringFiltra por nome do evento (ex.: messages).
limitopcionalnumberQuantidade de registros por página. Padrão 50; máximo 200 na maioria das listas.
offsetopcionalnumberÍndice inicial da página. Use pagination.next_offset para buscar a próxima página.

Campos do corpo

Este endpoint não recebe corpo JSON.

Exemplos prontos

curl -X GET "https://connect.zyronstack.com/api/v1/webhook-events?source=meta&limit=20&offset=0" \
  -H "Authorization: Bearer SUA_CHAVE_API"

Respostas

200Eventos retornados.

Exemplo de resposta

{
  "data": [
    {
      "id": 30,
      "source": "meta",
      "event": "messages",
      "connection_id": "<CONNECTION_ID>",
      "payload": { "messages": [{ "from": "5511999998888", "type": "text" }] },
      "created_at": "2026-07-13T13:28:27.898Z"
    }
  ],
  "pagination": { "limit": 20, "offset": 0, "total": 2, "next_offset": null }
}