API · Automation

Webhook Trigger

استقبال POST خارجي وإطلاق workflow.

POST/api/automation/webhook/:workflowId🌐 Public

معلومة

Public endpoint — لا يتطلّب JWT. مُصمَّم لاستقبال webhooks من أنظمة خارجية (Stripe، Zapier، Make، إلخ).

Path Parameters

الحقل	النوع	الوصف
`workflowId`*	`string`	معرّف workflow بـ `triggerType=WEBHOOK`.

Body

الحقل	النوع	الوصف
`*`	`any`	JSON حر — يصبح `{{triggerData.body}}`. الـ HTTP headers تصبح `{{triggerData.headers}}`.

مثال طلب

curl -X POST https://operix.operixdigital.com/api/automation/webhook/wf_abc123 \
  -H "Content-Type: application/json" \
  -H "X-Custom-Header: my-value" \
  -d '{
    "event": "user.signup",
    "user": { "id": "u_1", "email": "new@example.com" }
  }'

الاستجابة

يستجيب فوراً بـ 200 حتى لو الـ workflow غير موجود أو غير مفعّل (أمان لمنع leak الـ IDs):

jsonإذا workflow صحيح ومفعّل

{ "status": "received", "runId": "run_xyz" }

jsonإذا workflow غير موجود/غير مفعّل/نوع غير webhook

{ "status": "ignored" }

Errors

الكود	الرسالة	السبب
200	`ignored / received`	حتى الـ workflow الخاطئ يستجيب 200 — للأمان.
500	`Internal Server Error`	خطأ غير متوقع. الـ webhook sender يفترض إعادة المحاولة.