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 Overview.