ServerEvent

حدث وقع من جهة الخادم ومرتبط بمحادثة بين وكيل ومستخدم.

على سبيل المثال، إذا ضبط البوت مدة البقاء على قيد الحياة للرسالة وانتهت هذه المدة، سيتم تنشيط هذا الحدث لإشعار الشريك بأنّ مدة بقاء رسالة البوت قد انتهت.

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

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

string

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

string

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

string

معرّف رسالة RCS المرتبطة بالحدث
eventType

enum (ServerEvent.EventType)

نوع الحدث.
eventId

string

معرّف فريد للحدث يتم تعيينه لمثيل الحدث.
sendTime

string (Timestamp format)

الوقت الذي يرسل فيه الخادم الحدث.

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