Method: phones.dialogflowMessages.create

הצגת בקשה מנציג ב-Dialogflow לשלוח הודעות דרך נציג ב-RBM.

אם השילוב עם Dialogflow לא מופעל לנציג RBM, השיטה הזו מחזירה את הערך 403 PERMISSION_DENIED.

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

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

אם יוצרים קשר עם תגובה לפעולה מאתר אחר (webhook) באמצעות מילוי הזמנה ב-Dialogflow, בקשת מילוי הבקשה כוללת את הפרטים הבאים במטען הייעודי (payload):

שדה התיאור

rbm_user_phone_number

 מספר הטלפון של המשתמש.

rbm_share_location_response

 המיקום של המשתמש, אם הוא הקיש על הפעולה המוצעת של שיתוף המיקום.

בקשת HTTP

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

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

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

פרמטרים
parent

string

"phones/{E.164}", כאשר {E.164} הוא מספר הטלפון של המשתמש

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

פרמטרים
messageIdPrefix

string

קידומת ייחודית של מזהי הודעות ב-RBM שנוצרו מהאירוע Dialogflow. ב-Dialogflow יש תמיכה במספר תשובות לכל אירוע. אם אירוע מסוים גורם למספר תגובות, RBM מעבירה כל תגובה כהודעה נפרדת. לכל מזהה הודעה יש תחילית זהה.
agentId

string

חובה. המזהה הייחודי של הנציג.

גוף הבקשה

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

גוף התגובה

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

היקפי הרשאות

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

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

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.