Method: phones.agentEvents.create

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

يمكن استخدام أحداث الوكيل للإشارة إلى أنّ الوكيل قد قرأ رسالة من المستخدم أو أنّه بصدد كتابة رسالة (ما يضيف لمسة إنسانية إلى تجربة RCS for Business). إذا لم تكن خدمة RCS مفعَّلة لدى المستخدم، ستعرض منصة RCS for Business الخطأ NOT_FOUND (HTTP 404). إذا كانت خدمات الاتصالات التفاعلية (RCS) مفعَّلة لدى المستخدم ولكن تعذّر الوصول إليه في الوقت الحالي، ستعرض المنصة الردّ 200 OK وستعالج عملية التسليم استنادًا إلى نوع الحدث. تتم إضافة أحداث الوكيل إلى قائمة انتظار التخزين وإعادة التوجيه لمدة تصل إلى 30 يومًا، ويتم تسليمها بعد اتصال المستخدم بالإنترنت مرة أخرى. أحداث IS_TYPING فقط هي أحداث مؤقتة ولا تتم إضافتها إلى قائمة الانتظار.

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

طلب 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://www.rfc-editor.org/info/rfc9562. تتجاهل منصة RCS for Business أي رسالة وكيل يتم إرسالها بمعرّف تم استخدامه في رسالة أو حدث سابقَين تم إرسالهما من الوكيل نفسه.
agentId

string

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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