Method: phones.agentMessages.create

لإرسال رسالة من الوكيل إلى مستخدم

يجب أن يكون المستخدم قد فعّل خدمات الاتصالات التفاعلية (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

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://www.rfc-editor.org/info/rfc9562. تتجاهل منصة RCS for Business أي رسالة وكيل يتم إرسالها باستخدام معرّف تم استخدامه في رسالة أو حدث سابقَين تم إرسالهما من الوكيل نفسه.

agentId

string

الحقل مطلوب. المعرّف الفريد للوكيل

نص الطلب

يحتوي نص الطلب على مثال AgentMessage.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال تم إنشاؤه حديثًا لـ AgentMessage.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.