المتطلبات الأساسية
- نقطة نهاية HTTPS (أو HTTP) تقبل طلبات
POSTوتُعيد رمز حالة 2xx لتأكيد التسليم. - إذا كنت تخطط لإرسال بيانات عملاء محتملين: قائمة عملاء محتملين واحدة على الأقل أو نموذج من Form-builder مُعدّ بالفعل كمصدر.
إعداد Webhook
تفتح الـ Webhooks كصفحة كاملة خاصة بها (وليس لوحة جانبية).1
فتح تكامل Webhooks
من Integrations، اختر Add Integration، ثم ابحث عن بطاقة Webhooks واختر Setup.
2
اختيار البيانات المراد إرسالها
اختر واحدًا من:
- Scan Analytics Data — أحداث المسح لرموز QR الخاصة بك.
- Event Tracking Data — بيانات تتبّع أحداث مخصصة.
- Lead List Data — مرسلات النماذج أو قوائم العملاء المحتملين.
3
اختيار مصدر (Lead List Data فقط)
إذا اخترت Lead List Data، اختر أيضًا قائمة العملاء المحتملين أو نموذج Form-builder الذي ينبغي أن تأتي منه المرسلات.
4
إدخال عنوان URL لنقطة النهاية
أدخل عنوان URL الكامل بصيغة
https:// (أو http://) الذي ينبغي أن ترسل Scanova طلبات POST إليه. اختر Add another URL لإرسال الحمولة نفسها إلى ما يصل إلى 5 نقاط نهاية إجمالًا.5
إنشاء الـ Webhook
اختر Create webhook. تبدأ Scanova بإرسال طلبات POST للأحداث المطابقة إلى كل عنوان URL هيّأته بمجرد وقوعها.
تُرسل Scanova حمولات الأحداث بطلبات POST إلى نقطة النهاية الخاصة بك في الوقت الفعلي. ينبغي أن تُعيد نقطة النهاية الخاصة بك استجابة 2xx لتأكيد التسليم — الاستجابة غير 2xx لا تُعيد المحاولة تلقائيًا.
تعديل Webhook موجود
فتح Webhook من Active Connections يعيد فتح النموذج نفسه، مُعبّأً مسبقًا. بما أن نموذج القراءة لا يعرض سوى عنوان URL واحد مُحلّل لكل اتصال، يعرض التعديل حقل عنوان URL واحدًا حتى لو كان الإعداد الأصلي يحتوي على أكثر من واحد.أين تذهب البيانات
حسب نوع البيانات المختار، تُرسل Scanova أحداث المسح، أو أحداث تتبّع الأحداث، أو مرسلات العملاء المحتملين/النماذج كحمولة JSON إلى كل عنوان URL لنقطة نهاية مُهيَّأ، بمجرد وقوع الحدث الأساسي.ذات صلة
- Slack — تكامل مشابه مدفوع بالأحداث، مقصور تحديدًا على قنوات Slack.
- Zapier — يوجّه نفس نوع بيانات الأحداث عبر كتالوج تطبيقات Zapier بدلًا من عنوان URL خام.
- Google Analytics (GA4) — تكامل آخر لإخراج البيانات من جهة الخادم لبيانات المسح/الأحداث.
- Management API overview — اسحب البيانات نفسها وفق جدولك الزمني الخاص بدلًا من تلقي أحداث الدفع.