Method: phones.agentEvents.create

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

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

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

בקשת 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.