Method: phones.agentEvents.create

يرسل هذا الإجراء حدثًا من الوكيل إلى المستخدم.

يمكن استخدام أحداث الوكيل للإشارة إلى أنّ الوكيل قد قرأ رسالة من المستخدم أو أنّ الوكيل بصدد كتابة رسالة (ما يضيف عنصرًا بشريًا إلى تجربة RCS for Business). إذا تعذّر على "خدمات الاتصالات التفاعلية للمؤسسات" الوصول إلى المستخدم، ستعرض منصة "خدمات الاتصالات التفاعلية للمؤسسات" الرمز 404 NOT_FOUND.

على عكس رسائل الوكيل، لا يمكن إبطال أحداث الوكيل بعد إرسالها.

طلب HTTP

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentEvents

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
parent

string

"phones/{E.164}"، حيث {E.164} هو رقم هاتف المستخدم بتنسيق E.164 على سبيل المثال، بالنسبة إلى مستخدم لديه رقم هاتف أمريكي ‎+1-222-333-4444، ستكون القيمة هي phones/+12223334444، وستكون نقطة النهاية الناتجة هي https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents.

مَعلمات طلب البحث

المعلمات
eventId

string

رقم تعريف الحدث الذي خصّصه الوكيل. يجب أن يكون هذا المعرّف معرّفًا فريدًا عالميًا (UUID)، كما هو محدّد في https://tools.ietf.org/html/rfc4122. تتجاهل منصة "خدمات الاتصالات التفاعلية (RCS) للأنشطة التجارية" أي رسالة وكيل تم إرسالها باستخدام رقم تعريف استُخدم في رسالة أو حدث سابق تم إرساله من الوكيل نفسه.
agentId

string

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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