پیامی را از نماینده به کاربر ارسال می کند.
کاربر باید RCS را فعال کرده و توسط پلتفرم RBM قابل دسترسی باشد تا نماینده بتواند با موفقیت پیامی ارسال کند. هنگامی که پیام با موفقیت ارسال شد، تماس بدون خطا برمی گردد. در غیر این صورت، عامل یک کد خطا دریافت می کند.
اگر کاربر آنلاین باشد، پلت فرم RBM بلافاصله پیام را ارائه می دهد. در غیر این صورت، پلت فرم RBM پیام را در صف قرار می دهد و زمانی که کاربر آنلاین است، آن را تحویل می دهد.
پلتفرم RBM هر پیام عاملی را که با شناسه ارسال شده توسط پیام یا رویداد قبلی ارسال شده از همان عامل استفاده شده است، نادیده می گیرد.
پیامهای نماینده را میتوان بین زمان ارسال و زمان تحویل باطل کرد.
درخواست HTTP
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentMessages
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
parent | "phones/{E.164}"، که در آن {E.164} شماره تلفن کاربر در قالب E.164 است. برای مثال، با شماره تلفن ایالات متحده +1-222-333-4444، مقدار phones/+12223334444 خواهد بود و نقطه پایانی حاصل https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages خواهد بود. . |
پارامترهای پرس و جو
مولفه های | |
---|---|
messageId | شناسه منحصربفرد پیام که توسط نماینده اختصاص داده شده است. این باید یک UUID باشد، همانطور که در https://tools.ietf.org/html/rfc4122 تعریف شده است. پلتفرم RBM هر پیام عاملی را که با شناسه ارسال شده توسط پیام یا رویداد قبلی ارسال شده از همان عامل استفاده شده است، نادیده می گیرد. |
agentId | ضروری. شناسه منحصر به فرد عامل. |
درخواست بدن
بدنه درخواست شامل یک نمونه از AgentMessage
است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه جدید از AgentMessage
است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/rcsbusinessmessaging
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.