Messenger 設定檔 API:問候語、Get Started 按鈕、破冰問題與固定選單
Facebook 專頁的 Messenger 設定檔透過 /{page-id}/messenger_profile 設定,需使用附 pages_messaging 權限的專頁存取權杖:POST 寫入 get_started、greeting、ice_breakers、persistent_menu 與 commands 等屬性,GET 以 fields 讀取,DELETE 則按 fields 陣列刪除所指定的屬性。Meta 規定每個專頁每 10 分鐘最多 10 次呼叫,且只會覆寫所傳送的屬性。
easyCoexistence 讓 Claude、ChatGPT 或您自行開發的程式,透過 send_social_dm 在 24 小時的回覆期限內回覆 Facebook 專頁的 Messenger 對話,新訊息也會即時轉發至您的端點。
每個專頁在每個 10 分鐘區間內可進行的 Messenger 設定檔 API 呼叫次數。
API 可設定的破冰問題數量上限;兩者同時設定時,API 破冰問題優先於 Get Started 按鈕。
固定選單頂層項目數量上限;每個項目的標題限 30 個字符。
專頁層級固定選單更新最多需時多久;為單一用戶設定的選單會即時更新。
問候語文字。Meta 的問候語參考文件指出,該功能已不再適用於 Messenger 的 Android 與 iOS 版本。
Messenger 設定檔包含哪些內容?
專頁 Messenger 體驗的起始設定。Meta 的 Messenger Profile API 列出以下屬性,全部透過同一端點設定與讀取;若應用程式處於開發模式,這些設定只對應用程式中具有角色的用戶可見:
如何讀取、設定與刪除屬性?
以同一端點的三種方法操作,並使用專頁的權杖呼叫。POST 接受含屬性的 JSON 主體,只覆寫其指定的屬性;GET 以逗號分隔的 fields 清單讀取;DELETE 的 JSON 主體以 fields 陣列指定要移除的項目。POST 與 DELETE 均回傳 result success。以下範例於一次呼叫中同時設定 Get Started 按鈕與選單:
POST /{page-id}/messenger_profile
{
"get_started": { "payload": "GET_STARTED" },
"persistent_menu": [
{
"locale": "default",
"composer_input_disabled": false,
"call_to_actions": [
{ "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
{ "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
]
}
]
}
{ "result": "success" }Get Started 按鈕如何運作?
按鈕位於歡迎畫面,該畫面會顯示專頁名稱、頭像、封面相片,以及企業通常的回覆時間。用戶點擊後,系統會將 Get Started 發送到對話中,並把 get_started.payload 以 messaging_postbacks 事件傳送至應用程式,然後開啟標準的訊息視窗。Meta 指出,當 Messenger 在 Facebook 應用程式的內建瀏覽器中運行時不支援此按鈕,而固定選單必須先設定此按鈕。
問候語文字仍然有效嗎?
在手機上已無效。Meta 的參考文件現標題為「[已棄用] Greeting Text」:此功能已不適用於 Messenger 的 Android 與 iOS 版本。雖然 API 可能仍接受 greeting 屬性,但用戶不會看到,因此 Meta 建議開發者避免使用。按文件所述,greeting 每種語言只有一段文字,必須設定 default,最多 160 個字符,可用 {{user_first_name}}、{{user_last_name}} 或 {{user_full_name}} 個人化;設定時需要專頁的管理員角色。
破冰問題如何運作?
最多列出 4 個問題,用戶可點選以開啟對話;該問題會以用戶本人提出的形式出現在對話串中,其 payload 會以 postback 事件回傳。自 2022 年 4 月起,破冰問題支援本地化:ice_breakers 中的每個物件都包含 call_to_actions 與 locale,必須設定預設語言,而刪除 ice_breakers 會移除全部項目。Meta 對爭取新對話的各項元素作出以下排序:
- 同時設定時,API 破冰問題優先於 Get Started 按鈕。
- 兩者都排在專頁收件匣中自訂問題之前;當 API 破冰問題已設定時,收件匣自訂問題的編輯功能會停用。
固定選單如何建立?
以選單陣列表示,每種語言一個,必須設定預設語言;每個選單最多包含 20 個 call_to_actions,類型為 web_url 或 postback。標題最多 30 個字符,postback 的 payload 最多 1,000 個字符;將 composer_input_disabled 設為 true 後,用戶只能透過選單、按鈕與網頁視窗互動。Meta 規定選單顯示前須符合以下條件:
- 已設定 Get Started 按鈕,並具有
pages_messaging權限。 - 專頁已發布,且應用程式設為公開。
- 設定選單的人員須具有專頁的管理員角色。
- iOS 或 Android 上的 Messenger 版本需為 v106 或以上,且不在 Facebook 應用程式的內建瀏覽器中。
- 專頁層級的變更最多需時 24 小時;透過
custom_user_settings以 PSID 為單一用戶設定的選單,會即時更新。
什麼是指令?
用戶可隨時叫用的關鍵字,可從輸入框旁的指令選單叫用,方法是輸入斜線或 @ 符號,或在輸入相符字詞時從彈出視窗選取。每種語言最多可設 1 至 100 個指令,指令名稱為 1 至 32 個字符且不得以斜線開頭,說明為 1 至 64 個字符;設定指令後,指令的優先次序高於固定選單。被叫用的指令會透過 messages 事件送達應用程式,位於 message.commands 之中。
whitelisted_domains 與 account_linking_url 的用途是什麼?
兩者都服務於對話以外的體驗。whitelisted_domains 最多可列出 50 個網域,供 Messenger 網頁視窗為 Messenger Extensions SDK 與核取方塊外掛程式開啟;每個網域必須以 HTTPS 提供,並使用完整網域名稱,不可為 IP 位址或 localhost。設定時需要專頁的管理員角色。account_linking_url 則是 HTTPS 回呼網址,用於將用戶的 Messenger 帳戶與其在企業的帳戶連結。
easyCoexistence 如何設定 Facebook 專頁的 Messenger 設定檔?
不能:沒有任何工具會呼叫 {page-id}/messenger_profile,專頁權杖也不會交出,因此設定檔案不在此連接的範圍內。用戶叫用的指令會抵達 easyCoexistence 轉發的 messages 事件,再由自動化流程讀取;而 Meta 回報為 messaging_postbacks 事件的點擊(來自 Get Started、postback 選單項目與破冰問題),則不會被轉發,因為專頁已訂閱 feed、messages 與 mention。
常見錯誤
- 先設定固定選單,後設定 Get Started。Meta 的要求包括已設定 Get Started 按鈕,因此應先設定 get_started。
- 遺漏預設語言。破冰問題、選單與指令各需要一個 locale 設為 default 的物件作為後備。
- 在迴圈中呼叫設定檔 API。Meta 規定每個專頁每 10 分鐘最多 10 次呼叫,因此應將多個屬性合併於一次 POST。
- 以為選單變更會即時生效。專頁層級的選單更新最多需時 24 小時才會送達用戶。
設定 Messenger 設定檔不在其工具之列。每個連接每月 US$ 9 至 US$ 0.75,連接越多越便宜,首 3 天免費。
常見問題
固定選單可以因人而異嗎?
可以。以用戶的 PSID 設定的 custom_user_settings 會為該用戶覆寫專頁的選單,即時更新,並允許每位用戶在 10 分鐘內呼叫 10 次。
Messenger 設定檔支援哪些語言?
支援 Meta 所列的語言代碼,例如 en_GB、pt_BR 或 ja_JP,另包括 default,即在沒有符合用戶語言時使用的後備語言。
誰可以更改 Facebook 專頁的 Messenger 設定檔?
持有附 pages_messaging 權限之專頁權杖的應用程式。固定選單、問候語與網域清單還需要專頁的管理員角色。
easyCoexistence 對 Facebook 專頁收費多少?
每個專頁即一個連接:每個連接每月 US$ 9 至 US$ 0.75,連接數量越多價格越低,首 3 天免費。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期