استخدام بيانات استجابة webhook في رحلتك

نظرة عامة

عندما تقوم بـ تعيين قيم من استجابة webhook، يقوم Pushwoosh بتخزينها كمتغيرات يمكنك استخدامها لاحقًا في الرحلة، في أي مكان تستخدم فيه عادةً سمة Event.

ملاحظة

لإضافة عنصر Webhook وتكوين تعيين الاستجابة، راجع Webhook.

حفظ قيمة webhook كـ Tag باستخدام Update user profile

يمكن لـ Webhook إرجاع بيانات من نظام خارجي، مثل معرف مستخدم CRM أو حالة الاشتراك، التي لا يخزنها Pushwoosh في ملف تعريف المستخدم بعد. يقوم Update user profile بحفظ القيم المعينة كـ Tags حتى تتمكن من استخدامها في الشرائح، والمحتوى الديناميكي، وخطوات الرحلة اللاحقة.

مثال: حفظ معرف مستخدم CRM كـ Tag

يقوم مستخدم جديد بالتسجيل في تطبيقك، وتقوم الرحلة بإنشاء سجل مطابق في CRM الخاص بك. يتيح لك حفظ معرف مستخدم CRM المُرجع كـ Tag الرجوع إلى سجل CRM نفسه أو تحديثه لاحقًا، على سبيل المثال من رحلة أخرى أو استدعاء Webhook للمتابعة، بدلاً من إنشاء سجل مكرر في كل مرة يعود فيها المستخدم إلى الرحلة.

تدفق الرحلة: Trigger-based Entry → Webhook → Update user profile → إنهاء الفرع

1. أنشئ رحلة باستخدام Trigger-based Entry على حدث SignUp.
2. أضف عنصر Webhook بعد خطوة الدخول. قم بتسميته (على سبيل المثال، Create user in CRM) وقم بتعيين عنوان URL للطلب إلى نقطة نهاية إنشاء المستخدم في CRM الخاص بك.
3. في تعيين الاستجابة، قم بتعيين المسار إلى حقل المعرف في الاستجابة (على سبيل المثال، data.user.id) و السمة إلى crm_user_id.

4. أضف عنصر Update user profile بعد خطوة Webhook.

5. في قيمة Tag الديناميكية، انقر فوق + قيمة ديناميكية. في Tag، حدد الـ Tag الذي يخزن معرف CRM (أنشئه مسبقًا إذا لزم الأمر). في الحدث، حدد خطوة webhook بالاسم الذي أعطيته لها (Create user in CRM). في القيمة الديناميكية، حدد crm_user_id.

6. أنهِ الفرع — أضف عنصر Exit أو اتركه بدون اتصال صادر.

تنبيه

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

جدولة تأخير من قيمة webhook باستخدام Time Delay

غالبًا ما توجد تواريخ الزيارة ومواعيد التجديد النهائية ونوافذ التسليم في نظام حجز أو فوترة خارجي. بعد أن يقوم Webhook بتعيين التاريخ من استجابة API، يمكن لـ Time Delay إيقاف الرحلة مؤقتًا حتى تلك اللحظة، على سبيل المثال قبل يومين من الموعد، حتى يتم إرسال الرسالة التالية في الوقت المحدد.

مثال: جدولة تذكير من تاريخ في الاستجابة

يقوم مستخدم بحجز موعد في تطبيقك. تجلب الرحلة تاريخ الزيارة من نظام الحجز الخاص بك وترسل تذكيرًا عبر إشعار Push قبل يومين من الزيارة.

1. أنشئ رحلة باستخدام Trigger-based Entry على حدث AppointmentBooked.
2. أضف عنصر Webhook بعد خطوة الدخول. قم بتسميته (على سبيل المثال، Get appointment details) وقم بتعيين عنوان URL للطلب إلى API نظام الحجز الخاص بك.
3. في تعيين الاستجابة، قم بتعيين المسار إلى حقل التاريخ في الاستجابة (على سبيل المثال، appointment.date) و السمة إلى visit_date.

4. أضف عنصر Time Delay بعد خطوة Webhook. حدد بناءً على بيانات المستخدم/الحدث، قم بتعيين الحصول على التاريخ من إلى الحدث، قم بتعيين الحدث إلى خطوة webhook بالاسم الذي أعطيته لها (Get appointment details)، قم بتعيين قيمة الحدث إلى visit_date، وقم بتعيين التأخير إلى قبل 2 أيام.

5. إذا كان بإمكان المستخدمين الحجز قبل أقل من يومين من الزيارة، فقم بتمكين التقسيم إلى فروع إذا كان التاريخ في الماضي أو فارغًا على عنصر Time Delay. يؤدي هذا إلى إنشاء فرعين، في الماضي و في المستقبل. راجع التقسيم إلى فروع عندما يكون التاريخ في الماضي أو فارغًا.
6. أضف خطوة Push مع رسالة التذكير الخاصة بك. إذا تم تمكين التقسيم، أضف هذا الـ Push في كلا الفرعين: في الماضي (أرسل فورًا) و في المستقبل (بعد Time Delay).
7. أنهِ كل فرع — أضف عنصر Exit أو اتركه بدون اتصال صادر.

تنبيه

إذا كانت القيمة المعينة مفقودة أو ليست تاريخًا صالحًا، يخرج المستخدم من الرحلة مع خطأ في هذه الخطوة.

إذا كانت الزيارة أقرب من يومين، فإن هدف قبل 2 أيام يكون بالفعل في الماضي عندما يصل المستخدم إلى Time Delay، ويغادر المستخدم الرحلة بدون خطأ وبدون تذكير ما لم تقم بتمكين التقسيم إلى فروع إذا كان التاريخ في الماضي أو فارغًا.

على عكس Update user profile، الذي يترك الـ Tag دون تغيير ويستمر، يقوم Time Delay بإيقاف المستخدم عندما يكون التاريخ مفقودًا أو غير صالح أو في الماضي (بدون تقسيم الفروع). تأكد من أن webhook الخاص بك يعيد تاريخًا بشكل موثوق به بتنسيق مدعوم. قم بتشغيل اختبار webhook قبل الإطلاق. اعرف المزيد.

أمور يجب أخذها في الاعتبار

• صيغة المسار: استخدم مسارًا مفصولًا بنقاط (على سبيل المثال، data.user.id). لا يتم دعم أحرف البدل والفلاتر. راجع تعيين استجابة Webhook للحصول على التفاصيل.
• حجم الاستجابة: لا تتم معالجة الاستجابات التي يزيد حجمها عن 64 كيلوبايت للتعيين.
• الاختبار: قم بتشغيل اختبار webhook في عنصر Webhook قبل استخدام القيم المعينة في رحلة حية.