Method: phones.agentMessages.create

پیامی را از نماینده به کاربر ارسال می کند.

کاربر باید RCS را فعال کرده و توسط پلتفرم RBM قابل دسترسی باشد تا نماینده بتواند با موفقیت پیامی ارسال کند. در غیر این صورت، عامل کد خطای 404 را دریافت می کند.

اگر کاربر آنلاین باشد، پلت فرم RBM بلافاصله پیام را ارائه می دهد. در غیر این صورت، پلت فرم RBM پیام را در صف قرار می دهد و زمانی که کاربر آنلاین است، آن را تحویل می دهد.

پلتفرم RBM هر پیام عاملی را که با شناسه ارسال شده توسط پیام یا رویداد قبلی ارسال شده از همان عامل استفاده شده است، نادیده می گیرد.

پیام‌های نماینده را می‌توان بین زمان ارسال تا زمان تحویل باطل کرد.

درخواست HTTP

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

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/agentMessages خواهد بود.

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

پارامترها
messageId

string

مورد نیاز. شناسه منحصربفرد پیام که توسط نماینده اختصاص داده شده است. این باید یک UUID باشد، همانطور که در https://tools.ietf.org/html/rfc4122 تعریف شده است. پلتفرم RBM هر پیام عاملی را که با شناسه ارسال شده توسط پیام یا رویداد قبلی ارسال شده از همان عامل استفاده شده است، نادیده می گیرد.

agentId

string

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

درخواست بدن

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

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه جدید از AgentMessage است.

محدوده مجوز

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

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

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