انتقل إلى المحتوى
جرّب مجانًاENجرّب مجانًا

أبقِ أنظمتك المتصلة محدثة.

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

حدث موقّع يحدّث النظام المتصل

اجعل كل إجراء واضحًا وقابلًا للمراجعة.

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

  • اشترك بنقطة نهاية لتلقي الأحداث التي تهمك

  • يتم توقيع كل عملية تسليم لتتمكن من التحقق من أنها صادرة عنا

  • يتم احتساب حالات الفشل، مع تعطيل تلقائي لنقطة النهاية غير المستجيبة (المعطلة)

  • إصدار مفاتيح API مع تحديد نطاقات الصلاحية وإمكانية إلغائها عند الحاجة

ما الذي يبقي العمل منضبطًا

أحداث تحمل السياق اللازم

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

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

توقيع يمكن التحقق منه

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

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

تسجيل نقطة نهاية

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

احفظ مفتاح الأمان (السر)

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

التحقق واتخاذ الإجراء

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

مراقبة حالة التشغيل (الصحة)

يتم احتساب حالات الفشل لكل نقطة نهاية، وتُعطَّل نقطة النهاية التي تتكرر فيها حالات الفشل.

مفاتيح بصلاحيات محددة

تُنشأ المفاتيح داخل النشاط وتظهر كاملة مرة واحدة، ثم تُعرض بصورة مخفية ويمكن إلغاؤها فورًا.

  • إنشاء مفتاح مع تحديد نطاقات الصلاحية اللازمة له
  • عرض المفتاح بشكل مُقنّع مع توضيح وقت آخر استخدام له
  • إلغاء فوري للمفتاح عند الحاجة لإيقاف عمله
  • تسجيل عمليات إنشاء المفاتيح وإلغائها في سجل الأنشطة

واجهة API عامة كقدرة منفصلة, قريبًا

الوصول العام لقراءة وكتابة جهات الاتصال والمحادثات والرسائل والحملات قدرة قادمة، وليس جزءًا من Webhooks الحالية.

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

ما ينبغي معرفته

  • ترسل Webhooks الأحداث إلى أنظمتك، وليست وسيلة لإرسال الرسائل إلى داخل Otobiz.
  • لا يوجد تصدير واحد لكل بيانات النشاط؛ يغطي التصدير المباشر جهات الاتصال.

أسئلة يطرحها المشترون

ما الأحداث التي يمكن الاشتراك فيها؟

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

كيف أتحقق من عملية التسليم؟

احسب التوقيع على محتوى الطلب باستخدام السر الذي ظهر عند إنشاء نقطة النهاية، وقارنه قبل الوثوق بالحدث.

ماذا يحدث إذا تعطلت نقطة النهاية لدي؟

تُحسب حالات الفشل، وتُعطل النقطة بعد تكرارها. ويمكن إعادة تفعيلها بعد عودة الخدمة.

هل يمكن تدوير سر التوقيع؟

نعم. يمكن استبداله من دون حذف النقطة الطرفية أو اشتراكاتها.

المزيد من الأسئلة
هل توجد واجهة API عامة؟, قريبًا
Webhooks ترسل الأحداث المختارة إلى أنظمتك. أما API العامة فهي قدرة منفصلة قادمة.
هل ستتجاوز عمليات الإرسال عبر API متطلبات الموافقة؟
لا. تخضع أي عملية إرسال لنفس القواعد المتعلقة بالموافقة، وقوائم الحجب، ونافذة المحادثة، والحماية من التكرار، تماماً كما هو الحال عند إرسال رسالة عبر الواجهة.
هل ترتبط مفاتيح API بنطاقات صلاحية محددة؟
نعم. يحمل المفتاح نطاقات صلاحية محددة، ويظهر بشكل مُقنّع بعد إنشائه، كما يتم تسجيل تاريخ آخر استخدام له ويمكن إلغاؤه فوراً.
هل يمكنني تصدير البيانات بدلاً من ذلك؟
يمكن تصدير جهات الاتصال بصيغة CSV من حساب النشاط التجاري. أما للحصول على تدفق مستمر للبيانات، فإن استخدام خطافات الويب هو الخيار الأمثل.
هل قد أتلقى الحدث نفسه أكثر من مرة؟
نعم. يتم التسليم مرة واحدة على الأقل، وهو سلوك معتاد في Webhooks. استخدم معرّف الحدث لمنع تكرار المعالجة بأمان.

حوّل المحادثة التالية إلى خطوة واضحة.