يوضّح هذا المستند طريقة تعامل منصة RCS for Business مع إرسال الرسائل والتفاعلات الأخرى مع واجهة برمجة التطبيقات، مع التمييز بين العمليات المتزامنة وغير المتزامنة.
تتّبع تفاعلات RBM API بشكل عام نمطًا متزامنًا للطلبات والاستجابات على مستوى HTTP. ومع ذلك، تتم معالجة نتائج العديد من طلبات البيانات من واجهة برمجة التطبيقات، خاصةً تلك المتعلقة بتسليم الرسائل، بشكل غير متزامن من خلال خطافات الويب. يُرجى الرجوع إلى الأقسام التالية لمعرفة التفاصيل.
إرسال الرسائل: طلب متزامن، تسليم غير متزامن
تتم معالجة طلب البيانات من واجهة برمجة التطبيقات phones.agentMessages.createبشكل متزامن من منظور واجهة برمجة التطبيقات. عندما ترسل طلب HTTP إلى منصة "RCS للأعمال"، يستجيب الخادم على الفور تقريبًا باستخدام رمز حالة HTTP عادي (مثل 200 OK أو خطأ) للإشارة إلى ما إذا كان قد تم تلقّي الطلب وما إذا كان صالحًا.
ومع ذلك، تتم معالجة عملية تسليم الرسالة إلى المستخدم النهائي بشكل غير متزامن. يمكن أن تؤثّر العوامل التالية في هذه العملية:
- حالة المستلِم: قد يكون المستخدم غير متصل بالإنترنت أو تكون بطاريته فارغة أو لم يفعّل خدمات الاتصالات التفاعلية (RCS).
- ظروف الشبكة: يمكن أن تؤدي مشاكل شبكة مشغّل شبكة الجوّال إلى تأخير تسليم الرسائل أو منعه.
توفّر منصة "خدمات الاتصالات التفاعلية (RCS) للأنشطة التجارية" تحديثات لحالة تسليم الرسائل (مثل إيصالات التسليم وإيصالات الاستلام) بشكل غير متزامن من خلال خطافات الويب.
لذلك، على الرغم من أنّ طلب واجهة برمجة التطبيقات الأوّلي متزامن، عليك الاعتماد على الأحداث غير المتزامنة الخاصة بخطاف الويب لتتبُّع عملية تسليم الرسائل. لا تتوقّع الحصول على تأكيد فوري لحالة التسليم من الردّ phones.agentMessages.create.
تفاعلات أخرى مع واجهة برمجة تطبيقات RBM
تعمل معظم واجهات برمجة التطبيقات الأخرى المستندة إلى HTTP أيضًا باستخدام نموذج متزامن للطلب والاستجابة. تقدّم واجهات برمجة التطبيقات هذه استجابة HTTP فورية تشير إلى حالة الطلب (نجاح أو خطأ). ومع ذلك، على الرغم من أنّ الطلب متزامن، قد تتضمّن الإجراءات الناتجة عن الطلب عمليات غير متزامنة. على سبيل المثال، لا يعني الردّ الناجح على طلب بيانات من واجهة برمجة التطبيقات لتعديل معلومات الوكيل أنّ التعديل سيظهر على الفور في كل مكان، بل قد يكون هناك تأخير قصير في نشر التعديل.
نقطة نهاية الرد التلقائي على الويب: الأحداث غير المتزامنة
يتم تسليم الأحداث التالية بشكل غير متزامن إلى نقطة نهاية webhook:
- رسائل المستخدمين الواردة: يرسل النظام الأساسي لخدمات الاتصالات التفاعلية (RCS) للمؤسسات رسائل المستخدمين الواردة إلى نقطة نهاية برنامج الرد التلقائي على الويب. احرص على التحقّق من الرسائل الواردة.
- إشعارات التسليم والقراءة: يتم إرسال إشعارات تسليم الرسائل وحالة قراءتها من خلال خطافات الويب.
- أحداث المحادثة: يتم إرسال بعض الأحداث المرتبطة بالمحادثة، مثل مؤشرات الكتابة، من خلال خطافات الويب.
- أحداث انتهاء صلاحية الرسالة وإبطالها: ترسل منصة "خدمات الاتصالات التفاعلية للأنشطة التجارية" أحداثًا لتأكيد ما إذا تم إبطال رسالة منتهية الصلاحية بنجاح.