Method: phones.agentMessages.create

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

يجب أن يكون المستخدم قد فعّل خدمات الاتصالات التفاعلية (RCS) وأن يكون بإمكان منصة RCS for Business الوصول إليه لكي يتمكّن الوكيل من إرسال رسالة بنجاح. وفي حال عدم توفّرها، يتلقّى الوكيل رمز الخطأ 404.

إذا كان المستخدم متصلاً بالإنترنت، ترسل منصة "خدمات الاتصالات التفاعلية (RCS) للأنشطة التجارية" الرسالة على الفور. بخلاف ذلك، تضع منصة RCS for Business الرسالة في قائمة الانتظار وتسلّمها عندما يكون المستخدم متصلاً بالإنترنت في المرة التالية.

تتجاهل منصة "خدمات الاتصالات التفاعلية (RCS) للأنشطة التجارية" أي رسالة وكيل تم إرسالها باستخدام رقم تعريف استُخدم في رسالة أو حدث سابق تم إرساله من الوكيل نفسه.

يمكن إبطال رسائل الوكيل بين وقت إرسالها ووقت تسليمها.

طلب 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. تتجاهل منصة "خدمات الاتصالات التفاعلية (RCS) للأنشطة التجارية" أي رسالة وكيل تم إرسالها باستخدام رقم تعريف استُخدم في رسالة أو حدث سابق تم إرساله من الوكيل نفسه.
agentId

string

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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