اتصالات أعمال أبسط
تطبيقات الهاتف والكمبيوترالمطورونحالة IllyVoIPمركز المساعدة
جميع الميزات

Webhooks

أحداث الخدمة. وإجراؤك التالي.

اربط أحداث المكالمات والرسائل وجهات الاتصال والبريد الصوتي بتطبيقك، بهياكل بيانات موثّقة وطلبات موقّعة وسجل للتسليم.

قراءة توثيق webhooksتعرّف على طريقة العمل

الأحداث التي
تحرّك سير عملك.

اختر فئة لاستعراض الأحداث الموثّقة حاليًا. هذه قائمة مرجعية وليست بثًا مباشرًا للأحداث.

call_initiated

تبدأ مكالمة.

call_ringing

تدخل المكالمة مرحلة الرنين.

call_answered

يُردّ على المكالمة.

call_completed

تنتهي المكالمة، وتُرفق مدتها النهائية.

كيف تعمل الخدمة

يقع الحدث.
فيستجيب تطبيقك.

ترسل IllyVoIP طلبات POST بصيغة JSON إلى نقطة الاستقبال التي تضبطها.

اختر اشتراكاتك

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

تحقّق قبل المعالجة

تحقّق من ترويسة Illyvoip-Signature باستخدام سر webhook والطابع الزمني ومحتوى الطلب الخام وفق التوثيق.

أكّد الاستلام ثم ضع العمل في الطابور

أعِد استجابة ناجحة 2xx بسرعة. ضع المهام الطويلة في طابور كي لا تؤخّر تأكيد التسليم.

تعامل مع تكرار التسليم

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

صمّم وفق ظروف
التسليم الفعلية.

تتضمن لوحة التحكم سجل التسليم، ويشرح توثيق API محتوى الطلبات والتوقيعات وآلية إعادة المحاولة.

افحص حالات الفشل
راجع حالة التسليم واستجابة HTTP ومعلومات الخطأ للتمييز بين مشكلة في الاستقبال ومشكلة في منطق تطبيقك.
افصل بيئات الرسائل
يمكن لنقطة الاستقبال تلقّي أحداث جميع معرّفات المرسل أو معرّفات محددة. تتلقى كل نقطة مطابقة الحدث؛ ولا تعيد التصفية إرسال الأحداث القديمة.
احتفظ بالأسرار على خادمك
تشمل إدارة webhooks نقاط الاستقبال والأسرار وسجلات التسليم للحساب كله. امنح هذه الصلاحية بعناية. قراءة مواصفات webhook الحالية

تفاصيل
تهمك.

اسأل فريقنا
هل يوجد webhook لكل إجراء في لوحة التحكم؟+

لا. استخدم قائمة الأحداث الموثّقة في API، واشترك فقط في الأحداث المتاحة لمسار عملك.

هل يمكن وصول الحدث نفسه أكثر من مرة؟+

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

ما حالات الفشل التي يُعاد إرسالها؟+

يذكر التوثيق الحالي أعطال الشبكة واستجابات HTTP 408 و429 و5xx ضمن الحالات القابلة لإعادة المحاولة. أما إعادة التوجيه واستجابات 4xx الأخرى فتوقف التسليم. راجع أحدث المواصفات قبل تنفيذ جهة الاستقبال.

اجعل الأحداث تدفع عملك إلى الأمام.

ابدأ بتوثيق الأحداث الحالي، ثم اضبط نقطة الاستقبال لديك.

قراءة توثيق webhooksتواصل مع فريقنا