Method: phones.dialogflowMessages.create

به یک عامل Dialogflow دستور می‌دهد تا پیام‌ها را از طریق یک عامل RCS برای کسب‌وکار ارسال کند.

اگر ادغام Dialogflow برای یک عامل RCS برای کسب و کار فعال نباشد، این متد خطای 403 PERMISSION_DENIED را برمی‌گرداند.

وقتی یک عامل RCS برای کسب‌وکار با یک عامل Dialogflow ادغام می‌شود، این روش رویدادی را در عامل Dialogflow فعال می‌کند. پلتفرم RCS برای کسب‌وکار، پاسخ‌ها را از Dialogflow به دستگاه کاربر هدایت می‌کند و پیام‌ها را از کاربر به عامل Dialogflow برمی‌گرداند.

اگر یک هدف Dialogflow چندین پاسخ را تعریف کند، پلتفرم RCS for Business برای هر پاسخ تعریف شده یک پیام برای کاربران ارسال می‌کند.

اگر با استفاده از Dialogflow با یک وب‌هوک تماس بگیرید، درخواست انجام درخواست شامل اطلاعات زیر در payload است:

میدان توضیحات

rbm_user_phone_number

 شماره تلفن کاربر.

rbm_share_location_response

 موقعیت مکانی کاربر، در صورتی که روی اقدام پیشنهادی اشتراک‌گذاری موقعیت مکانی ضربه زده باشد.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
parent

string

"phones/{E.164}"، که در آن {E.164} شماره تلفن کاربر است

پارامترهای پرس و جو

پارامترها
messageIdPrefix

string

پیشوند منحصر به فرد شناسه‌های پیام RCS برای کسب‌وکار که از رویداد Dialogflow حاصل می‌شوند. Dialogflow از چندین پاسخ برای یک رویداد خاص پشتیبانی می‌کند. اگر یک رویداد چندین پاسخ را ایجاد کند، RCS برای کسب‌وکار هر پاسخ را به عنوان یک پیام جداگانه ارسال می‌کند. هر شناسه پیام، پیشوند یکسانی دارد.

agentId

string

الزامی. شناسه منحصر به فرد عامل.

درخواست بدنه

بدنه درخواست شامل نمونه‌ای از DialogflowEvent است.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل یک نمونه تازه ایجاد شده از DialogflowEvent است.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .