Method: phones.dialogflowMessages.create

מנחה סוכן Dialogflow לשלוח הודעות באמצעות סוכן RCS לעסקים.

אם השילוב עם Dialogflow לא מופעל עבור סוכן בשירותי RCS לעסקים, השיטה הזו מחזירה 403 PERMISSION_DENIED.

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

אם intent ב-Dialogflow מגדיר כמה תשובות, פלטפורמת RCS לעסקים שולחת למשתמשים הודעה אחת לכל תשובה מוגדרת.

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

שדה תיאור

rbm_user_phone_number

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

rbm_share_location_response

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

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

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

פרמטרים
messageIdPrefix

string

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

string

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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