تكامل الويب هوك الوارد

مساعدة المطور مطلوبة

ستحتاج إلى مساعدة من فريق التطوير لديك لإعداد التكامل. يرجى مشاركة هذا الدليل معهم.

تتيح لك الويب هوك الواردة (Inbound webhooks) للخدمات الخارجية إرسال الأحداث مباشرة إلى Pushwoosh. عندما يقوم نظام طرف ثالث بتشغيل ويب هوك، يقوم Pushwoosh بمصادقة الطلب، وتحديد المشترك، وإطلاق الحدث المعيّن. يمكن للحدث بعد ذلك بدء رحلة (Journey) أو التقدم فيها.

استخدم الويب هوك الواردة لربط أدوات مثل أنظمة إدارة علاقات العملاء (CRMs)، ومنصات التجارة الإلكترونية، أو خدمات التحليلات دون الحاجة إلى بناء أو صيانة خادم خاص بك. كل ويب هوك وارد يشغل حدثًا واحدًا في Pushwoosh عند استلام طلب مطابق ومعالجته بنجاح.

قبل أن تبدأ

قم بإعداد ما يلي قبل فتح إعداد الويب هوك.

1. حدد أي حدث في Pushwoosh يجب أن يشغله الويب هوك. اختر حدثًا موجودًا من مشروعك ترغب في تشغيله من خدمة الطرف الثالث. على سبيل المثال، CheckoutSuccess. إذا لم يكن لديك حدث مناسب بعد، أنشئ واحدًا بالسمات التي تريد تعبئتها من البيانات الواردة.

2. تأكد من أن خدمة الطرف الثالث الخاصة بك يمكنها إرسال ويب هوك. يجب أن تكون الخدمة قادرة على إرسال طلب HTTP POST إلى عنوان URL خارجي عند وقوع الحدث الذي تهتم به، على سبيل المثال طلب جديد أو إرسال نموذج.

3. احصل على عينة حمولة JSON من خدمة الطرف الثالث الخاصة بك. هذا مثال صغير للبيانات التي ترسلها الخدمة في كل حدث. ستحتاج إليها لربط حقول الحمولة بسمات أحداث Pushwoosh.

إنشاء ويب هوك

1. في حساب Pushwoosh الخاص بك، انتقل إلى الإعدادات ← التكاملات ← الويب هوك الواردة وانقر على الإعدادات.

2. انقر على إنشاء ويب هوك لفتح تدفق الإعداد.

3. أدخل اسمًا للويب هوك حتى تتمكن من التعرف عليه في القائمة لاحقًا.

4. حدد حدث Pushwoosh الذي يجب أن يتم إطلاقه عندما يتلقى الويب هوك طلبًا صالحًا. يمكنك الاختيار من بين الأحداث الموجودة بالفعل في مشروعك. إذا كنت بحاجة إلى إنشاء حدث أولاً، راجع الأحداث.

ملاحظة

ويب هوك واحد يشغل حدثًا واحدًا فقط.

5. في مطابقة البيانات الواردة، الصق عينة حمولة JSON من خدمة الطرف الثالث الخاصة بك. يقوم Pushwoosh بتحميل حقول الحمولة في القوائم المنسدلة تلقائيًا.

ملاحظة

إذا قمت بتحديث الحمولة لاحقًا، انقر على إعادة تحميل خيارات التحديد لتحديث القوائم المنسدلة. هذا يعيد تعيين ربط الحقول الحالي. ستحتاج إلى إعادة ربط سماتك.

عينة الحمولة:

{
  "user_id": "12345",
  "email_address": "jane@example.com",
  "mobile": "+15551234567",
  "purchase_date": "2024-03-15",
  "order_number": "ORD-001",
  "price": 99.99,
  "payment_state": "success"
}

6. في تحديد المستخدمين حسب، حدد كيف يجب على Pushwoosh مطابقة الطلب الوارد مع مستخدم:

• User ID: يطابق حسب معرّف المستخدم الداخلي في Pushwoosh.
• Email: يطابق حسب عنوان البريد الإلكتروني.
• Phone: يطابق حسب رقم الهاتف.
• HWID: يطابق حسب معرّف الجهاز، أو المتصفح، أو البريد الإلكتروني.

في حقل الحمولة، حدد الحقل الذي يحتوي على القيمة المطابقة.

7. اربط كل سمة حدث بحقل حمولة. في كل صف ربط:

• سمة الحدث: اسم السمة في Pushwoosh. اختر من السمات المحددة لهذا الحدث.
• حقل الحمولة: الحقل من الحمولة الواردة الذي يحتوي على القيمة.

على سبيل المثال، اربط email بـ email_address، و total بـ price، و order_id بـ order_number.

انقر على + إضافة سمة لإضافة صف. انقر على × لإزالة واحد.

8. عند اكتمال التكوين، انقر على تمكين. تفتح نافذة عنوان URL للويب هوك.

مساعدة المطور مطلوبة

الخطوات التالية تتطلب الوصول إلى إعدادات الويب هوك في خدمة الطرف الثالث الخاصة بك. شارك عنوان URL والسر مع فريق التطوير لديك.

انسخ القيم والصقها في إعدادات الويب هوك في نظامك الخارجي:

• انسخ عنوان URL وقم بتعيينه كوجهة للويب هوك في خدمة الطرف الثالث الخاصة بك.
• انسخ السر والصقه في خدمتك الخارجية كقيمة لترويسة Authorization. تتضمن القيمة البادئة Bearer، لذا استخدمها كما هي. يرفض Pushwoosh أي طلب تكون فيه هذه الترويسة مفقودة أو غير مطابقة.

9. تظهر النافذة أيضًا طلب مثال مع عينة طلب POST. انقر على نسخ في كتلة المثال لنسخ الطلب الكامل. استخدمه لإرسال طلب اختبار وتأكيد أن Pushwoosh يقبل الويب هوك، أو شاركه مع فريقك كقالب للتكامل.

بعد تمكين الويب هوك، يظهر في قائمة الويب هوك بحالة ممكّنة ويبدأ في قبول الطلبات.

قائمة الويب هوك

تُظهر قائمة الويب هوك الواردة كل ويب هوك في مشروعك.

يُظهر كل صف:

• الاسم: اسم الويب هوك.
• الحدث: حدث Pushwoosh الذي يتم إطلاقه عندما يتلقى الويب هوك طلبًا صالحًا.
• الحالة: ممكّن أو معطّل.
• المستلمة: عدد الطلبات التي استقبلها الويب هوك.
• آخر تحديث: متى تم تغيير الويب هوك آخر مرة.

إدارة الويب هوك

افتح قائمة الصف للقيام بما يلي:

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

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

عرض سجل النشاط

يُظهر سجل النشاط جميع الطلبات الواردة للويب هوك المحدد.

لوحة الملخص

في الأعلى، راجع الملخص لآخر 24 ساعة:

• الزيارات: إجمالي عدد الطلبات الواردة المستلمة.
• النجاح: الطلبات التي نجحت فيها المصادقة، وتم العثور على المستخدم، وتم إطلاق الحدث.
• الفشل: الطلبات التي لم تتم معالجتها. لا يوقف الطلب الفاشل الويب هوك. يستمر Pushwoosh في قبول ومعالجة الطلبات اللاحقة.

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

إدخالات الطلب

يُظهر كل إدخال معرّف المستخدم (على سبيل المثال، User ID أو Email)، وشارة نجاح أو فشل، والطابع الزمني للطلب، ومعاينة لحمولة JSON المستلمة. انقر على إظهار لتوسيع تفاصيل الطلب الكاملة.

عرض الأحداث التي أطلقها الويب هوك في User Explorer

عندما تتم معالجة طلب ويب هوك بنجاح، يسجل Pushwoosh الحدث في User Explorer. يعتمد مكان ظهوره على كيفية تحديدك للمستخدم:

• User ID، أو Email، أو Phone: يتم تسجيل الحدث في ملف تعريف المستخدم. افتح المستخدم وانتقل إلى سجل الأحداث.
• HWID: يتم تسجيل الحدث على الجهاز المطابق. افتح المستخدم، وابحث عن الجهاز في أجهزة المستخدم النشطة، وانتقل إلى علامة التبويب سجل الأحداث الخاصة به.

ابحث عن الحدث بالاسم وقم بتوسيعه لرؤية السمات المربوطة (على سبيل المثال، price أو products) وسمة __webhook مع معرّف الويب هوك.

استخدام الويب هوك الواردة مع رحلات العملاء (Journeys)

بعد تمكين الويب هوك وإطلاقه للأحداث بنجاح، استخدم الحدث المحدد كـ مدخل رحلة قائم على المشغل. عندما يتلقى الويب هوك طلبًا صالحًا، يطلق Pushwoosh الحدث المربوط. أي رحلة تستخدم هذا الحدث كمدخل مشغل تبدأ تلقائيًا للمستخدم المطابق.