UserMessage

رسالة أرسلها مستخدم إلى الوكيل

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

تمثيل JSON
{
  "senderPhoneNumber": string,
  "messageId": string,
  "sendTime": string,
  "agentId": string,
  "richMessageClassification": {
    object (RichMessageClassification)
  },
  "carrier": string,

  // Union field content can be only one of the following:
  "text": string,
  "userFile": {
    object (UserFile)
  },
  "location": {
    object (LatLng)
  },
  "suggestionResponse": {
    object (SuggestionResponse)
  }
  // End of list of possible types for union field content.
}
الحقول
senderPhoneNumber

string

رقم هاتف المستخدم الذي أرسل الرسالة (بتنسيق E.164)

messageId

string

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

sendTime

string (Timestamp format)

الوقت الذي تم فيه إرسال الرسالة

يستخدم المعيار 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) للمؤسسات".

richMessageClassification

object (RichMessageClassification)

تصنّف هذه السمة الرسالة وفقًا لنموذج الفوترة في الولايات المتحدة. للاطّلاع على تفاصيل كل نوع من أنواع التصنيف، يُرجى الرجوع إلى دليل نموذج الفوترة في الولايات المتحدة. لا تتمّ تعبئة هذا الحقل إلا لأرقام الهواتف في الولايات المتحدة.

carrier

string

النتائج فقط. معلومات مشغّل شبكة الجوّال الذي ينتمي إليه رقم هاتف المستخدم، وفقًا لأنظمة Google الخلفية لخدمات الاتصالات التفاعلية (RCS) في الوقت الحالي، تتم تعبئة هذا الحقل فقط لأرقام الهواتف في الولايات المتحدة.

حقل الدمج content يمكن أن يكون محتوى الرسالة content أحد الخيارات التالية فقط:
text

string

النص، وتحديدًا السلسلة التي يتم إنشاؤها من خلال الكتابة العادية من المستخدم وليس الرد المقترَح

userFile

object (UserFile)

ملف وسائط

location

object (LatLng)

الموقع الجغرافي. يُرجى العِلم أنّ هذا ليس بالضرورة الموقع الجغرافي للمستخدم. يمكن للمستخدم إرسال مواقع جغرافية عشوائية إلى أحد الوكلاء.

suggestionResponse

object (SuggestionResponse)

ردّ تم إنشاؤه من خلال نقر المستخدم على ردّ أو إجراء مقترَح.