串接對話平台：Instagram

將 Agent 串接到 Instagram 專業帳號的私訊，前置條件、授權流程與常見問題

Instagram 私訊串接建立在 Facebook 粉絲專頁之上：MaiAgent 透過與 Instagram 帳號連結的粉絲專頁取得授權，再由該粉專代收與代回 Instagram 私訊。授權流程與 FB Messenger 相同，差別在於粉專必須先連結 Instagram 專業帳號。

串接前確認

MaiAgent 準備

• 已在 MaiAgent 平台上建立好一個「AI 助理」

Instagram 帳號準備

• Instagram 帳號已切換為專業帳號（商業帳號或創作者帳號），個人帳號無法串接

• 該 Instagram 帳號已連結到一個 Facebook 粉絲專頁（在 Instagram App 的 設定 → 商家工具與控制項 → 連結的帳號，或在粉絲專頁的 設定 → 已連結的帳號 完成連結）

• 該 Instagram 帳號已允許接收訊息（設定 → 訊息與限時動態回覆 → 訊息控制項 → 允許使用連結工具存取訊息）

Facebook 權限準備

• 用來登入的 Facebook 帳號已被邀請或建立過商家資產管理組合，並擁有「完整控制權限」

• 如果粉專已在商家資產管理組合下：無需額外調整

• 如果粉專不在商家資產管理組合下：必須是該粉絲專頁的管理人員且擁有完整控制權限

還沒有商家資產管理組合？ 請先依 Meta 官方說明建立商家資產管理組合，建立者會自動擁有完整控制權限。

如何確認自己有完整控制權限？ 到 Meta Business Suite 的 設定 → 用戶 → 人員，點選自己的名字查看權限。若只有部分存取權限，請組合內有完整控制權限的成員協助調整，權限說明詳見 Meta 官方說明。

粉專要先加進商家資產管理組合嗎？ 不一定要。授權時可以直接認領粉專；若想事先整理好，也可以依 Meta 官方說明把粉專加進組合。

Instagram 帳號要加進商家資產管理組合嗎？ 不需要。MaiAgent 透過粉專取得連結的 Instagram 帳號，只要 Instagram 專業帳號已連結該粉專即可。

一個 Instagram 帳號只能串接到一個對話平台。若要換綁到其他 Agent，請先刪除原本的對話平台再重新串接。

開始串接

1. 進入串接對話平台頁面

在左側選單點選 對話平台，點擊右上角 串接對話平台，在平台選擇頁面點選 Instagram。

2. 登入 Facebook 並授權

點擊 Facebook 登入，以管理該粉專的 Facebook 帳號登入。授權視窗會依序要求：

1. 選擇要授權的商家資產管理組合

2. 選擇（認領）已連結 Instagram 帳號的粉絲專頁

3. 確認授權

MaiAgent 只會存取您授權的粉絲專頁與其連結 Instagram 帳號的訊息，不會存取您的個人訊息。

Facebook 登入

請確認瀏覽器允許彈出視窗，否則 Facebook 登入視窗可能被封鎖。若授權後粉專清單沒有更新，可點擊 Instagram 頻道 區塊右上角的 重新載入 重新授權一次。

3. 基本設定

欄位	說明
對話平台名稱	為此串接取一個名稱，方便辨識
AI 助理	選擇要回覆 Instagram 私訊的 Agent
選擇粉專	從清單中選擇已連結 Instagram 帳號的粉絲專頁，系統會自動取得該粉專連結的 Instagram 帳號
啟用重置命令	（選填）開啟後可設定一個或多個指令，使用者在私訊中送出該指令時會重新開始一段新對話，例如「重新開始」

清單列出的是您授權的所有粉絲專頁。若選到的粉專沒有連結 Instagram 帳號，儲存時會出現「此 Page 沒有連結 Instagram 帳號」的錯誤，請回到 Instagram 或粉專設定完成連結後再試一次。

4. 儲存並確認串接結果

點擊 串接對話平台 完成建立。串接成功後，MaiAgent 會自動向 Meta 訂閱該粉專的訊息事件，不需要另外設定 Webhook。

用另一個 Instagram 帳號私訊該專業帳號送出測試訊息，Agent 如可以正常回覆，表示串接已成功。您也可以在 MaiAgent 的對話平台列表點進此串接，於 所有對話 中看到進線的私訊。

串接成功後，可在對話平台列表點擊編輯，進一步設定功能選項（OCR 辨識、使用系統時間或傳送者名稱回答、客服轉真人、對話標籤、權限控管等），詳見對話平台設定總覽。

支援的訊息類型

方向	支援內容
使用者 → Agent	文字、圖片、影片、語音、貼圖；圖片可搭配 OCR 辨識
Agent → 使用者	文字、圖片

• Markdown 自動轉純文字：Instagram 不會渲染 Markdown，Agent 回覆中的標題、粗斜體、連結、表格等語法在送出前會自動轉成純文字（連結變成「文字 網址」），真人客服打的字不受影響，見 訊息內容渲染優化：通訊軟體通道

• 連續訊息合併成一輪：使用者連續傳多張圖片、或先傳圖再打字時，Agent 會等這一串訊息到齊（只含圖片的訊息，最後一則後約 4 秒沒有新訊息才回答，最長約 20 秒，收到文字就立刻回）後一次回答；同一對話一次只處理一輪

• 24 小時回覆期限：Meta 只允許在使用者最後一則訊息後 24 小時內回覆，超過期限送出的訊息會在對話頁標示 未送達

常見問題

Q：授權後粉專清單是空的？

登入的 Facebook 帳號沒有該粉專的完整控制權限，或授權時沒有勾選該粉專。請先依串接前確認檢查權限，再以粉專管理員身分重新登入，並在授權視窗中確認勾選正確的粉專。

Q：儲存時顯示「此 Page 沒有連結 Instagram 帳號」？

粉專與 Instagram 專業帳號尚未連結，或 Instagram 帳號仍是個人帳號。請先在 Instagram 切換為專業帳號並連結該粉專，再重新授權一次。

Q：儲存時顯示「此 Instagram 帳號已被使用」？

同一個 Instagram 帳號已串接到組織內另一個對話平台。請先刪除原本的對話平台，再重新建立。

Q：使用者私訊了，但 MaiAgent 沒有收到？

請依序確認：Instagram 帳號的訊息控制項已允許連結工具存取訊息、粉專與 Instagram 帳號的連結仍然有效、授權的 Facebook 帳號仍是粉專管理員。若是授權過期或粉專權限被移除，請刪除對話平台後重新串接。

Q：Instagram 與 FB Messenger 可以共用同一個 Agent 嗎？

可以。兩者是各自獨立的對話平台，可以綁定同一個 Agent，也可以各自設定不同的功能選項。