這份文件已更新。
中文(香港) 的翻譯尚未完成。
英文更新時間:8月22日
中文(香港) 更新時間:2018年9月7日

問候語

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 調用。此傳輸率限制將按專頁作為執行單位。