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

String

問候語的地區設定，當用戶的地區設定與提供的地區設定相符時，便會顯示該地區設定的問候語。


您必須至少指定預設地區設定的問候語，若提供的地區設定與用戶的地區設定無一相符時，便會顯示預設地區設定的問候語。


支援的地區設定清單。

text

String

特定地區設定的問候語。必須是 UTF-8，字數不得超過 160 個字元。

個人化

您可以加上用戶姓名，將問候語個人化。您可以使用下列範本字串：

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

範例

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

速率限制

呼叫 Messenger 個人檔案 API 時，只限每隔 10 分鐘呼叫 API 10 次。每個粉絲專頁都必須遵守這項速率限制。