تكامل بث الأحداث

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

نوع التكامل

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

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

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

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

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

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

أمثلة:

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

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

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

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

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

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

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

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

سير عمل المستخدم الآلي

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

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

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

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

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

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

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

أدخل عنوان 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 أو retry policies يدويًا عبر الدعم وقد تتطلب مشاركة فريق التطوير.

حدد المنصات

في قسم 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": "XXXXX-XXXXX",
  "hwid": "user@example.com",
  "user_id": "USER_ID",
  "timestamp": 1723799271,
  "journey_title": "",
  "journey_point_title": "5_Welcome_ID_new"
}

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

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

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