Primeros pasos

Módulo

Eventos de webhook

Auditoría de los eventos recibidos de los providers, con el payload nativo preservado.

GET/webhook-events
GET/webhook-eventsAlcance: readOficial + Básico

Lista eventos recibidos.

Devuelve los eventos brutos recibidos de las conexiones para auditoría y reprocesamiento externo.

Parámetros de ruta

Sin parámetros adicionales.

Parámetros de query
CampoTipoDescripción
connection_idopcionaluuidFiltra por conexión.
sourceopcionalmeta | freemiumFiltra por el origen: conexión Oficial (meta) o conexión del plan Básico (freemium).
eventopcionalstringFiltra por nombre del evento (ej.: messages).
limitopcionalnumberCantidad de registros por página. Predeterminado 50; máximo 200 en la mayoría de listas.
offsetopcionalnumberÍndice inicial de la página. Usa pagination.next_offset para la siguiente página.

Campos del cuerpo

Este endpoint no recibe cuerpo JSON.

Ejemplos listos

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

Respuestas

200Eventos devueltos.

Ejemplo de respuesta

{
  "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 }
}