Method: phones.agentMessages.create

إرسال رسالة من موظّف الدعم إلى مستخدم

يجب أن يكون لدى المستخدم خدمة RCS مفعَّلة وأن تكون منصة RBM قادرة على التواصل معه لكي يتمكّن موظّف الدعم من إرسال رسالة بنجاح. بخلاف ذلك، يتلقّى موظّف الدعم رمز الخطأ 404.

إذا كان المستخدم متصلاً بالإنترنت، تُرسِل منصة RBM الرسالة على الفور. وبخلاف ذلك، تضع منصة RBM الرسالة في "قائمة الانتظار" وتُرسِلها عندما يكون المستخدم متصلاً بالإنترنت في المرة التالية.

تتجاهل منصة RBM أي رسالة مرسَلة من موظّف الدعم باستخدام معرّف سبق أن تم استخدامه في رسالة أو حدث سابقَين تم إرسالهما من موظّف الدعم نفسه.

يمكن إلغاء رسائل موظّفي الدعم بين وقت إرسالها ووقت تسليمها.

طلب 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://tools.ietf.org/html/rfc4122. تتجاهل منصة RBM أي رسالة مرسَلة من موظّف الدعم باستخدام معرّف سبق أن تم استخدامه في رسالة أو حدث سابقَين تم إرسالهما من موظّف الدعم نفسه.
agentId

string

مطلوب. المعرّف الفريد للموظف

نص الطلب

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

نص الاستجابة

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

نطاقات التفويض

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

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

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