שליחת הודעה מהנציג למשתמש.
כדי שהנציג יוכל לשלוח הודעה, המשתמש צריך להפעיל את RCS ולהיות נגיש לפלטפורמת RCS for Business. אחרת, הנציג מקבל קוד שגיאה 404.
אם המשתמש מחובר לאינטרנט, פלטפורמת RCS for Business מעבירה את ההודעה מיד. אחרת, פלטפורמת RCS for Business מעבירה את ההודעה לתור ושולחת אותה בפעם הבאה שהמשתמש מתחבר לאינטרנט.
פלטפורמת RCS for Business מתעלמת מכל הודעה של נציג שנשלחת עם מזהה שכבר שימש בהודעה או באירוע קודמים שנשלחו מאותו נציג.
אפשר לבטל הודעות של נציגים מרגע שהן נשלחות ועד שהן נמסרות.
בקשת HTTP
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentMessages
כתובת ה-URL כתובה בתחביר של gRPC Transcoding.
פרמטרים של הנתיב
| פרמטרים | |
|---|---|
parent |
"phones/{E.164}", כאשר {E.164} הוא מספר הטלפון של המשתמש בפורמט E.164. לדוגמה, אם מספר הטלפון בארה"ב הוא +1-222-333-4444, הערך יהיה phones/+12223334444, ונקודת הקצה שתתקבל תהיה https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages. |
פרמטרים של שאילתה
| פרמטרים | |
|---|---|
messageId |
חובה. המזהה הייחודי של ההודעה, שהוקצה על ידי הנציג. המזהה צריך להיות UUID, כמו שמוגדר בכתובת https://www.rfc-editor.org/info/rfc9562. פלטפורמת RCS for Business מתעלמת מכל הודעה של נציג שנשלחת עם מזהה ששימש הודעה או אירוע קודמים שנשלחו מאותו נציג. |
agentId |
חובה. המזהה הייחודי של הנציג. |
גוף הבקשה
גוף הבקשה מכיל מופע של AgentMessage.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של AgentMessage.
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/rcsbusinessmessaging
ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.