Saltar para a documentação
API

Ler eventos

Os eventos de um contacto, do mais recente para o mais antigo, e os nomes de eventos que o espaço de trabalho enviou, para escolher um num acionador.

GET/contacts/{email}/events

Executa qualquer uma das 2 chamadas no seu espaço de trabalho.

GET /contacts/{email}/events

Os eventos de um contacto, do mais recente para o mais antigo, e os nomes de eventos que o espaço de trabalho enviou, para escolher um num acionador.

Exemplo

Os eventos de um contacto requerem contacts:read, e os nomes requerem automations:read. O contacto é indicado por endereço ou por id. name restringe a lista a um evento, e limit vai até 200 e assume 50 por omissão.

curl
curl "$OE/contacts/[email protected]/events?name=order.placed" -H "$AUTH"curl "$OE/events/names" -H "$AUTH"
Resposta
{  "object": "list",  "data": [{      "object": "contact_event",      "id": "cev_6a1d9f3c8b2e40a75d9c1e38",      "contactId": "5b0e7c1a-2f4d-4c8b-9a36-1e7d0c5f8b24",      "email": "[email protected]",      "name": "order.placed",      "properties": { "orderId": "A-1042", "total": 59 },      "occurredAt": "2026-10-11T08:02:03.000Z",      "mode": "live",      "createdAt": "2026-10-11T08:02:03.412Z"    }],  "hasMore": false,  "nextCursor": null}

Os eventos com mais de 90 dias são eliminados, por isso uma ramificação só pode recuar 90 dias no máximo.

GET /events/names responde com uma lista de { "object": "contact_event_name", "name": "order.placed" }, até 100 nomes por ordem alfabética.

Referência