رسالة أرسلها مستخدم إلى الوكيل
تظهر UserMessage في حقل "البيانات" الخاص بعنصر "الرسالة" الذي يتلقّاه الوكيل من اشتراكه في Google Pub/Sub. حقل "البيانات" هو سلسلة بترميز base64 يجب أن يفكّ الوكيل ترميزها لتتطابق مع بنية UserMessage.
| تمثيل JSON |
|---|
{ "senderPhoneNumber": string, "messageId": string, "sendTime": string, "agentId": string, "richMessageClassification": { object ( |
| الحقول | |
|---|---|
senderPhoneNumber |
رقم هاتف المستخدم الذي أرسل الرسالة (بتنسيق E.164) |
messageId |
معرّف فريد للرسالة، يتم تعيينه من خلال تطبيق RCS الخاص بالمستخدم المُرسِل. |
sendTime |
الوقت الذي تم فيه إرسال الرسالة يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
agentId |
المعرّف الفريد للوكيل. يتم ضبطها من خلال "خدمات الاتصالات التفاعلية (RCS) للمؤسسات". |
richMessageClassification |
تصنّف هذه السمة الرسالة وفقًا لنموذج الفوترة في الولايات المتحدة. للاطّلاع على تفاصيل كل نوع من أنواع التصنيف، يُرجى الرجوع إلى دليل نموذج الفوترة في الولايات المتحدة. لا تتمّ تعبئة هذا الحقل إلا لأرقام الهواتف في الولايات المتحدة. |
carrier |
النتائج فقط. معلومات مشغّل شبكة الجوّال الذي ينتمي إليه رقم هاتف المستخدم، وفقًا لأنظمة Google الخلفية لخدمات الاتصالات التفاعلية (RCS) في الوقت الحالي، تتم تعبئة هذا الحقل فقط لأرقام الهواتف في الولايات المتحدة. |
حقل الدمج content يمكن أن يكون محتوى الرسالة content أحد الخيارات التالية فقط: |
|
text |
النص، وتحديدًا السلسلة التي يتم إنشاؤها من خلال الكتابة العادية من المستخدم وليس الرد المقترَح |
userFile |
ملف وسائط |
location |
الموقع الجغرافي. يُرجى العِلم أنّ هذا ليس بالضرورة الموقع الجغرافي للمستخدم. يمكن للمستخدم إرسال مواقع جغرافية عشوائية إلى أحد الوكلاء. |
suggestionResponse |
ردّ تم إنشاؤه من خلال نقر المستخدم على ردّ أو إجراء مقترَح. |