Events

Feed de lo que pasó en el workspace.

GET/v1/eventsevents:read

Eventos del workspace, más recientes primero. Incluye el catálogo de tipos en event_types.

Campo	Tipo	Descripción
`name`	string	Filtra por tipo, por ejemplo `ai.handoff`.
`limit`	number	1 a 100.
`cursor`	string	Paginación.

Respuesta

JSON

{  "data": [    {      "id": "evt_cc_cv_1832",      "name": "conversation.created",      "occurred_at": "2026-09-02T13:51:00.000Z",      "workspace_id": "ws_tinkay",      "payload": { "conversation_id": "cv_1832", "contact_id": "ct_juan", "channel": "messenger" }    }  ],  "next_cursor": "evt_cc_cv_1832",  "has_more": true,  "event_types": [    { "name": "conversation.created", "description": "Se creó una conversación nueva" }  ]}

Para reaccionar en tiempo real conviene usar webhooks. Este endpoint sirve para auditoría y para recuperar eventos perdidos.