Method: phones.agentMessages.create

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

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

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

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

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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 Overview.