Method: phones.agentEvents.create

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

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

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

בקשת HTTP

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

כתובת ה-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/agentEvents.

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

פרמטרים
eventId

string

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

string

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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