نظام متصل

Webhooks

الاتجاه المعاكس: أن يخبركم النظام حين يحدث شيء بدل أن تسألوه. وهذا ما يجعل الإشعار الاستباقي ممكناً.

عربي وإنجليزيإجابات مُسنَدةتحويل إلى موظف

الاتجاه المعاكس: أن يخبركم النظام حين يحدث شيء بدل أن تسألوه. وهذا ما يجعل الإشعار الاستباقي ممكناً.

ماذا يحمل إشعار الـ webhook، ولماذا يهمّ ذلك هنا

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

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

والقاعدة المهمة هنا أن الإشعار الاستباقي يحتاج انضباطاً في التكرار. النظام الذي يرسل كثيراً يُتجاهل، والذي يرسل ما لا يهمّ يُقرأ إزعاجاً.

  • الأحداث المحددة — ما تسمحون بإرساله صراحة.
  • التوقيت — الإشعار لحظة الحدث لا بعد ساعات.
  • الحدود — انضباط في التكرار حتى لا يُتجاهل.
  • التحقق — التأكد من أن الإشعار من مصدره فعلاً.
  • سياسة الفشل — ماذا يحدث حين لا يصل الإشعار.

أسئلة يجيب عنها Elbi قبل أن تُطرح

هل تغيّرت حالة طلبي؟

إشعار لحظة التغيير بدل انتظار السؤال.

هل تأخرت شحنتي؟

إخبار استباقي — أعلى بند عائداً في هذا النمط.

هل وصل السداد؟

تأكيد لحظة التسجيل.

هل هناك عطل؟

إشعار عن الحالة المعلنة.

هل رُدّ على تذكرتي؟

إشعار بالرد الجديد.

هل اقترب موعدي؟

تذكير مسبق بحسب ما تحدّدونه.

كيف يستقبل Elbi الـ webhook ويتصرف بناءً عليه

  1. نظامكم يرسل الحدثحين يقع شيء، كشحن طلب أو تغيّر حالة قضية، يرسل النظام المصدر طلب HTTPS POST إلى نقطة استقبال مخصّصة لتشغيلكم. ويذكر محتوى الطلب نوع الحدث والسجل الذي يخصّه ووقت وقوعه.
  2. التوقيع يُفحص قبل أي شيءيحمل كل إرسال توقيعاً، هو في الغالب رمز HMAC محسوب على المحتوى الخام بسرّ يولّده فريقكم، ومعه عادة طابع زمني يمنع إعادة استخدام رسالة قديمة. وأي إرسال يفشل في هذا الفحص يُرفض ولا يصل إلى أي عميل.
  3. تأكيد الاستلام سريعاً ثم المعالجةيُؤكَّد استلام الحدث الصحيح فوراً، ثم يُعالَج بعد إرسال الرد. فالأنظمة المرسلة تعدّ الرد البطيء أو الفاشل سبباً لإعادة المحاولة، والتأكيد السريع يمنع تراكم إرسالات مكررة.
  4. التكرار واختلال الترتيب متوقعانإعادة المحاولة تعني أن الحدث نفسه قد يصل مرتين، والأحداث لا تصل دائماً بترتيب وقوعها. ولذلك يُسجَّل معرّف كل حدث فيُتجاهل المكرر، وتُقارن الطوابع الزمنية فلا تصل رسالة «شُحن طلبك» بعد رسالة «تم التسليم».
  5. حدث خفيف وتفاصيل حيّةحيث يسمح المصدر، لا يحمل الحدث إلا نوعه ومرجعاً، ثم يقرأ Elbi التفاصيل الحالية باستعلام محدود النطاق قبل أن يقول شيئاً. فتعكس الرسالة السجل كما هو الآن، وتقلّ البيانات الشخصية التي تنتقل داخل الإشعار.
  6. لا تخرج إلا الرسائل المتفق عليها والموافَق عليهالا يتحول الحدث إلى رسالة إلا إذا كان نوعه في القائمة المتفق عليها، وكان العميل قد وافق على هذا النوع من التواصل، وبلغته المسجّلة. والأحداث التي تحتاج تقديراً، كتعثّر سداد، يمكن أن تذهب إلى موظف بدلاً من ذلك.

أمان الـ webhook وتسليمه، وما يبقى بأيديكم

الاتجاه هنا وارد فقط: نظامكم هو من يقرر أي الأحداث يرسل. وأنواع الأحداث غير المدرجة في القائمة المتفق عليها تُتجاهل، وأي استعلام يُجرى رداً على حدث يستخدم بيانات دخول منفصلة للقراءة فقط.

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

وسرّ التوقيع يُولَّد من جهتكم، ويمكن تغييره أو إلغاؤه متى شئتم. وتعطيل الـ webhook في نظامكم يوقف التدفق من مصدره، دون الرجوع إلينا.

ومحتوى الحدث يُستخدم لتقرير إرسال الرسالة وصياغتها، لا لبناء نسخة من سجلاتكم. ومحتوى الرسائل يُتلف خلال 24 ساعة، ولا تطّلع عليه أي خدمة ذكاء اصطناعي خارجية.

ويُسجَّل كل إرسال بمعرّفه ونوعه ونتيجة فحص توقيعه والرسالة التي أُرسلت بسببه إن وُجدت، فيمكن الإجابة لاحقاً عن سؤال «لماذا وصلت هذه الرسالة إلى هذا العميل؟». وإن تعذّر الوصول إلى نقطة الاستقبال لفترة قصيرة غطّت محاولات نظامكم المتكررة الفجوة، والحدث الذي لا تمكن معالجته يُسجَّل فاشلاً ولا يضيع بصمت.

ما الذي يحلّ محلّه هذا

ما يحلّ محلّه هذا هو الاستفسار المتكرر عن الشيء نفسه. العميل الذي لا يعرف حالة طلبه يسأل، ثم يسأل بعد ساعات، ثم يتصل. ثلاث محادثات عن حدث واحد.

والسبب ليس نفاد الصبر بل غياب المعلومة. والشخص الذي يُخبَر بالتغيير حين يحدث لا يسأل عنه أصلاً.

وهذا يجعل الإشعار الاستباقي من أعلى البنود عائداً في قطاعات مثل الخدمات اللوجستية والاتصالات — أرخص من الرد على السؤال، وأفضل في التجربة.

أين تثبت إشعارات الـ webhook جدواها

الخدمات اللوجستية

التأخير المُبلَّغ عنه يمنع موجة اتصالات.

التجارة الإلكترونية

تغيّر حالة الطلب.

الاتصالات

الأعطال المعلنة.

المالية

تأكيد السداد لحظة تسجيله.

الخدمة

الرد على التذاكر.

الصحة

تذكير المواعيد.

كيف تستفيدون من الـ webhooks

اختاروا الأحداث التي يلاحقها الناس اليوم. أفضل webhook تبدؤون به هو الذي يجيب عن سؤال يكرره العملاء أصلاً: شُحن الطلب، وصل السداد، انتقل الطلب إلى المرحلة التالية. وإن لم يكن أحد يسأل عن حدث ما اليوم، فالإشعار به لن يكون مرحّباً به على الأرجح.

ابدأوا بنوع حدث واحد من نظام واحد، وقيسوا الاستفسارات التي كان يُفترض أن يزيلها، ثم أضيفوا التالي. والاشتراك في كل حدث تتيحه المنصة مغرٍ، لكن أغلب تلك الأحداث تصف خطوات داخلية لا يفهمها العملاء ولا تعنيهم.

واقرنوا كل إشعار بإجابة. حين يردّ شخص على رسالة «حُدّثت قضيتك»، ينبغي أن يستطيع Elbi قراءة القضية وشرح التحديث، ولهذا تعمل الـ webhooks أفضل ما تعمل إلى جانب اتصال قراءة بالنظام نفسه.

ما الذي يتطلبه ربط webhook

  1. اختيار الأحداث والصياغةقائمة بأنواع الأحداث التي تُنتج رسالة، ومن يتلقى كلاً منها، والصياغة العربية والإنجليزية. والأحداث الموجّهة إلى الموظفين لا العملاء تُدرج في قائمة مستقلة.
  2. تسجيل نقطة الاستقبال وتوليد السرّيسجّل فريقكم نقطة الاستقبال في إعدادات الـ webhook في النظام المصدر، عبر HTTPS، ويولّد سرّ التوقيع هناك. وحيث يدعم المصدر ذلك، يمكن إضافة قائمة عناوين IP مسموحة أو TLS متبادل.
  3. الاتفاق على المحتوىهل يحمل كل حدث التفاصيل كاملة أم مرجعاً فقط يُستعلم عنه، وأي الحقول تحدّد العميل والسجل. والمحتوى الأصغر أسهل في الدفاع عنه.
  4. ربط الموافقة باللغةيُربط كل نوع إشعار بالموافقة التي يعتمد عليها وباللغة المسجّلة للعميل، فلا يصل شيء إلى من لم يوافق عليه.
  5. اختبار الإعادة والتكرار والتوقيع الخاطئأعيدوا إرسال الحدث نفسه، وأرسلوا أحداثاً بغير ترتيبها، وأرسلوا حدثاً بتوقيع خاطئ، وأوقفوا نقطة الاستقبال لتروا المصدر يعيد المحاولة. يجب أن يكون السلوك متوقعاً في كل حالة قبل أن يُشارك أي عميل حقيقي.
  6. الإطلاق بحدث واحد ثم الإضافةشغّلوا نوع حدث واحداً لمدة شهر، وراجعوا الاستفسارات التي أزالها وطلبات الإيقاف التي تسبب بها، ثم وسّعوا.

البيانات الشخصية داخل محتوى الـ webhook

محتوى الـ webhook بيانات شخصية أثناء انتقالها: حدث الطلب قد يحمل اسماً ورقم جوال وعنواناً، وحدث السداد أكثر من ذلك. وبموجب نظام حماية البيانات الشخصية يُعدّ إرساله إلى Elbi إفصاحاً ينبغي أن تغطيه سجلاتكم، وأبسط طريقة لجعله قابلاً للدفاع عنه أن تُرسلوا أقل: نوع الحدث ومرجعاً، وتُقرأ التفاصيل فقط حين تحتاجها رسالة.

والتواصل الاستباقي يحتاج موافقة خاصة به، منفصلة عن الموافقة على الإجابة عن الأسئلة، وطريقة سهلة لإيقافه. وبعد إرسال الرسالة، يُتلف محتوى المحادثة التي تليها خلال 24 ساعة.

وأسئلة المراجعة الأربعة لها هنا إجابات قصيرة: ما يُقرأ: الأحداث المدرجة وحدها. ومن يراه: صاحب السجل. وأين يذهب: لا يتجاوز الرسالة نفسها. وكم يبقى: لا أكثر من 24 ساعة.

بدائل الـ webhooks، ومتى يناسب كلٌّ منها

الـ webhooks هي المدخل الصحيح حين يستطيع النظام المصدر إرسالها، ويكون الحدث شيئاً ينتظره شخص ما. وأغلب منصات SaaS الحديثة توفرها، وكثير من خدمات الدفع والتوصيل تعتمد عليها طريقةً رئيسية للإبلاغ عمّا حدث.

وحين لا يستطيع النظام إرسالها، يكون البديل هو الاستطلاع الدوري: التحقق على فترات من السجلات التي تغيّرت. وهو أبسط إعداداً لكنه أبطأ في الالتقاط وأثقل على المصدر، فيناسب الأحداث قليلة العدد. وفي المؤسسات الكبيرة تمرّ الأحداث غالباً عبر وسيط رسائل أو منصة بثّ أحداث، والاشتراك هناك قد يكون أنظف من إضافة webhook إلى كل نظام. وبعض الإشعارات يُترك أفضل للنظام المصدر نفسه، عبر الرسائل النصية أو البريد، حيث يرسلها أصلاً بشكل موثوق.

وأياً كانت الآلية، فالإخفاق الشائع هو الكثرة. المساعد الذي يراسل الناس كثيراً يُكتم، وبعدها لا يستطيع الوصول إليهم حين يهمّ الأمر.

ما الذي تراه المؤسسات عادة

1
حدث واحد مُبلَّغ به يغني عن أكثر الاستفسارات تكراراً
0
نسخ ثانية من سجلاتكم تُبنى من محتوى الأحداث
2
لغتان يُصاغ بهما الإشعار من الحدث نفسه
4
أسئلة حوكمة عن الإشعارات تُجهَّز إجاباتها قبل المراجعة

أسئلة متكررة

لا. الأحداث تُحدَّد صراحة، والانضباط في التكرار شرط: النظام الذي يرسل كثيراً يُتجاهل تماماً.

التحقق من المصدر جزء أساسي من التصميم لا إضافة عليه.

سياسة الفشل تُحدَّد مسبقاً. والاعتماد على وصول الإشعار وحده دون بديل مخاطرة معروفة.

ينبغي ذلك، وهو مطلب في أنظمة حماية البيانات أيضاً لا مجرد لباقة.

بلغة العميل المسجّلة. والإشعار بلغة لا يقرأها المستقبل معلومة لم تصل.

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

حوّلوا أحداث أنظمتكم إلى رسائل في وقتها

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