Method: phones.agentEvents.create

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

يمكن استخدام أحداث الوكيل للإشارة إلى أنّ الوكيل قد قرأ رسالة من المستخدم أو أنّ الوكيل بصدد كتابة رسالة (ما يضيف عنصرًا بشريًا إلى تجربة RCS for Business). إذا لم يفعّل المستخدم خدمة RCS، ستعرض منصة "RCS للأنشطة التجارية" الخطأ 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://tools.ietf.org/html/rfc4122. تتجاهل منصة "خدمات الاتصالات التفاعلية (RCS) للأنشطة التجارية" أي رسالة وكيل تم إرسالها باستخدام رقم تعريف استُخدم في رسالة أو حدث سابق تم إرساله من الوكيل نفسه.
agentId

string

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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