پرش به مستندات
API

انتشار یک خودکارسازی

پیش‌نویس را به‌عنوان نسخهٔ بعدی ثابت می‌کند و خودکارسازی را روشن می‌کند. افراد از همین لحظه وارد می‌شوند، و کسی که پیش‌تر شرط آغازگر را داشته افزوده نمی‌شود.

POST/automations/{id}/publish

فراخوانی واقعی را روی فضای کاری شما اجرا می‌کند.

POST /automations/{id}/publish

پیش‌نویس را به‌عنوان نسخهٔ بعدی ثابت می‌کند و خودکارسازی را روشن می‌کند. افراد از همین لحظه وارد می‌شوند، و کسی که پیش‌تر شرط آغازگر را داشته افزوده نمی‌شود.

نمونه

به automations:write و emails:send نیاز دارد.

curl
curl -X POST "$OE/automations/aut_7c2e9a1f4b8d30c65e1a9f27/publish" -H "$AUTH"
پاسخ
{  "object": "automation",  "id": "aut_7c2e9a1f4b8d30c65e1a9f27",  "name": "Welcome series",  "description": null,  "status": "live",  "triggerKind": "audience_joined",  "stepCount": 4,  "emailCount": 2,  "hasUnpublishedChanges": false,  "publishedVersion": 2,  "pausedReason": null,  "lastError": null,  "counts": { "active": 38, "completed": 412, "exited": 9 },  "createdBy": "q7Vd3kX9mT2pLw8RzN4bYc6HfJ1sGa5E",  "publishedAt": "2026-10-02T09:14:00.000Z",  "pausedAt": null,  "archivedAt": null,  "createdAt": "2026-10-01T16:40:12.000Z",  "updatedAt": "2026-10-02T09:14:00.000Z",  "definition": {    "trigger": { "kind": "audience_joined", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "includeImported": false },    "entry": "welcome",    "steps": [      {        "key": "welcome",        "kind": "send_email",        "next": "pause",        "templateId": "tpl_9c1f0a4b7e05d3862c1f0a44",        "templateVersion": null,        "from": { "email": "[email protected]", "name": "Acme" },        "replyTo": null,        "subject": null,        "props": { "firstName": { "source": "contact", "field": "firstName" } }      },      { "key": "pause", "kind": "wait", "next": "opened", "wait": { "mode": "duration", "amount": 3, "unit": "days" } },      {        "key": "opened",        "kind": "branch",        "condition": { "kind": "email_opened", "stepKey": "welcome" },        "yes": null,        "no": "nudge"      },      {        "key": "nudge",        "kind": "send_email",        "next": null,        "templateId": "tpl_8f3a1c2e9b7d4a60",        "templateVersion": null,        "from": { "email": "[email protected]", "name": "Acme" },        "replyTo": null,        "subject": "{{firstName|Hello}}, did you see this?",        "props": {}      }    ]  },  "published": { "trigger": { "kind": "audience_joined", "…": "…" }, "entry": "welcome", "steps": ["…"] },  "settings": {    "timezone": "Europe/London",    "sendWindow": { "days": [1, 2, 3, 4, 5], "startMinute": 540, "endMinute": 1020 },    "reentryDays": null,    "exitOnLeave": true,    "listAudienceId": null  },  "problems": []}

پیش‌نویسی با مشکل بازدارنده با 422 invalid_automation رد می‌شود، و پاسخ همهٔ مشکل‌ها را در error.problems فهرست می‌کند.

هر گام ایمیل به یک قالب منتشرشده با پیوند لغو اشتراک و فرستنده‌ای نیاز دارد که این کلید یا برنامه اجازهٔ ارسال از آن را داشته باشد. قالبی که بدون نام مخاطب پر نمی‌شود هم مشکل است، چون بسیاری از مخاطبان نام ندارند: به آن مقدار یک جایگزین بدهید.

انتشار وقتی همهٔ خودکارسازی‌های فعال طرح در استفاده‌اند با 403 automation_limit_reached پاسخ می‌دهد.

انتشار دوبارهٔ پیش‌نویسی که تغییر نکرده نسخهٔ تازه‌ای نمی‌سازد. اما خودکارسازی متوقف را دوباره روشن می‌کند.

مرجع