Webhook

أرسل كل عميل محتمل بصيغة JSON إلى عنوان https خاص بك مع الحقول التي تختارها.

ما تحتاجه

• عنوان https خاص بك يقبل طلب POST ويرد بحالة 2xx.
• في تفسير بوب أب: دور يسمح بإدارة التكاملات.

1. في Webhook

1. جهّز العنوان على خادمك أو في الأداة التي ستستلم العملاء.
2. اقرأ الويب هوك لمعرفة جسم الطلب وترويساته.

2. في تفسير بوب أب

1. افتح التكاملات وابحث عن Webhook. استخدم خانة البحث أو تبويبات الفئات.
2. اضغط ربط.
3. املأ النموذج (تسمياته بالإنجليزية):

• Endpoint URL: عنوان https الخاص بك.
• اسم الحساب: اختياري. اسم يميّز حساباتك عن بعضها.

4. اضغط ربط. ما تدخله يُحفظ مشفّرًا ويُستخدم فقط لتسليم عملائك.
5. تسألك نافذة أي الحملات ترسل العملاء إلى Webhook. حدّدها واضغط حفظ الحملات.

الحملات الجديدة لا تُضاف تلقائيًا. عُد إلى هنا أو أضف هذا التكامل من خطوة النشر في الحملة.

ما يُرسل

• العميل بصيغة JSON، وهو الجسم نفسه في الويب هوك: بيانات العميل والحملة والموقع والصفحة والجهاز والدولة ووسوم UTM.
• الصفوف التي تختارها تحت ما الذي يُرسَل تصل داخل "fields".
• العميل التجريبي يحمل "test": true ليتمكن سير عملك من تجاهله.

اختر ما يُرسل

تستخدم هذه الأداة جدول ما الذي يُرسَل الخاص بكل حملة. افتح خطوة النشر في الحملة، وابحث عن صف العملاء يصلون إلى أداة البريد واضغط إدارة، ثم تعديل على الأداة.

• الصف الأول، البريد الإلكتروني، يُرسل دائمًا ولا يمكن تغييره.
• اضغط أضف صفًا لإرسال إجابة من النموذج أو معلومة عن التسجيل: اسم الحملة أو الموقع أو عنوان الصفحة أو الدولة أو الجهاز أو الكود الممنوح أو وقت الموافقة.
• اضغط أضف قيمة ثابتة لإرسال النص نفسه مع كل عميل.
• قبل الحفظ يخبرك التطبيق إذا كان صفّان يذهبان إلى الحقل نفسه أو كان صف بلا شيء يُرسله.

اختبره

1. في بطاقة Webhook اضغط إرسال عميل تجريبي. يقول التطبيق: تم تسليم العميل التجريبي. تحقق من وصوله.
2. ابحث في Webhook عن العميل التجريبي.

النتيجة المتوقعة

تعرض البطاقة متصل وعدد الحملات. يحمل العملاء الجدد تم التسليم في قائمة العملاء ويظهرون في Webhook.

إن لم ينجح الأمر

• «The URL must start with https://». لا يُقبل http العادي.
• رفضت الأداة هذا العميل: ردّ عنوانك بحالة 4xx. راجع ما يتوقعه.
• حدثت مشكلة في جهة الأداة: ردّ عنوانك بحالة 5xx أو تأخر كثيرًا. يعيد تفسير المحاولة تلقائيًا.
• لا توجد حملة ترسل العملاء إلى هنا بعد، لذلك لن يصل شيء. اضغط اختيار الحملات.
• عميل يحمل فشل: افتحه لقراءة ردّ الأداة، وأصلح السبب، ثم اضغط أعد الإرسال. راجع تسليم العملاء المحتملين وإعادة الإرسال.

مواضيع ذات صلة

• ربط أداة: كيف يعمل
• تسليم العملاء المحتملين وإعادة الإرسال
• العملاء المحتملون لا يصلون إلى أداة