跳至主要內容

Facebook Messenger

接入物件是 Facebook Page：Messenger 訊息透過簽名 Webhook 到達 Anyy，回覆由 Page Access Token 授權傳送。目前只提供私訊，不提供 Facebook 群組對話。

平台和回呼都要準備​

在 Meta App 啟用 Messenger，準備 Page ID、App ID、Page Access Token、App Secret，以及自己設定的 Webhook Verify Token。完成 Page 訊息事件訂閱與 Messaging 權限；App Review 和測試角色要求以官方入門文件為準。

按共享 Webhook 設定開啟 Anyy 的獨立監聽並設定公用網路 HTTPS。回呼路徑為：

/channels/facebook/ACCOUNT_ID/webhook

預設帳號 ID 為 page；Meta 和 Anyy 中的 Verify Token 必須一致。代理不能改寫簽章驗證所用的請求本文或移除簽名 Header。

在 Anyy 儲存連線​

Dashboard 通訊管道 → 新增 → Facebook 的 Messenger Webhook 接入填寫兩項識別碼和三項認證資料。策略預設 pairing；策略選擇透過 anyy setup channel 的 CLI 精靈處理，認證資料頁沒有這些輸入。

目前 DM 策略值為 pairing/open/allowlist/disabled。配對可以授權已核對身分的傳送者；現有公開表單不提供此平台名單條目編輯，見訊息平台。

anyy channel pairing list --channel facebook
anyy channel pairing approve --request REQUEST_ID

用符合資格的帳號測試​

anyy channel reload
anyy channel doctor facebook

應用程式尚未對外發布時，先用 Meta App/Page 角色帳號測試，分別檢查 Challenge、簽名事件、配對和回覆。

  • 回呼無法驗證：HTTPS 可連線性與 Verify Token。
  • 簽名被拒絕：App Secret 和代理保留的原 Body/Header。
  • 能收不能發：Page Token、Page 身分與 Messaging 權限。
  • 只有管理員能用：平台 App 模式、稽核與訂閱範圍。

平台接受一次傳送也不表示使用者已讀；不明結果的處理見通訊管道健康說明。