Method: phones.agentEvents.create

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

אפשר להשתמש באירועים של הנציג כדי לציין שהנציג קרא הודעה מהמשתמש או שהוא נמצא בתהליך הקלדה (המשמעות היא שמוסיף רכיב אנושי לחוויה של RBM). אם ל-RBM לא תהיה אפשרות להגיע למשתמש, פלטפורמת RBM תחזיר את הערך 404 NOT_FOUND.

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

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

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

פרמטרים
eventId

string

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

string

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.