REST Resource: phones.agentMessages

{
  "name": string,
  "sendTime": string,
  "contentMessage": {
    object (AgentContentMessage)
  },

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}

string

השדה הזה מוגדר על ידי הפלטפורמה של RBM. חשוב לא לכלול אותה כשיוצרים הודעה לנציג תמיכה. הערך בשדה יהיה 'phones/{E.164}/agentMessages/{messageId}', כאשר {E.164} הוא מספר הטלפון של המשתמש בפורמט E.164 ו-{messageId} הוא המזהה שהוקצה על ידי הסוכן של ההודעה לנציג.

string (Timestamp format)

השדה הזה מוגדר על ידי הפלטפורמה של RBM. חשוב לא לכלול אותה כשיוצרים הודעה לנציג תמיכה. השדה הזה מציין את השעה שבה ההודעה נשלחת למשתמש.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

object (AgentContentMessage)

תוכן ההודעה של הנציג.

string (Timestamp format)

זה שינוי אופציונלי. חותמת הזמן לפי שעון UTC שמציינת שהתוקף של המשאב הזה פג. הערך הזה מופיע בפלט אם הוא מוגדר או אם השדה TTL מוגדר.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

string (Duration format)

זה שינוי אופציונלי. קלט בלבד. משך הזמן שבו ההודעה תוצג עד שהיא תבוטל באופן אוטומטי.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

{
  "suggestions": [
    {
      object (Suggestion)
    }
  ],

  // Union field content can be only one of the following:
  "text": string,
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "richCard": {
    object (RichCard)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}

object (Suggestion)

רשימה של הצעות לתשובות והצעות לפעולות שמופיעות כרשימה של צ'יפים של הצעות אחרי ההודעה של הנציג הרלוונטי. עד 11 הצעות.

הצ'יפים מוצגים רק כשההודעה המשויכת לנציג היא ההודעה האחרונה בשיחה (כולל הודעות לנציג וגם הודעות למשתמשים). המשתמש יכול להקיש על הצעה לתשובה כדי לשלוח את התשובה בהודעת הטקסט לנציג, או להקיש על הצעה לפעולה להפעלת פעולה מותאמת במכשיר.

string

הטקסט מקודד ב-UTF-8.

string

השם הייחודי של קובץ. כשנציג מעלה קובץ, פלטפורמת RBM מחזירה שם של קובץ. הוצא משימוש לטובת UploadRbmFile למטה

object (UploadedRbmFile)

יש מזהים של קובץ ותמונה ממוזערת שהועלו לשרת של RBM והוצגו על ידיו.

object (RichCard)

צ'אט אינטראקטיבי נפרד.

object (ContentInfo)

מידע על קובץ, כולל כתובת ה-URL שלו וכתובת ה-URL של התמונה הממוזערת שלו.

הפלטפורמה של RBM מציגה תוכן מהמטמון, אבל סוכן יכול לאלץ את הפלטפורמה של RBM לאחזר גרסה חדשה של התוכן ולרענן את המטמון.

{
  "fileName": string,
  "thumbnailName": string
}

string

שם הקובץ, שהוחזר על ידי הפלטפורמה של RBM כשהקובץ הועלה.

string

שם התמונה הממוזערת, שהוחזר על ידי הפלטפורמה של RBM כאשר התמונה הממוזערת הועלתה.

{

  // Union field card can be only one of the following:
  "carouselCard": {
    object (CarouselCard)
  },
  "standaloneCard": {
    object (StandaloneCard)
  }
  // End of list of possible types for union field card.
}

object (CarouselCard)

קרוסלה של כרטיסים.

object (StandaloneCard)

כרטיס להצגה באופן עצמאי.

{
  "cardWidth": enum (CarouselCard.CardWidth),
  "cardContents": [
    {
      object (CardContent)
    }
  ]
}

enum (CarouselCard.CardWidth)

רוחב הכרטיסים בקרוסלה.

object (CardContent)

רשימת התוכן לכל כרטיס בקרוסלה. קרוסלה יכולה לכלול עד 2 כרטיסים ועד 10 כרטיסים.

{
  "title": string,
  "description": string,
  "media": {
    object (Media)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ]
}

string

(אופציונלי) כותרת הכרטיס. עד 200 תווים.

string

(אופציונלי) תיאור הכרטיס. עד 2,000 תווים.

object (Media)

(אופציונלי) מדיה (תמונה, GIF, סרטון) שיש לכלול בכרטיס.

object (Suggestion)

(אופציונלי) רשימת הצעות שייכללו בכרטיס. עד 4 הצעות.

{
  "height": enum (Media.Height),

  // Union field content can be only one of the following:
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}

enum (Media.Height)

גובה המדיה בתוך כרטיס מתקדם בפריסה אנכית. בכרטיס עצמאי עם פריסה אופקית, לא ניתן להתאים אישית את הגובה והמערכת מתעלמת מהשדה הזה.

string

השם הייחודי של הקובץ, שהוחזר על ידי הפלטפורמה של RBM כשהקובץ הועלה. הוצא משימוש לטובת UploadRbmFile למטה

object (UploadedRbmFile)

יש מזהים של קובץ ותמונה ממוזערת שהועלו לשרת של RBM והוצגו על ידיו.

object (ContentInfo)

מידע על קובץ, כולל כתובת ה-URL שלו וכתובת ה-URL של התמונה הממוזערת שלו.

הפלטפורמה של RBM מציגה תוכן מהמטמון, אבל סוכן יכול לאלץ את הפלטפורמה של RBM לאחזר גרסה חדשה של התוכן ולרענן את המטמון.

{
  "fileUrl": string,
  "thumbnailUrl": string,
  "forceRefresh": boolean
}

string

כתובת ה-URL של הקובץ שגלויה לכולם. פלטפורמת RBM קובעת את סוג ה-MIME של הקובץ מהשדה של סוג התוכן בכותרות ה-HTTP כשהפלטפורמה מאחזרת את הקובץ. השדה של סוג התוכן חייב להיות נוכח ומדויק בתגובת ה-HTTP מכתובת האתר. גודל הקובץ המקסימלי המומלץ: 100MB.

string

(אופציונלי, בקובצי תמונה, אודיו ווידאו בלבד) כתובת URL של התמונה הממוזערת שגלויה לכולם. גודל מקסימלי של 100kB.

אם לא תספקו כתובת URL של תמונה ממוזערת, פלטפורמת RBM תציג תמונה ממוזערת ריקה כ-placeholder, עד שהמכשיר של המשתמש יוריד את הקובץ. בהתאם להגדרת המשתמש, ייתכן שההורדה של הקובץ לא תתבצע אוטומטית והמשתמש יצטרך להקיש על לחצן ההורדה.

boolean

אם המדיניות מוגדרת, פלטפורמת RBM מאחזרת את הקובץ ואת התמונה הממוזערת מכתובות ה-URL שצוינו, גם אם יש בפלטפורמה עותקים של הקובץ (ו/או של התמונה הממוזערת) שנשמרו במטמון.

{

  // Union field option can be only one of the following:
  "reply": {
    object (SuggestedReply)
  },
  "action": {
    object (SuggestedAction)
  }
  // End of list of possible types for union field option.
}

object (SuggestedReply)

המשתמשים יכולים להקיש על הצעה לתשובה כדי לשלוח את התשובה בהודעת הטקסט לנציג.

object (SuggestedAction)

המשתמשים יכולים להקיש על הצעה לפעולה כדי להפעיל את הפעולה המקורית התואמת במכשיר.

{
  "text": string,
  "postbackData": string
}

string

טקסט שמוצג בתשובה המוצעת ונשלח חזרה לנציג כאשר המשתמש יקיש עליו. 25 תווים לכל היותר.

string

המטען הייעודי (payload) בקידוד base64 שהסוכן מקבל באירוע של משתמש כשהמשתמש מקיש על התשובה המוצעת.

{
  "text": string,
  "postbackData": string,
  "fallbackUrl": string,

  // Union field action can be only one of the following:
  "dialAction": {
    object (DialAction)
  },
  "viewLocationAction": {
    object (ViewLocationAction)
  },
  "createCalendarEventAction": {
    object (CreateCalendarEventAction)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "shareLocationAction": {
    object (ShareLocationAction)
  }
  // End of list of possible types for union field action.
}

string

הטקסט שמוצג בפעולה המוצעת. 25 תווים לכל היותר.

string

מטען ייעודי (payload) (בקידוד base64) שיישלח לסוכן באירוע של המשתמש שמתרחש כשהמשתמש יקיש על הפעולה המוצעת

string

(אופציונלי) כתובת URL חלופית לשימוש אם הלקוח לא תומך בפעולה מוצעת. כתובות URL חלופיות נפתחות בחלונות חדשים בדפדפן.

object (DialAction)

פתיחה של אפליקציית החייגן שמוגדרת כברירת מחדל כאשר ממולא מספר הטלפון שצוין על ידי הסוכן.

object (ViewLocationAction)

פותח את אפליקציית המפות שמוגדרת כברירת מחדל ובוחר את המיקום שצוין בסוכן או מחפש מידע על המיקום של המשתמש בהתאם לשאילתה שצוינה בסוכן.

object (CreateCalendarEventAction)

פותח את אפליקציית היומן שמוגדרת כברירת מחדל ומתחיל תהליך חדש של אירועים ביומן כאשר נתוני האירוע שצוינו על ידי הסוכן ממולאים מראש.

object (OpenUrlAction)

פותח את אפליקציית ברירת המחדל של המשתמש לדפדפן האינטרנט לכתובת ה-URL הנתונה. אם למשתמש יש אפליקציה מותקנת ורשומה כ-handler ברירת המחדל לכתובת ה-URL, האפליקציה הזו תיפתח במקום זאת והסמל שלה ישמש בממשק המשתמש של הפעולות המומלצות.

object (ShareLocationAction)

פותח את בוחר המיקום של אפליקציית RCS כדי שהמשתמש יוכל לבחור מיקום לשלוח לנציג.

{
  "phoneNumber": string
}

string

מספר הטלפון בפורמט E.164, למשל +12223334444.

{
  "latLong": {
    object (LatLng)
  },
  "label": string,
  "query": string
}

object (LatLng)

(אופציונלי) קו הרוחב וקו האורך של המיקום שצוין.

string

(אופציונלי) התווית של הסיכה הופחתה ב-latLong.

string

(אופציונלי, האפשרות נתמכת רק בלקוחות Android Messages) במקום לציין latLong (ואפשר גם להוסיף תווית), הסוכן יכול לציין מחרוזת שאילתה. באפליקציות מיפוי שמוגדרות כברירת מחדל שתומכות בפונקציונליות חיפוש (כולל מפות Google), הקשה על ההצעה הזו לפעולה מובילה לחיפוש מיקום שמבוסס על המיקום הנוכחי של המשתמש. אם השאילתה ספציפית מספיק, הנציגים יוכלו להשתמש בה כדי לבחור כל מיקום בעולם.

לדוגמה, הגדרת מחרוזת השאילתה כ-"Growing Tree Bank" יציג את כל המיקומים של בנק עצים שנמצאים בקרבת המשתמש. הגדרת מחרוזת השאילתה ל"1600 Amphitheater Parkway, Mountain View, CA 94043" יבחר את הכתובת הספציפית הזו, בלי קשר למיקום של המשתמש.

{
  "latitude": number,
  "longitude": number
}

number

קו הרוחב במעלות. הוא חייב להיות בטווח [-90.0, +90.0].

number

קו האורך במעלות. הוא חייב להיות בטווח [-180.0, +180.0].

{
  "startTime": string,
  "endTime": string,
  "title": string,
  "description": string
}

string (Timestamp format)

שעת ההתחלה של האירוע.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

שעת הסיום של האירוע.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

string

כותרת האירוע.

string

תיאור האירוע.

{
  "url": string
}

string

כתובת URL

{
  "cardOrientation": enum (StandaloneCard.CardOrientation),
  "thumbnailImageAlignment": enum (StandaloneCard.ThumbnailImageAlignment),
  "cardContent": {
    object (CardContent)
  }
}

enum (StandaloneCard.CardOrientation)

כיוון הכרטיס.

enum (StandaloneCard.ThumbnailImageAlignment)

יישור התצוגה המקדימה של התמונות לכרטיסים נפרדים עם פריסה אופקית.

object (CardContent)

תוכן הכרטיס.