این سند توضیح می‌دهد که چگونه پلتفرم RCS برای کسب‌وکار، ارسال پیام و سایر تعاملات API را مدیریت می‌کند و بین عملیات همزمان و ناهمزمان تمایز قائل می‌شود.
تعاملات API RBM معمولاً از یک الگوی درخواست-پاسخ همزمان در سطح HTTP پیروی می کند. با این حال، نتایج بسیاری از تماس‌های API، به‌ویژه تحویل پیام، به‌صورت ناهمزمان از طریق webhookها انجام می‌شود. برای جزئیات بیشتر به بخش های زیر مراجعه کنید.
ارسال پیام: درخواست همزمان، تحویل ناهمزمان
درخواست API phones.agentMessages.create از دیدگاه API به صورت همزمان پردازش می شود. هنگامی که درخواست HTTP را به پلتفرم RCS for Business می‌کنید، سرور تقریباً بلافاصله با یک کد وضعیت استاندارد HTTP (مانند 200 OK یا یک خطا) پاسخ می‌دهد تا نشان دهد آیا درخواست دریافت شده و معتبر است یا خیر.
با این حال، تحویل واقعی پیام به کاربر نهایی به صورت ناهمزمان پردازش می‌شود. عوامل زیر می توانند بر این روند تأثیر بگذارند:
- وضعیت گیرنده : ممکن است کاربر آفلاین باشد، باتری آن خالی باشد یا RCS فعال نباشد.
- شرایط شبکه : مشکلات شبکه حامل می تواند تحویل پیام را به تأخیر بیندازد یا از آن جلوگیری کند.
پلتفرم RCS for Business به‌روزرسانی‌های وضعیت تحویل پیام (مانند رسید تحویل و رسید خواندن) را به‌صورت ناهمزمان از طریق وب‌قلاب‌ها ارائه می‌کند. بنابراین، در حالی که درخواست اولیه API همزمان است، برای ردیابی تحویل پیام باید به رویدادهای webhook ناهمزمان تکیه کنید. منتظر تایید فوری وضعیت تحویل از پاسخ phones.agentMessages.create نباشید.
سایر تعاملات RBM API
اکثر APIهای RBM مبتنی بر HTTP دیگر نیز با یک مدل درخواست پاسخ سنکرون کار می کنند. این API ها یک پاسخ فوری HTTP را ارائه می دهند که وضعیت درخواست (موفقیت یا خطا) را نشان می دهد. با این حال، در حالی که درخواست همزمان است، اقدامات ناشی از درخواست ممکن است شامل فرآیندهای ناهمزمان باشد. برای مثال، پاسخ موفقیت‌آمیز به تماس API برای به‌روزرسانی اطلاعات عامل به این معنا نیست که به‌روزرسانی فوراً در همه جا منعکس می‌شود. ممکن است یک تاخیر انتشار کوتاه وجود داشته باشد.
نقطه پایانی Webhook: رویدادهای ناهمزمان
رویدادهای زیر به صورت ناهمزمان به نقطه پایانی وب هوک شما تحویل داده می شوند:
- پیام‌های کاربر ورودی : پلتفرم RCS for Business، پیام‌های کاربر ورودی را به نقطه پایانی وب هوک شما هدایت می‌کند. حتما پیام های دریافتی را تأیید کنید .
- رسیدهای تحویل و خواندن : اعلان های تحویل پیام و وضعیت خواندن از طریق وب هوک ارسال می شود.
- رویدادهای مکالمه : برخی رویدادهای مربوط به مکالمه، مانند نشانگرهای تایپ، از طریق وبکهک ها ارسال می شوند.
- رویدادهای انقضا و ابطال پیام : پلتفرم RCS for Business رویدادها را برای تأیید اینکه آیا یک پیام منقضی شده با موفقیت لغو شده است ارسال می کند.