問候語

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 分鐘呼叫 API 10 次。每個粉絲專頁都必須遵守這項速率限制。