Method: phones.agentMessages.create

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

برای اینکه اپراتور بتواند با موفقیت پیام ارسال کند، کاربر باید قابلیت RCS را فعال کرده و توسط پلتفرم RCS for Business قابل دسترسی باشد. در غیر این صورت، اپراتور کد خطای ۴۰۴ را دریافت می‌کند.

اگر کاربر آنلاین باشد، پلتفرم RCS for Business پیام را فوراً ارسال می‌کند. در غیر این صورت، پلتفرم RCS for Business پیام را در صف قرار می‌دهد و وقتی کاربر دوباره آنلاین شد، آن را ارسال می‌کند.

پلتفرم RCS for Business هر پیام عاملی که با شناسه‌ای ارسال شود که توسط پیام یا رویداد قبلی ارسال شده از همان عامل استفاده شده باشد را نادیده می‌گیرد.

پیام‌های عامل می‌توانند بین زمان ارسال و زمان تحویل، لغو شوند.

درخواست HTTP

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

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

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

پارامترها
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 تعریف شده است. پلتفرم RCS برای کسب و کار، هر پیام عاملی را که با شناسه‌ای ارسال شود که توسط پیام یا رویداد قبلی ارسال شده از همان عامل استفاده شده است، نادیده می‌گیرد.

agentId

string

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

درخواست بدنه

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

بدنه پاسخ

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

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

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

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

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