مركز المساعدةالأتمتةالإعداد
أرسل بيانات السجل إلى تطبيق آخر (Webhook)
خطوة الإرسال إلى تطبيق آخر ترسل بيانات السجل أو نصاً تصممه إلى رابط تطبيق خارجي، موقّعاً رقمياً، مع إعادة المحاولة عند الفشل المؤقت.
قبل أن تبدأ · للمالك والمشرفصلاحية تعديل سير العمل
قبل أن تبدأ · للمالك والمشرف
صلاحية تعديل سير العمل
- تحتاج إلى: صلاحية تعديل سير العمل
الخطوات
1
اضغط إضافة خطوة واختر الإرسال إلى تطبيق آخر.
2
في العنوان، الصق رابط التطبيق الخارجي.
3
بجانب العنوان، اختر الطريقة: POST أو PUT أو PATCH.
4
اختياري: في الترويسات، اضغط إضافة ترويسة.
5
في ما يُرسل، اختر السجل كاملاً أو نصي الخاص.
المخصص قالب JSON بمتغيرات مثل
{{name}}.6
جرّبها بـتشغيل تجريبي: يعرض ما سيُرسل دون الاتصال بالتطبيق.
كيف يعمل
الروابط الداخلية والخاصة مرفوضة. يقبل الإجراء العناوين العامة على الإنترنت فقط.
كل طلب يحمل توقيعاً مصنوعاً بسر التوقيع الخاص بالأتمتة. هذا السر لا يظهر في كورتيكسا.
الإرسال «مرة على الأقل»: بعد مهلة أو خطأ مؤقت يُعاد بنفس المحتوى ونفس مفتاح عدم التكرار، فيتجاهل التطبيق التكرار.
الشكل الجديد لبيانات السجل (الإصدار 2) يرسل الخيارات بأسمائها والملفات بروابط موقّعة. الخطوات القديمة تبقى على الإصدار 1 حتى تغيّرها.
سجل التشغيل يحفظ اسم النطاق فقط، وليس الرابط الكامل.
تفاصيل التوقيع والترويسات للمطور في اشترك في Webhooks لتصلك تغييرات السجلات.
إذا حدثت مشكلة
ما تراه
السبب
الحل
«لا يمكن استدعاء «…» — ليس عنوان http أو https عامًا.»
الرابط داخلي أو محلي.
استخدم رابطاً عاماً.
فشل مع رمز خطأ من التطبيق
التطبيق رفض الطلب أو تعطل.
تحقق من التطبيق، ثم أعد المحاولة من تابع سجل التشغيل، وأعد المحاولة أو استأنف من الخطوة الفاشلة.
«ترويسة غير مسموحة»
ترويسة محجوزة.
احذفها.
مثال من الواقع
شركة درع الأمان
الموقف
نظام المحاسبة يحتاج كل عقد موقّع.
ما فعلوه
- تغيّر حقل: تتغير المرحلة إلى «موقّع».
- الإرسال إلى تطبيق آخر بمحتوى مخصص: رقم العقد والقيمة والعميل.
النتيجة
تظهر الفاتورة في المحاسبة دون إدخال يدوي.
شركة افتراضية للتوضيح، والأرقام تقريبية.
قواعد يجب معرفتها
مهلة الاستجابة 10 ثوانٍ.
حتى 20 ترويسة، وقيمة كل ترويسة حتى 2,048 حرفاً.
يُحفظ أول 500 بايت من رد التطبيق.
بعض الترويسات محجوزة ولا تُضبط، مثل Host وContent-Length.
هل حلّ هذا الدليل مشكلتك؟
إن لم يحلها، سنسألك عمّا كان ناقصاً.