Method: phones.agentMessages.create

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

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

اگر کاربر آنلاین باشد، پلت فرم 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 مراجعه کنید.