ابدأ أتمتة عندما يرسل تطبيق آخر بيانات (Webhook وارد)
لكل أتمتة بهذا المشغّل رابط خاص. يرسل موقعك أو أي أداة بيانات إليه، فتبحث الأتمتة عن السجل المطابق أو تنشئه وتملأ حقوله ثم تكمل خطواتها.
قبل أن تبدأ · للمالك والمشرف
صلاحية تعديل سير العمل
- تحتاج إلى: صلاحية تعديل سير العمل
الخطوات
1اختر المشغّل إرسال تطبيق آخر بيانات.
بعد إنشائه يحصل على عنوان خاص به.
2في عنوانك الخاص، اضغط نسخ والصق العنوان في التطبيق الآخر.
3اختياري: في أي سجلات؟، اختر مكان حفظ البيانات، مثل العملاء المحتملين.
بلا وحدة يعمل التشغيل على البيانات وحدها.
4اضغط الاستماع لطلب تجريبي، ثم أرسل طلباً تجريبياً من التطبيق.
يُحفظ أول طلب خلال 10 دقائق كعينة، ولا يبدأ أي تشغيل. تظهر قيم العينة لتختار منها.
5لكل قيمة من الطلب، اختر الحقل الذي تملؤه، أو عدم الحفظ.
6في ثم، في …، اختر ابحث عنه في … أو أنشئه والحقل في ابحث عنه بواسطة…، أو أضف دائمًا سجلًا جديدًا إلى ….
مثل رقم الجوال. يُحدَّث السجل الموجود مسبقاً دون تكراره.
7أضف الخطوات وشغّل الأتمتة.
كيف تُحدَّد السجلات؟
الإعداد
النتيجة
بلا وحدة
تشغيل بلا سجل
وحدة بلا مطابقة
سجل جديد في كل طلب
وحدة مع مطابقة ووُجد سجل
تحديث السجل الموجود، بلا تكرار
وحدة مع مطابقة ولم يوجد سجل
سجل جديد
المطابقة تقارن الجوال بالأرقام فقط، والبريد دون حالة الأحرف، والنص بعد التوحيد.
استخدام البيانات
كل قيمة من الطلب متاحة كمتغير {{webhook.path}}، مثل {{webhook.customer.phone}}. والشروط تقرأ كل قيمة أيضاً.
الأمان والتكرار
يمكنك الضغط على إضافة مفتاح توقيع؛ يُعرض المفتاح مرة واحدة. بعدها تُرفض الطلبات غير الموقّعة. ويمكنك إلغاء اشتراط التوقيع لاحقاً بـإيقاف التحقق.
الطلب المكرر لا يبدأ تشغيلاً ثانياً: نفس مفتاح عدم التكرار خلال 24 ساعة، أو نفس المحتوى خلال 10 دقائق.
إن كانت الأتمتة متوقفة تُرفض الطلبات، إلا في وضع الاستماع.
للمطور
الطلب كائن JSON حتى 64 كيلوبايت. التوقيع: X-Corteksa-Timestamp بثوانٍ Unix (±5 دقائق)، وX-Corteksa-Signature: v1=<HMAC-SHA256> على «الوقت.المحتوى». مفتاح عدم التكرار في Idempotency-Key.
إذا حدثت مشكلة
ما تراه
السبب
الحل
التطبيق الآخر يتلقى رفضاً بسبب التوقيع
مفتاح التوقيع غير صحيح أو الوقت متأخر أكثر من 5 دقائق.
اضغط إنشاء مفتاح جديد وأعطِ المفتاح الجديد للمطور.
رفض «الأتمتة متوقفة»
الأتمتة غير مفعّلة.
رفض بسبب كثرة الطلبات
أرسل التطبيق أكثر من 60 طلباً في الدقيقة.
قلّل عدد الطلبات في الدقيقة.
رفض «انتهت تنفيذات الباقة»
نفد رصيد التنفيذات الشهري.
الرابط لم يعد يعمل
حُذفت الأتمتة.
أعطِ التطبيق عنوان أتمتة موجودة.
قائمة التحقق تنبّه «لم يُرسل التطبيق الآخر أي شيء إلى سير العمل هذا بعد.»
لم تختبر العنوان.
اضغط الاستماع لطلب تجريبي وأرسل طلباً تجريبياً.
مثال من الواقع
الموقف
نموذج التسجيل في موقع الأكاديمية لا يصل للنظام.
ما فعلوه
- المشغّل إرسال تطبيق آخر بيانات على «العملاء المحتملون».
- المطابقة على الجوال، مع إنشاء سجل إن لم يوجد.
- ربط الاسم والجوال والدورة المطلوبة.
- إرسال رسالة ترحيب ومهمة اتصال.
النتيجة
كل تسجيل في الموقع يصبح عميلاً محتملاً خلال ثوانٍ، والعميل المعروف يُحدّث بدل التكرار.
شركة افتراضية للتوضيح، والأرقام تقريبية.
قواعد يجب معرفتها
حجم الطلب حتى 64 كيلوبايت، ويُقص كل نص عند 2,000 حرف. حتى 50 ربط حقل، وحتى 100 حقل معرّف، وعمق المسار حتى 8 مستويات. العينة تحفظ حتى 200 قيمة. «آخر طلب» قد يتأخر حتى دقيقة. التشغيل مرة واحدة لكل سجل والهدف يعملان فقط مع وحدة ومطابقة. لا تقدير لعدد التشغيلات لهذا المشغّل. هل حلّ هذا الدليل مشكلتك؟
إن لم يحلها، سنسألك عمّا كان ناقصاً.
