Method: phones.agentMessages.create

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

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

وإذا كان المستخدم متصلاً بالإنترنت، تعمل منصة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" على تسليم الرسالة على الفور. وإلا، يضع نظام 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، ستكون القيمة هي phone/+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.