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

الأشخاص في الأتمتة

الأشخاص الذين دخلوا أتمتة، الأحدث أولًا، مع الخطوة التي يقف عندها كل منهم. والتسجيل الذي يُقرأ بمعرّفه يحمل أيضًا كل خطوة نفّذها.

GET/automations/{id}/enrollments

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

GET /automations/{id}/enrollments

الأشخاص الذين دخلوا أتمتة، الأحدث أولًا، مع الخطوة التي يقف عندها كل منهم. والتسجيل الذي يُقرأ بمعرّفه يحمل أيضًا كل خطوة نفّذها.

مثال

يتطلب automations:read. وقيمة status هي active أو completed أو exited، ويحصر stepKey القائمة في الأشخاص عند خطوة واحدة، ويبحث q في الأسماء والعناوين. وتصل limit إلى 200 وقيمتها الافتراضية 50.

curl
curl "$OE/automations/aut_7c2e9a1f4b8d30c65e1a9f27/enrollments?status=active" -H "$AUTH"curl "$OE/automations/aut_7c2e9a1f4b8d30c65e1a9f27/enrollments/aen_2d8f1b6c9e3a47d05b1c8e62" -H "$AUTH"
الاستجابة
{  "object": "list",  "data": [{      "object": "automation_enrollment",      "id": "aen_2d8f1b6c9e3a47d05b1c8e62",      "automationId": "aut_7c2e9a1f4b8d30c65e1a9f27",      "version": 2,      "contact": { "id": "5b0e7c1a-2f4d-4c8b-9a36-1e7d0c5f8b24", "email": "[email protected]", "name": "Ana Lima" },      "status": "active",      "source": "trigger",      "stepKey": "pause",      "waiting": true,      "waitingForEvent": null,      "heldFor": null,      "nextRunAt": "2026-10-14T08:02:11.000Z",      "exitReason": null,      "lastError": null,      "startedAt": "2026-10-11T08:02:03.000Z",      "finishedAt": null,      "updatedAt": "2026-10-11T08:02:11.000Z"    }],  "hasMore": false,  "nextCursor": null}

تكون قيمة waiting هي true ما دام الشخص في خطوة انتظار، وnextRunAt هو موعد تقدّمه. ويسمّي waitingForEvent الحدث الذي يترقّبه الانتظار.

يذكر heldFor لماذا لم تُنفَّذ بعد خطوة حلّ موعدها: window لنافذة الإرسال، وquota لحصة الإرسال في الخطة، وlane ما دام البريد التسويقي متوقفًا مؤقتًا لمساحة العمل، أو retry بعد إخفاق.

التسجيل المفرد يضيف runs: كل خطوة نفّذها، مع outcome، ومع emailId للرسالة إذا كانت الخطوة بريدًا.

المرجع