Method: phones.agentEvents.create

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

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

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

בקשת HTTP

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

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

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

פרמטרים
parent

string

'phones/{E.164}', כאשר {E.164} הוא מספר הטלפון של המשתמש בפורמט E.164. לדוגמה, עבור משתמש עם מספר הטלפון בארה"ב +1-222-333-4444, הערך יהיה phones/+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.