حين يعود عميل دائم، يكون برنامج الولاء أول من يعرف: المسح عند الكاونتر يسجّل الزيارة، وتتحدّث البطاقة في Apple Wallet أو Google Wallet لديه. والـ webhooks تجعل أنظمتك أنت تعرف ذلك أيضاً، في الثانية نفسها. نظام CRM، وحساباتك، والشاشة في المكتب الخلفي: كل منها يعلم بالزيارة والمكافأة والدفع ببطاقة الهدية دون أن ينسخ أحد رقماً بيده.
مسح واحد عند الكاونتر يضيف ختماً أو نقاطاً، وتتحدّث البطاقة على هاتف الزبون.
ما الـ webhook في برنامج الولاء؟
الـ webhook رسالة قصيرة يرسلها Fideliya إلى عنوان على خادمك أنت لحظة حدوث شيء في برنامجك. يضيف المطوّر لديك العنوان في لوحة تحكم Fideliya ويختار الأحداث التي يجب أن يتلقاها. ومنذ ذلك الحين، كلما وقع حدث منها، يرسله Fideliya إلى ذلك العنوان بصيغة JSON: ماذا حدث، ومتى، ولأي نشاط تجاري، ومع التفاصيل التي ترافقه.
لا يتغيّر شيء بالنسبة إلى عملائك. ينضمّون بمسح رمز QR عند الكاونتر وكتابة الاسم والبريد الإلكتروني، فتصل البطاقة إلى Apple Wallet أو Google Wallet، دون تطبيق يُنزَّل ولا حساب أو كلمة مرور تُنشأ. الـ webhooks تعمل بين Fideliya وأنظمتك.
كل الأحداث التي يرسلها Fideliya
هذه هي الأحداث العشرة، بالأسماء الدقيقة التي يشترك فيها المطوّر لديك.
| الحدث | متى يُرسل | ما يخبرك به |
|---|---|---|
customer.created | انضم عميل إلى إحدى بطاقاتك | من انضم: اسمه وبريده الإلكتروني ورقم هاتفه إن أعطاه، وأي بطاقة، وإلى أي محفظة ذهبت |
scan.recorded | مُسحت بطاقة عند الكاونتر: زيارة، أو نقاط، أو مكافأة مستخدمة أو مطالَب بها | أي عميل، وماذا فعل الكاونتر، والرصيد الجديد، والمكافآت الجاهزة، والكاونتر الذي حدث فيه المسح، والمبلغ المُدخل مع مسح النقاط |
scan.voided | أُلغي مسح عند الكاونتر خلال ثوانٍ منه لأنه كان خطأ | ما الذي أُلغي (زيارة، أو مكافأة مُنحت، أو مكافأة نقاط مطالَب بها، أو دفع ببطاقة هدية) والرصيد بعد الإلغاء |
milestone.reached | بلغ عميل مكافأة | من هو، واسم المكافأة، وعدد المكافآت التي بلغها على تلك البطاقة إجمالاً |
referral.completed | قام صديق مُحال بزيارته الأولى، فحصل كل منهما على مكافأته | من أحال من، والمكافأة التي حصل عليها كل منهما |
gift_card.sent | قُبل بريد بطاقة هدية للتسليم، عند إصدارها أو إعادة إرسالها | المستلم، والمبلغ، والرصيد، والعملة، وهل كان إعادة إرسال |
gift_card.spent | أُخذ مبلغ من بطاقة هدية، عند الكاونتر أو عبر الـ API | المبلغ المأخوذ، والرصيد المتبقي، والكاونتر، ومرجع جهاز الصندوق لديك حين يعطيه، وهل أخذه الماسح أم نظامك |
pass.created | أُنشئ تصميم بطاقة جديد | البطاقة، ونمطها، وهل هي بالأختام (الزيارات) أم بالنقاط، والهدف للوصول إلى المكافأة |
subscription.created | بدأ اشتراكك في Fideliya | الخطة، وحالتها، والفترة الحالية، وهل هي فترة تجريبية |
subscription.cancelled | أُلغي اشتراكك في Fideliya | متى أُلغي |
حدثا الاشتراك حدثان خاصان بالحساب: يتلقاهما كل عنوان في حسابك، أياً كان النشاط التجاري الذي يتبعه.
حدثان آخران سيصادفهما المطوّر
webhook.test هو ما يرسله زر الحدث التجريبي في لوحة التحكم: لا يأتي أبداً من إجراء حقيقي، فيستطيع المطوّر أن يتحقق من الاتصال دون عميل عند الكاونتر. أما webhook.ping ففحص يرسله Fideliya إلى عنوان اضطر إلى إيقافه مؤقتاً، ويكفي أن يرد خادمك عليه بنجاح.
أربعة أشياء تبنيها بالـ webhooks وأنظمتك الخاصة
لا يحتاج أي منها إلى شيء غير webhooks من Fideliya والأنظمة التي تستخدمها أصلاً.
- رسالة شكر من نظام CRM الخاص بك حين يبلغ عميل دائم مكافأة. احفظ كل
customer.createdفي نظامك تحت معرّف العميل. وحين يصلmilestone.reachedبالمعرّف نفسه واسم المكافأة، يرسل نظامك رسالة الشكر التي كتبتها، من عنوانك أنت. الرسالة وتوقيتها لك. - مبيعات بطاقات الهدايا تُطابَق وحدها. يحمل كل
gift_card.spentالمبلغ والرصيد المتبقي والكاونتر، ورقم الإيصال الخاص بجهاز الصندوق حين أخذ الدفع عبر الـ API. طابِقه مع إيصالات اليوم فيُغلق بند بطاقات الهدايا في حساباتك دون عدّ يدوي. والدفع الذي يُلغى عند الصندوق يأتي بعده على شكلscan.voided، فيدخل الإلغاء في السجل نفسه. - شاشة للمسح في كل فرع. يذكر
scan.recordedالكاونتر الذي جرى فيه كل مسح. اجمعها حسب الفرع على مدار اليوم، فتحصل على لوحة مباشرة تبيّن حال كل فرع، معscan.voidedالذي يحذف الأخطاء. - قائمة شكر لفريقك. يذكر
referral.completedالعميل الذي جاء بصديق. وقائمة في نظامك تخبر فريقك بمن يشكرونه شخصياً في زيارته التالية.
كيف يجري الإرسال
كل إرسال موقَّع بالسرّ الخاص بعنوانك، بصيغة Standard Webhooks، ليتحقق نظامك من أنه جاء من Fideliya قبل أن يثق به. ويحمل كل حدث معرّفاً يبقى هو نفسه في كل محاولة: احفظه، ولن تحسب الزيارة نفسها مرتين أبداً.
إذا كان خادمك متوقفاً أو ردّ بخطأ، يعيد Fideliya المحاولة على فترات متباعدة تمتد نحو يوم كامل. والعنوان الذي يستمر فشله أياماً يتوقف مؤقتاً. ثم يفحصه Fideliya بـ webhook.ping، وبعد ردّين ناجحين متتاليين يعيد تشغيله ويرسل إليه ما فاته.
أي خطة، ومن أين يبدأ المطوّر
تأتي الـ webhooks مع خطة Enterprise، ابتداءً من €99.99 في الشهر أو €79.99 في الشهر عند الدفع السنوي، ومعها الـ API من Fideliya، وعدد غير محدود من العملاء والفروع، و10 مقاعد للفريق. والمرجع الكامل، بكل حقل في كل حدث، ومثال لكل حدث، وملف JSON Schema الخاص به، موجود في وثائق الـ webhooks.
وإذا أردت أن يكتب جهاز الصندوق في برنامجك أيضاً، فيسجّل الزيارات ويأخذ الدفع ببطاقات الهدايا، فهذا دور الـ API: ما يغيّره لصاحب النشاط تجده في ما يغيّره API عام في برنامج ولاء صغير، والنسخة المختصرة في ربط Fideliya بجهاز الصندوق. وكل الخطط والأسعار في صفحة الأسعار.