Method: phones.agentEvents.create

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

يمكن استخدام أحداث الوكيل للإشارة إلى أنّ الوكيل قد قرأ رسالة من المستخدم أو إلى أنّ الوكيل بصدد الكتابة (وهو ما يضيف عنصرًا بشريًا إلى تجربة RBM). إذا تعذّر على ميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية" (RBM) الوصول إلى المستخدم، ستعرض منصة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية" (RBM) 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، ستكون القيمة هي phone/+12223334444، وستكون نقطة النهاية الناتجة هي https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents.

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

المَعلمات
eventId

string

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

string

مطلوبة. المعرِّف الفريد للوكيل

نص الطلب

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

نص الاستجابة

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

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

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

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.