Method: phones.dialogflowMessages.create

تطلب من وكيل Dialogflow إرسال رسائل من خلال وكيل "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)".

إذا لم يتم تفعيل عملية دمج Dialogflow لوكيل "خدمات الاتصالات التفاعلية (RCS) للمؤسسات"، تعرض هذه الطريقة القيمة 403 PERMISSION_DENIED.

عند دمج وكيل "خدمات الاتصالات التفاعلية (RCS) للمؤسسات" مع وكيل Dialogflow، تؤدي هذه الطريقة إلى تشغيل حدث في وكيل Dialogflow. يعيد نظام RCS for Business الأساسي توجيه الردود من Dialogflow إلى جهاز المستخدم، كما يعيد توجيه الرسائل من المستخدم إلى وكيل Dialogflow.

إذا كان الغرض في Dialogflow يحدّد ردودًا متعددة، سترسل منصة "خدمات الاتصالات التفاعلية (RCS) للأنشطة التجارية" رسالة واحدة للمستخدمين لكل ردّ محدّد.

إذا اتصلت بخطاف ويب باستخدام التنفيذ في Dialogflow، سيتضمّن طلب التنفيذ المعلومات التالية في الحمولة:

الحقل الوصف

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

بادئة فريدة لمعرّفات رسائل "خدمات الاتصالات التفاعلية للمؤسسات" الناتجة عن حدث Dialogflow يتيح Dialogflow ردودًا متعدّدة لحدث معيّن. إذا أدى حدث ما إلى إطلاق ردود متعددة، ستعيد خدمة "رسائل RCS للأعمال" توجيه كل رد كرسالة منفصلة. يتشارك كل معرّف رسالة البادئة نفسها.
agentId

string

الحقل مطلوب. المعرّف الفريد للوكيل.

نص الطلب

يحتوي نص الطلب على مثال DialogflowEvent.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال تم إنشاؤه حديثًا DialogflowEvent.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.