تخطَّ إلى المستندات
API

قراءة الأحداث

الأحداث التي قامت بها جهة اتصال واحدة، الأحدث أولًا، وأسماء الأحداث التي أرسلتها مساحة العمل، لاختيار أحدها في مشغِّل.

GET/contacts/{email}/events

ينفّذ أيًّا من الاستدعاءات الـ2 على مساحة عملك.

GET /contacts/{email}/events

الأحداث التي قامت بها جهة اتصال واحدة، الأحدث أولًا، وأسماء الأحداث التي أرسلتها مساحة العمل، لاختيار أحدها في مشغِّل.

مثال

أحداث جهة الاتصال تتطلب contacts:read، والأسماء تتطلب automations:read. وتُحدَّد جهة الاتصال بالعنوان أو بالمعرّف. ويحصر name القائمة في حدث واحد، وتصل limit إلى 200 وقيمتها الافتراضية 50.

curl
curl "$OE/contacts/[email protected]/events?name=order.placed" -H "$AUTH"curl "$OE/events/names" -H "$AUTH"
الاستجابة
{  "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}

تُحذف الأحداث الأقدم من 90 يومًا، فلا يستطيع التفرّع أن ينظر إلى الوراء أكثر من 90 يومًا.

يجيب GET /events/names بقائمة من { "object": "contact_event_name", "name": "order.placed" }، حتى 100 اسم مرتبةً أبجديًا.

المرجع