تخطّ إلى المحتوى الرئيسي

قوالب Webhook

قوالب Webhook هي طلبات Webhook قابلة لإعادة الاستخدام - عنوان URL والطريقة والترويسات والمصادقة والمحتوى، تُحفظ مرة واحدة وتُستخدم في أي حملة Webhook أو خطوة رحلة. مثال نموذجي هو "إرسال MMS عبر Delivyr": كل رحلة تحتاجه تعيد استخدام الطلب نفسه بدل إعادة كتابته. توجد في Brand Studio → Webhook Templates (/brand/webhook-templates). يتطلب عرض المكتبة templates:read؛ ويتطلب الإنشاء والتعديل templates:write.

ماذا يحتوي قالب Webhook​

الطلب الكامل الذي ترسله خطوة Webhook: عنوان URL، طريقة HTTP، ترويسات مخصصة، المصادقة (بدون، رمز Bearer، Basic، ترويسة مفتاح API، أو توقيع HMAC)، والمحتوى - JSON مع عناصر Liquid النائبة مثل {{user.phone}}، أو حقول بترميز النموذج. المنشئ هو النموذج نفسه كخطوة Webhook في الحملة، بما في ذلك إرسال اختبار إلى جهة اتصال عينة. يستخدم الاختبار جهة الاتصال التي تختارها - تُعرض جهة الاتصال الحقيقية تمامًا كما في الإرسال الفعلي - ويمكن تبديل النتيجة بين الاستجابة المستلمة والطلب المرسل: الطريقة والرابط والرؤوس والنص التي أُرسلت بالضبط، مع إخفاء بيانات الاعتماد.

الأسرار​

تُشفَّر الرموز وكلمات المرور ومفاتيح API وأسرار التوقيع عند حفظ القالب ولا تُعرض مرة أخرى أبدًا: يظهر السر المحفوظ كحقل مخفي. اترك الحقل المخفي كما هو للاحتفاظ بالسر، أو امسحه لإزالته، أو اكتب قيمة جديدة لاستبداله. لا يرسل الاختبار أبدًا قيمة مخفية؛ أعد إدخال السر إذا أردت اختباره.

عند بناء حملة أو رحلة من قالب، تنسخ Joryio السر المحفوظ للقالب إلى النسخة على الخادم، فتحمل الرسالة بيانات الاعتماد دون أن يمر السر أبدًا عبر متصفحك.

استخدام قالب​

  • الحملات - في خطوة إنشاء Webhook، تُفتح الرسالة الجديدة على بطاقتين: أنشئ الطلب أو استخدام قالب Webhook. اختر قالبًا بالاسم (الأحدث أولًا) فيُنسخ إلى الرسالة.
  • الرحلات - تحتوي عقدة رسالة Webhook، وكتلة Webhook المستقلة، على بحث البدء من قالب أعلى تبويب الطلب.

تملك الحملة أو الرحلة النسخة. لا يؤثر تعديلها، أو تعديل القالب لاحقًا، على الآخر أبدًا. حذف القالب آمن: تستمر النسخ الموجودة في العمل.

إدارة القوالب​

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