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} 則是服務專員指派的服務專員訊息 ID。

string (Timestamp format)

這個欄位是由 RBM 平台設定。建立服務專員訊息時，請勿包含此字串。欄位會解析訊息傳送給使用者的時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度不超過奈秒，最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (AgentContentMessage)

服務專員訊息的內容。

string (Timestamp format)

選用設定。資源到期時間的時間戳記 (世界標準時間)。如果已設定 TTL 欄位，則會在輸出時提供這個值。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度不超過奈秒，最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Duration format)

選用設定。僅限輸入。訊息會在自動撤銷前保留多久。

持續時間以秒為單位，最多 9 個小數位數，結尾為「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 伺服器上傳及提供的檔案和縮圖 ID

object (RichCard)

獨立的複合式資訊卡。

object (ContentInfo)

檔案相關資訊，包括檔案網址和縮圖網址。

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 伺服器上傳及提供的檔案和縮圖 ID

object (ContentInfo)

檔案相關資訊，包括檔案網址和縮圖網址。

RBM 平台會從快取提供內容，但代理程式可以強制 RBM 平台擷取新版本的內容並重新整理快取。

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

string

檔案可公開存取的網址。RBM 平台在平台擷取檔案時，會從 HTTP 標頭的 content-type 欄位判斷檔案的 MIME 類型。Content-type 欄位必須在網址的 HTTP 回應中正確存在且正確無誤。建議的檔案大小上限為 100 MB。

string

(選用，僅適用於圖片、音訊和影片檔案) 縮圖的公開連結網址。大小上限為 100 KB。

如果您沒有提供縮圖網址，RBM 平台會顯示空白的預留位置縮圖，直到使用者裝置下載該檔案為止。視使用者的設定而定，檔案可能不會自動下載，使用者也可能必須輕觸下載按鈕。

boolean

設定後，即使平台已快取檔案 (和/或縮圖) 的副本，RBM 平台仍會從指定的網址擷取檔案和縮圖。

{

  // 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

在使用者輕觸建議回覆時，代理程式在使用者事件中收到的 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

酬載 (採用 Base64 編碼) 會在使用者輕觸建議動作時傳送至代理程式的結果

string

(選用) 如果客戶不支援建議動作時要使用的備用網址。備用網址會在新的瀏覽器視窗中開啟。

object (DialAction)

開啟使用者的預設撥號應用程式，並填入服務專員指定的電話號碼。

object (ViewLocationAction)

開啟使用者的預設地圖應用程式，然後選取服務專員指定的位置，或在服務專員指定的查詢中，搜尋使用者所在位置的附近地點。

object (CreateCalendarEventAction)

開啟使用者的預設日曆應用程式，開始新的日曆活動流程，並預先填入代理程式指定的事件資料。

object (OpenUrlAction)

開啟使用者的預設網路瀏覽器應用程式前往指定網址。如果使用者已安裝的應用程式註冊為網址的預設處理常式，系統會改為開啟這個應用程式，並在建議動作 UI 中使用該應用程式的圖示。

object (ShareLocationAction)

開啟 RCS 應用程式的位置選擇器，讓使用者選擇要傳送給服務專員的位置。

{
  "phoneNumber": string
}

string

採用 E.164 格式的電話號碼，例如 +12223334444。

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

object (LatLng)

(選用) 指定位置的經緯度。

string

(選用) 在 latLong 放置的圖釘標籤。

string

(選用，只有 Android 訊息用戶端支援) 代理程式可以改為指定查詢字串，不必指定 latLong (也可視需要指定標籤)。在支援搜尋功能的預設地圖應用程式 (包括 Google 地圖) 中，輕觸這項建議動作後，系統會以使用者目前所在位置為中心的位置搜尋。如果查詢內容夠具體，服務專員就能利用該查詢選取全球任何地點。

例如，將查詢字串設為「拓展樹木銀行」會顯示使用者附近所有正在成長的 Tree Bank 地點。將查詢字串設為「1600 Amphitheater Parkway, Mountain View, CA 94043, USA」一律選取該特定地址，無論使用者身在何處。

{
  "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 世界標準時間「Zulu」的時間戳記格式，解析度不超過奈秒，最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

活動結束時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度不超過奈秒，最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string

活動標題。

string

活動說明。

{
  "url": string
}

string

網址

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

enum (StandaloneCard.CardOrientation)

資訊卡的方向。

enum (StandaloneCard.ThumbnailImageAlignment)

採用橫向版面配置的獨立資訊卡圖片預覽對齊方式。

object (CardContent)

資訊卡內容。