Method: phones.agentMessages.create

שליחת הודעה מהנציג למשתמש.

כדי שהנציג יוכל לשלוח הודעה, המשתמש צריך להפעיל RCS ולאפשר לפלטפורמת RBM לגשת אליו. כשההודעה נשלחת בהצלחה, השיחה חוזרת ללא שגיאה. אחרת, הנציג יקבל קוד שגיאה.

אם המשתמש מחובר לאינטרנט, פלטפורמת RBM מעבירה את המסר באופן מיידי. אחרת, הפלטפורמה של RBM תכניס את ההודעה לתור ותעביר אותה בפעם הבאה שהמשתמש יתחבר לאינטרנט.

המערכת של פלטפורמת RBM מתעלמת מכל הודעה שנשלחת עם מזהה שהיה בשימוש בהודעה קודמת או באירוע שנשלחו מאותו נציג.

אפשר לבטל הודעות של נציגים מרגע שליחתן ועד למועד שבו הן נמסרות.

בקשת HTTP

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentMessages

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

'phones/{E.164}', כאשר {E.164} הוא מספר הטלפון של המשתמש בפורמט E.164. לדוגמה, במספר הטלפון בארה"ב +1-222-333-4444, הערך יהיה phones/+12223334444, ונקודת הקצה שתתקבל תהיה https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages.

פרמטרים של שאילתה

פרמטרים
messageId

string

המזהה הייחודי של ההודעה, שהוקצה על ידי הנציג. המזהה חייב להיות מזהה ייחודי אוניברסלי (UUID), כפי שמוגדר בכתובת https://tools.ietf.org/html/rfc4122. המערכת של פלטפורמת RBM מתעלמת מכל הודעה שנשלחת עם מזהה שהיה בשימוש בהודעה קודמת או באירוע שנשלחו מאותו נציג.
agentId

string

חובה. המזהה הייחודי של הנציג.

גוף הבקשה

גוף הבקשה מכיל מופע של AgentMessage.

גוף התגובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע חדש של AgentMessage שנוצר.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.