Messenger 平台

問候語文字

Messenger 個人檔案 API

greeting 是 Messenger 個人檔案 API 的屬性。若要瞭解有關擷取、設定、更新與刪除 greeting 的詳情，請參閱 Messenger 個人檔案 API 參考資料。

透過 Bot Messenger 個人檔案的 greeting 屬性，您可以指定用戶在 Bot 迎賓畫面上看到的問候語。所有第一次與您 Bot 互動的用戶都會看到迎賓畫面。

若問候語文字未設定為用戶的本地語言，那麼迎賓畫面就會顯示對話串設定 API 中設定的標準問候語文字。如果您也沒有設定標準問候語文字，就會改為顯示專頁的描述。

內容

必要條件

若要設定或更新問候語文字，您必須擁有 Bot 相關專頁的「管理員」角色。

greeting 格式

"greeting":[
  {
    "locale":"default",
    "text":"Hello!"
  }, {
    "locale":"en_US",
    "text":"Timeless apparel for the masses."
  }
]

屬性

屬性 類型 描述

locale

字串

問候語的本地語言，會在用戶的本地語言與所提供的本地語言一致時顯示。


您必須最少指定預設本地語言的問候語，系統會在已有本地語言不符合用戶的本地語言時顯示這段文字。


系統支援的本地語言清單。

text

字串

特定本地語言的問候語文字。格式必須為 UTF-8，最多 160 個字元。

個人化

您可以使用用戶的姓名來個人化問候語文字。您可以使用下列範例字串：

  • {{user_first_name}}
  • {{user_last_name}}
  • {{user_full_name}}

範例

"greeting":[
  {
    "locale":"default",
    "text":"Hello {{user_first_name}}!"
  }
]

傳輸率限制

向 Messenger 個人檔案 API 執行的調用次數上限為每 10 分鐘 10 次 API 調用。此傳輸率限制將按專頁作為執行單位。