UserEvent

حدث وقع على جهاز المستخدم الذي يستخدم خدمات الاتصالات التفاعلية (RCS) وكان مرتبطًا بمحادثة مع الوكيل

على سبيل المثال، يمكن أن يشير الحدث إلى أنّ المستخدم يكتب أو أنّه قرأ رسالة سابقة من الموظف.

يظهر UserEvent في حقل "البيانات" الخاص بعنصر "الرسالة" الذي يتلقّاه الوكيل من اشتراكه في Google Pub/Sub. الحقل "data" هو سلسلة مرمّزة بترميز base64 يجب أن يفكّ الوكيل ترميزها لتتطابق مع بنية UserEvent.

تمثيل JSON 
{
  "senderPhoneNumber": string,
  "eventType": enum (UserEvent.EventType),
  "eventId": string,
  "messageId": string,
  "sendTime": string,
  "agentId": string
}
الحقول
senderPhoneNumber

string

رقم هاتف المستخدم المعنيّ بالحدث (بتنسيق E.164)
eventType

enum (UserEvent.EventType)

نوع الحدث.
eventId

string

معرّف حدث فريد، يتم تعيينه من خلال تطبيق RCS الخاص بالمستخدم المُرسِل.
messageId

string

معرّف الرسالة المرتبطة بالحدث. على سبيل المثال، رسالة تم تسليمها إلى برنامج RCS الخاص بالمستخدم أو قرأها المستخدم. يتم ملء هذا الحقل لحدثَي DELIVERED وREAD.
sendTime

string (Timestamp format)

الوقت الذي يرسل فيه برنامج RCS الحدث

يستخدم هذا النوع RFC 3339، حيث سيكون الناتج الذي يتم إنشاؤه دائمًا عاديًا وموحّدًا حسب المنطقة الزمنية Z، وسيستخدم 0 أو 3 أو 6 أو 9 أرقام كسرية. يتم أيضًا قبول الإزاحات غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
agentId

string

المعرّف الفريد للوكيل. يتم ضبطها من خلال ميزة "الرسائل من الشركات من RCS".