لإرسال رسالة من الوكيل إلى مستخدم
يجب أن يكون المستخدم قد فعّل خدمات الاتصالات التفاعلية (RCS) وأن يكون من الممكن الوصول إليه من خلال منصة RCS for Business لكي يتمكّن الوكيل من إرسال رسالة بنجاح. وإلا، سيتلقّى الوكيل رمز الخطأ 404.
إذا كان المستخدم متصلاً بالإنترنت، ستسلّم منصة RCS for Business الرسالة على الفور. وإلا، ستضع منصة RCS for Business الرسالة في قائمة الانتظار وتسلّمها عندما يتصل المستخدم بالإنترنت في المرة التالية.
تتجاهل منصة RCS for Business أي رسالة وكيل يتم إرسالها بمعرّف تم استخدامه في رسالة أو حدث سابقَين تم إرسالهما من الوكيل نفسه.
يمكن إلغاء رسائل الوكيل بين وقت إرسالها ووقت تسليمها.
طلب HTTP
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentMessages
يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.
مَعلمات المسار
| المعلمات | |
|---|---|
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://www.rfc-editor.org/info/rfc9562. تتجاهل منصة RCS for Business أي رسالة وكيل يتم إرسالها باستخدام معرّف تم استخدامه في رسالة أو حدث سابقَين تم إرسالهما من الوكيل نفسه. |
agentId |
الحقل مطلوب. المعرّف الفريد للوكيل |
نص الطلب
يحتوي نص الطلب على مثال AgentMessage.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال تم إنشاؤه حديثًا لـ AgentMessage.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/rcsbusinessmessaging
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.