Nathan AI

通路設定指南

LINE／Facebook／Instagram · 回客戶後台 · Markdown 版

把助理接到官方帳號或粉絲專頁。訪客傳訊息時，會使用你在 Portal 上傳的文件與方案額度回覆。 正式環境 API 必須是公開 HTTPS；本機請用 ngrok。

開啟 Portal 通路設定

一、到 Portal 取得 Webhook

  1. 登入客戶後台 /portal/
  2. 左側選「通路（LINE／社群）」
  3. 複製各通路的 Webhook URL
  4. Meta（FB／IG）另記下 Verify Token

二、LINE Official Account

準備金鑰

  1. 開啟 LINE Developers
  2. 建立或選取 Messaging API 頻道
  3. 複製 Channel secret
  4. Messaging API 分頁發行並複製 Channel access token（長期）
  5. 建議關閉 OA 的自動回應／歡迎訊息，避免與 AI 搶答

接到 Nathan AI

  1. Portal → 通路 → LINE：貼上 Secret 與 Token → 儲存
  2. 複製 Webhook URL：https://你的網域/api/webhooks/line/{assistantId}
  3. LINE Developers → Webhook → 貼上 → Verify → 開啟 Use webhook
  4. 手機傳訊息測試
現象可能原因
Verify 失敗非 HTTPS、API 未開、assistantId 錯誤
無回覆金鑰錯誤、額度用完、伺服器未設 API Key
回兩次OA 自動回應與 Webhook 同時開

三、Facebook Messenger

  1. 至 Meta for Developers 建立 Business App
  2. 新增 Messenger，連結粉絲專頁
  3. 取得 Page ID、Page Access Token；建議一併複製 App Secret
  4. Portal → Facebook：填寫並儲存
  5. Webhook URL：https://你的網域/api/webhooks/meta/{assistantId}
  6. Verify Token 填 Portal 顯示的字串
  7. 訂閱專頁 messages 等事件後測試

開發模式可能僅管理員／測試者可對話；上線需完成 Meta 權限審核。

四、Instagram Messaging

  1. IG 需為專業／創作者帳號，並綁定 Facebook 粉絲專頁
  2. 使用該專頁的 Page ID 與 Page Access Token
  3. Portal → Instagram：填寫並儲存
  4. Webhook 與 Facebook 同一 URL、同一 Verify Token
  5. 在 Meta 訂閱 Instagram 訊息相關欄位後測試

個人帳號無法使用 Messaging API。細節以 Meta 官方文件為準。

五、本機開發（ngrok）

npm run dev:api
ngrok http 3000

將 PUBLIC_API_URL 改成 ngrok 的 https://…，重啟 API，再到 Portal 複製新 Webhook。

六、給網站／行銷廠商（可轉貼）

請協助將下列 Webhook 設到 LINE Developers／Meta App，並將 Channel／Page 金鑰交由品牌方於 Nathan AI 客戶後台「通路」儲存。無需改官網版型；若同時要官網右下角助理，另貼嵌入 script 即可。

完整 Markdown：/docs/CHANNELS.md