במסמך הזה מוסבר איך פלטפורמת RCS לעסקים מטפלת בשליחת הודעות ובאינטראקציות אחרות עם ה-API, ומוצג ההבדל בין פעולות סינכרוניות לאסינכרוניות.
האינטראקציות עם RBM API בדרך כלל פועלות לפי דפוס סינכרוני של בקשה ותגובה ברמת ה-HTTP. עם זאת, התוצאות של הרבה קריאות ל-API, במיוחד מסירת הודעות, מטופלות באופן אסינכרוני באמצעות וווב-הוקס. בסעיפים הבאים יש מידע נוסף בנושא.
שליחת הודעה: בקשה סינכרונית, מסירה אסינכרונית
בקשת ה-API phones.agentMessages.create מעובדת באופן סינכרוני מנקודת המבט של ה-API. כששולחים בקשת HTTP לפלטפורמת RCS לעסקים, השרת מגיב כמעט מיד עם קוד סטטוס HTTP רגיל (כמו 200 OK או שגיאה) כדי לציין אם הבקשה התקבלה ותקינה.
עם זאת, המסירה בפועל של ההודעה למשתמש הקצה מתבצעת באופן אסינכרוני. הגורמים הבאים יכולים להשפיע על התהליך הזה:
- סטטוס הנמען: יכול להיות שהמשתמש לא מחובר לאינטרנט, שהסוללה שלו ריקה או ש-RCS לא מופעל אצלו.
- תנאי הרשת: בעיות ברשת של הספק עלולות לעכב את מסירת ההודעה או למנוע אותה.
פלטפורמת RCS for Business מספקת עדכונים על סטטוס מסירת ההודעות (כמו אישורי מסירה ואישורי קריאה) באופן אסינכרוני באמצעות webhooks.
לכן, למרות שבקשת ה-API הראשונית היא סינכרונית, כדאי להסתמך על אירועי webhook אסינכרוניים כדי לעקוב אחרי מסירת ההודעה. אל תצפו לקבל אישור מיידי על סטטוס המסירה מהתגובה של phones.agentMessages.create.
אינטראקציות אחרות עם RBM API
רוב ממשקי ה-API האחרים של RBM מבוססי-HTTP פועלים גם הם עם מודל סינכרוני של בקשה ותגובה. ממשקי ה-API האלה מספקים תגובת HTTP מיידית שמציינת את הסטטוס של הבקשה (הצלחה או שגיאה). עם זאת, למרות שהבקשה היא סנכרונית, הפעולות שנובעות מהבקשה עשויות לכלול תהליכים לא סנכרוניים. לדוגמה, תגובה מוצלחת לקריאת API לעדכון פרטי הסוכן לא אומרת שהעדכון ישתקף באופן מיידי בכל מקום. יכול להיות שיהיה עיכוב קצר בהפצה.
נקודת קצה של webhook: אירועים אסינכרוניים
האירועים הבאים מועברים באופן אסינכרוני לנקודת הקצה של ה-webhook:
- הודעות נכנסות ממשתמשים: פלטפורמת RCS for Business דוחפת הודעות נכנסות ממשתמשים לנקודת הקצה של ה-webhook. חשוב לאמת את ההודעות הנכנסות.
- אישורי מסירה וקריאה: התראות על מסירת ההודעה ועל סטטוס הקריאה נשלחות באמצעות Webhook.
- אירועים שקשורים לשיחות: חלק מהאירועים שקשורים לשיחות, כמו אינדיקטורים של הקלדה, נשלחים דרך ווּבְּהוּקים.
- אירועים של תפוגה וביטול של הודעות: פלטפורמת RCS for Business שולחת אירועים כדי לאשר שהודעה שתוקפה פג בוטלה בהצלחה.