تكامل تدفق الأحداث

نظرة عامة على التكامل

نوع التكامل

المصدر: يتم إرسال البيانات من Pushwoosh إلى نظامك عبر HTTP أو gRPC بناءً على مشغلات الأحداث التي تم تكوينها.

كيف يعمل التكامل؟

يقوم Pushwoosh بنقل بيانات أحداث الاتصال (مثل نشاط الدفع/البريد الإلكتروني) إلى نقطة نهاية يحددها العميل. يتم إرسال البيانات في تدفقات دفعات على فترات مجدولة أو عند الوصول إلى الحد الأدنى لحجم الدفعة.

يتم إرسال البيانات فقط إذا كانت تطابق الأحداث والمنصات والفلاتر الاختيارية المحددة (رموز الحملة/الرسالة، النشاط المباشر). يجب أن تكون نقطة نهاية العميل جاهزة للاستلام والرد اختياريًا بحالة.

مسرد المصطلحات

عنوان URL لنقطة النهاية (Endpoint URL): نقطة نهاية من جانب الخادم تسمح باستلام الطلبات. يمكن للعميل تحديد منفذ إذا لزم الأمر.

أمثلة:

https://clientdomainname.com/webhook_endpoint
https://clientdomainname.com:8081/webhook_endpoint

قائمة الكيانات المتزامنة

أحداث إحصائيات الاتصال (مثل، Push Sent، Email Delivered)

حالات الاستخدام

تتبع التفاعل في الوقت الفعلي

مراقبة تفاعلات المستخدم مثل إرسال الدفع أو فتح البريد الإلكتروني أو تسليم الرسالة فور حدوثها، مما يتيح رؤية فورية لأداء الحملة.

التكامل مع التحليلات الخارجية

بث الأحداث إلى منصات التحليلات التابعة لجهات خارجية لإعداد التقارير والتحليل المركزي.

أتمتة تدفقات عمل المستخدم

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

إعداد التكامل

لإعداد التكامل:

في حساب Pushwoosh الخاص بك، انتقل إلى الإعدادات > تكاملات الجهات الخارجية (Settings > 3rd party Integrations)، وابحث عن تكامل تدفق الأحداث (Event streaming integration)، وانقر على تكوين (Configure).

تكوين تكامل تدفق الأحداث

في النافذة التي تفتح، املأ الحقول اللازمة.

املأ الحقول اللازمة

أدخل عنوان URL لنقطة النهاية

في حقل عنوان URL لنقطة النهاية (Endpoint URL)، أدخل عنوان URL الكامل الذي سيتم إرسال الأحداث إليه، بما في ذلك البروتوكول والمنفذ إن أمكن.

مثال

https://clientdomainname.com/webhook_endpoint
https://clientdomainname.com:8081/webhook\_endpoint

حدد الأحداث

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

قدم بيانات اعتماد التفويض

إذا كان الخادم الخاص بك يتطلب ذلك، فأدخل القيمة الكاملة لترويسة Authorization في حقل التفويض (Authorization).

أمثلة:

Bearer your_token_here
Basic base64encoded_credentials

اختر نوع النقل

من القائمة المنسدلة نوع النقل (Transport type)، اختر بروتوكول التسليم لنقل الأحداث: HTTP أو gRPC. لكل منهما سلوك وتكوين محدد.

HTTP

مع نوع النقل HTTP، يرسل Pushwoosh البيانات على دفعات بناءً على أحد الشرطين التاليين:

هناك 100 حدث على الأقل جاهزة للإرسال، أو
مرت ساعة واحدة منذ آخر إرسال.

بعد إرسال البيانات، يتم إغلاق الاتصال بمجرد استلام استجابة ناجحة.

إذا استجاب الخادم بخطأ 5xx، فسيقوم Pushwoosh بإعادة محاولة الطلب وفقًا لسياسة إعادة المحاولة المحددة.

آلية إعادة المحاولة

المحاولة	التأخير
الأولى	ثانية واحدة
الثانية	3 ثوانٍ بعد المحاولة الأولى
الثالثة	8 ثوانٍ بعد المحاولة الثانية

إذا فشلت جميع محاولات إعادة المحاولة، يتم تجاهل الطلب.

المهلة الزمنية

المهلة الزمنية الافتراضية للطلب هي 30 ثانية. يمكن تخصيص ذلك عند الطلب عبر الدعم.

عرض مثال

gRPC

يستخدم نوع النقل gRPC البث ثنائي الاتجاه لنقل البيانات. تعرف على المزيد في وثائق gRPC.

يتم فتح بث عند استيفاء أحد الشرطين التاليين:

هناك 1000 حدث على الأقل جاهزة للتسليم
مرت ساعة واحدة منذ آخر بث تم فتحه

يتم إغلاق البث بعد إرسال الأحداث. هذا يضمن عدم فتح بث جديد لكل حدث فردي في وقت قصير.

انظر مواصفات protobuf

آلية إعادة المحاولة
يتضمن كل حدث uuid فريدًا. إذا فشل حدث ما:

يجب أن تتضمن الاستجابة status لا يساوي "Success"
يجب تضمين uuid الأصلي من الطلب

سيقوم Pushwoosh بإعادة محاولة التسليم بناءً على هذه الاستجابة.

إعدادات الاتصال

يتم تكوين الخيارات المتقدمة مثل TLS أو keep-alive أو سياسات إعادة المحاولة يدويًا عبر الدعم وقد تتطلب مشاركة فريق التطوير.

حدد المنصات

في قسم المنصات (Platforms)، حدد منصة واحدة على الأقل لتفعيل بث الأحداث.

حدد منصة واحدة على الأقل

تشمل المنصات المدعومة:

iOS, Android, macOS, Windows, Amazon, Safari
Chrome, Firefox, Internet Explorer, Baidu, Huawei
Email, SMS, Line, Xiaomi, WhatsApp

تكوين الفلاتر المتقدمة

في قسم الفلاتر المتقدمة (Advanced filters)، قم بتحسين معايير تسليم الأحداث باستخدام الفلاتر:

أحداث النشاط المباشر (Live activity events): قم بالتمكين لاستلام أحداث النشاط المباشر. تحتوي هذه الأحداث فقط على بيانات وصفية بما في ذلك live_activity_id.
فلاتر الحملة (Campaign filters): قم بالتصفية حسب رمز الحملة. سيتم تسليم الأحداث المرتبطة بهذه الحملات فقط.
فلاتر الرسائل (Message filters): قم بالتصفية حسب رمز الرسالة. سيتم تسليم الأحداث المرتبطة بهذه الرسائل فقط.

تعيين الفلاتر المتقدمة

بعد إكمال جميع الحقول المطلوبة، انقر فوق زر تطبيق (Apply) لحفظ وتفعيل التكامل الخاص بك.

تفاصيل الطلب ومثال


نقطة النهاية	`https://exampleclientendpoint.com/webhook_endpoint`
طلب HTTP	`POST`
المصادقة	لا
نوع الطلب	المصدر
معنى الطلب	إرسال الطلبات إلى نقطة نهاية الويب هوك
الترويسات	`Content-Type: application/json`

مثال على نص الطلب

{
  "event_name": "Email Opened",
  "message_code": "E682-E6D92B9A-53E24868",
  "campaign_id": 961048,
  "platform": "Email",
  "payload": "Welcome to Headway! 👋",
  "application_code": "32E5A-9B411",
  "hwid": "irun4716@gmail.com",
  "user_id": "1894410",
  "timestamp": 1723799271,
  "journey_title": "",
  "journey_point_title": "5_Welcome_ID_new"
}

الاستجابة
في الوقت الحالي، يتم تجاهل رمز الاستجابة ونصها.

كيف تعرف أن التكامل يعمل؟

ستبدأ في تلقي الطلبات من Pushwoosh على نقطة النهاية التي قمت بتكوينها.