Method: phones.agentMessages.create

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

כדי שהנציג יוכל לשלוח הודעה, המשתמש צריך להיות מחובר ל-RCS ולהיות זמין בפלטפורמת RCS for Business. אחרת, הסוכן מקבל קוד שגיאה 404.

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

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

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

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
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. פלטפורמת RCS for Business מתעלמת מכל הודעה של נציג שנשלחת עם מזהה ששימש הודעה או אירוע קודמים שנשלחו מאותו נציג.
agentId

string

חובה. המזהה הייחודי של הסוכן.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.