تكامل المطورين

7stamp خطافات الويب

متاح

ادفع كل حدث ولاء من 7stamp إلى أنظمتك الخاصة في الوقت الفعلي. لا يوجد اقتراع ولا توجد مكالمات مجدولة API. تصل الأحداث كطلبات HTTPS POST خلال ثوانٍ من حدوثها.

استخدم خطافات الويب للاحتفاظ بـ CRM أو ERP أو الواجهة الخلفية المخصصة متزامنة مع ما يحدث في جانب الولاء: من انضم، ومن حصل على ختم، ومن قام باسترداد قسيمة، ومن قام بتنشيط هدية عيد ميلاد، ومن أصبح غير نشط. ثم تقرر أنظمتك ما يجب فعله بهذه البيانات.

ما يمكنك فعله باستخدام خطافات الويب

خطافات الويب هي الجانب الخارجي من حزمة التكامل. إنها تعكس نشاط العملاء والمكافآت في الأنظمة التي تثق بها بالفعل فيما يتعلق بالمبيعات والخدمة والتحليلات والمراسلة.

اعكس سجل الولاء في CRM الخاص بك

يتم تسجيل كل ختم أو قسيمة أو عيد ميلاد أو عدم نشاط في سجل العميل في CRM الخاص بك. ترى الجدول الزمني الكامل للولاء بجوار المبيعات والمكالمات والتذاكر دون تسجيل الدخول 7stamp.

قم بتشغيل مجموعة الرسائل الخاصة بك

عندما يسترد العميل قسيمة، أرسل رسالة شكر SMS من بوابة SMS الموجودة لديك. عندما يصل العميل إلى الهدف، قم بنشر احتفال على Slack. عندما يصبح شخص ما غير نشط، قم بتوجيه الحالة إلى مدير حسابك.

تحليلات الطاقة والمصالحة

قم ببث الأحداث إلى أداة BI أو المستودع أو خط أنابيب التسوية. قم بمطابقة عمليات استرداد القسيمة مقابل إيصالات POS وحساب الولاء ROI في المقاييس الخاصة بك.

أنواع أحداث البطاقة

SCAN — تلقت البطاقة إجراء مسح/stamp.
REWARD_EARNED — تم الحصول على مكافأة على البطاقة.
VOUCHER_ISSUED — تم إصدار قسيمة.
VOUCHER_REDEEMED — تم استخدام قسيمة.
LOTTERY_WIN — يانصيب أدى إلى الفوز.
DELIVERY_INSERT — تم تسجيل تدفق إدراج التسليم.
CARD_JOINED — انضم عميل إلى البطاقة.
CARD_CAMPAIGN — وقع حدث حملة البطاقة.
BIRTHDAY_GREETING — حدث تحية عيد ميلاد.
ADMIN_VOUCHER_ISSUE — أصدر المسؤول قسيمة.
CARD_ADDED_TO_WALLET — أضاف العميل البطاقة إلى محفظته.
CARD_REMOVED_FROM_WALLET — قام أحد العملاء بإزالة البطاقة من محفظته.

أنشئ جهاز استقبال آمن للخطاف على الويب

الإقرار بعد التعامل المتين

يجب أن تقبل نقطة النهاية الخاصة بك HTTPS POST، تحقق من صحة شكل الطلب، واستمر في الحدث أو ضعه في قائمة الانتظار، ثم قم بإرجاع استجابة 2xx ناجحة. لا تقم بإجراء مكالمة بطيئة CRM أو مراسلة قبل الإقرار إذا كان من الممكن وضعها في قائمة الانتظار بأمان.

ارتبط بـ External ID

كل حدث ذي صلة يمكن أن يحمل External ID والاختياري External Source الذي استخدمته عند إنشاء البطاقة أو مسحها ضوئيًا. استخدم هذا الزوج لتحديث سجل CRM أو POS أو الطلب دون التخمين من الاسم أو البريد الإلكتروني.

Make التسليم غير فعال

قم بتخزين مفتاح معالجة متين أو بصمة الحدث قبل التسبب في آثار جانبية. إذا رأى المستلم نفس التسليم مرة أخرى، فلا ينبغي له إضافة ملاحظة أو قسيمة أو رسالة مكررة CRM. تعامل مع نقطة النهاية URL على أنها سر.

مثال على شكل حمولة الحدث

انسخ هذا في خطوة الأتمتة الخاصة بك json
{
  "event_type": "SCAN",
  "scanned_at": "2026-07-23T12:34:56Z",
  "user_card_id": 123,
  "card_template_id": 42,
  "card_template_name": "Coffee Loyalty",
  "stamps_added": 1,
  "stamps_before": 4,
  "stamps_after": 5,
  "amount": 24.5,
  "external_order_id": "order_2048",
  "external_id": "crm_contact_8821",
  "external_source": "hubspot"
}

تكوين خطاف ويب واختباره

01

إنشاء نقطة نهاية HTTPS في الواجهة الخلفية، أو طبقة التكامل CRM، أو Make خطاف الويب، أو Zapier Catch Hook. Make تأكد من التحكم في الوجهة قبل نسخ URL الخاص بها.

02

في 7stamp Admin، افتح Stamp Cards → API & Integrations → Webhooks.

03

أضف نقطة النهاية URL وحدد فقط أنواع الأحداث التي يحتاجها سير العمل المتلقي بالفعل.

04

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

05

فحص الحمولة المستلمة. قم بمطابقة External ID وExternal Source بالسجل المتوقع وتأكد من أن المتلقي يُرجع استجابة ناجحة.

06

قم بتمكين CRM أو القسيمة أو الآثار الجانبية للمراسلة فقط بعد أن يكون لديك إعادة معالجة آمنة ومراقبة للفشل.

خيارات عدم وجود رمز: Make و Zapier

في Make، استخدم Webhooks → Custom webhook لإنشاء استلام URL ولصقه في 7stamp الملف الشخصي. في Zapier استخدم Webhooks by Zapier → Catch Hook لنفس الغرض. يمتلك ملف التعريف 7stamp الاشتراك لأن API الحالي لا يكشف عن نقاط نهاية تسجيل خطاف الويب التلقائي.

عقد الأمان والتسليم

استخدم قسم Webhooks الخاص بمرجع OpenAPI العام كمصدر لمخطط الحمولة الصافية الحالي ومعنى الحقل. اطلب HTTPS، وأبعد جهاز الاستقبال URL عن السجلات العامة، واجعل المعالجة غير فعالة. قم بتأكيد إجراء مصادقة الطلب/signature لملفك الشخصي 7stamp أثناء الإعداد قبل فرض اسم رأس محدد أو سياسة إعادة المحاولة في الإنتاج.

الأسئلة المتداولة

هل يمكنني تحديد أحداث webhook معينة فقط؟

نعم. حدد أنواع الأحداث في إعدادات خطاف الويب الخاص بملف التعريف 7stamp حتى يحصل المتلقي فقط على الأحداث التي تهم سير العمل الخاص به.

كيف أقوم بتوصيل خطافات الويب بـ Make أو Zapier؟

أنشئ خطاف الويب المتلقي في Make أو Catch Hook في Zapier، انسخ خطاف الويب الذي تم إنشاؤه URL، ثم الصقه في إعدادات خطاف الويب الخاص بملف 7stamp وأرسل حدث اختبار.

كيف يمكنني مطابقة حدث ما مع جهة الاتصال CRM الخاصة بي؟

استخدم External ID وعند التواجد External Source. هذه هي المعرفات التي قدمها التكامل الخاص بك عند إنشاء البطاقة أو مسحها ضوئيًا.

هل يجب أن أفترض رأس التوقيع أم أعيد محاولة التوقيت؟

لا. استخدم عقد التسليم OpenAPI/profile الحالي وقم بتأكيد إجراء المصادقة لملفك الشخصي أثناء الإعداد قبل تشفير الرأس أو إعادة محاولة الافتراض.

الخطوة التالية

جاهز لإرسال حدث البطاقة الأول؟

أنشئ جهاز استقبال، والصق HTTPS URL في ملف التعريف، وقم بإجراء فحص يمكن التخلص منه، وتحقق من صحة المطابقة External ID قبل تمكين أتمتة المصب.