# Facebook Messenger | 整合到 Omnichat

{% hint style="warning" %}
Marketing Message 上線前串接 Facebook 的既有客戶，使用 Marketing Message 前須重新串接！
{% endhint %}

## 如何整合 Facebook Messenger

### 前置條件

* 你的 Facebook 帳號需要擁有該商業資產（Business Portfolio）的 **「管理員」 權限**
* 檢查權限路徑：至 Meta Business Suite 設定 > 用戶 > 用戶，查看相關人員中是否有自己

{% hint style="danger" %}
**目前僅支援 PC 版本或是筆電進行串接，手機無法執行串接步驟。**
{% endhint %}

{% hint style="danger" %}
**如果已經遺失商業資產的管理員帳號，可以按照**[**官方指示**](https://www.facebook.com/business/help/474856681929983)**申請。**
{% endhint %}

<figure><img src="/files/yfoAaL2cJshpEk9LElEj" alt=""><figcaption></figcaption></figure>

### 串接步驟

1. 登入 [Omnichat 後台](https://app.omnichat.ai/)
2. 在左側選單選擇「**通訊渠道 >** [**社群帳號**](https://console.omnichat.ai/social-channels?tab=facebook-pages)」
3. 點擊 **Facebook Messenger** 分頁部份 -> 點擊「**串接 Facebook 專頁**」

{% hint style="info" %}
目前僅支援 PC 版本或是筆電（laptop）進行串接，手機無法執行串接步驟。
{% endhint %}

<figure><img src="/files/Gx47Pe3qYJOcMnIyw6hy" alt=""><figcaption></figcaption></figure>

4\. 會另開網站分頁，請點擊 「**以 O O O 的身份繼續**」

{% hint style="info" %}
如您尚未登入 Facebook 帳號，請先進行登入
{% endhint %}

<div align="center"><figure><img src="/files/d9iNxK2qRXWtx2yc08eA" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="center"><figure><img src="/files/YLU3Gg2jFQtrkVJxGUL2" alt="" width="367"><figcaption></figcaption></figure></div>

5\. 勾選要連結的商家資產（商家資產管理組合、Facebook 粉絲專頁、廣告帳號），如您未建立廣告帳號，則選擇「建立新的廣告帳號」。選擇後&#x6309;**「繼續」**。

{% hint style="info" %}
Marketing Message 的推播需要透過廣告帳號完成設定預算、建立受眾等，為必要的步驟與條件，須至 Meta 後台完成信用卡綁卡設定。
{% endhint %}

<div align="right"><figure><img src="/files/PGJqvQ5x0tQ6JwVcwqo2" alt="" width="366"><figcaption><p>選擇欲連結至 Omnichat 的粉絲專頁與廣告帳號</p></figcaption></figure> <figure><img src="/files/7FHWtykt0IkCmS3yEbaW" alt="" width="370"><figcaption><p>廣告幣別設定為 Marketing Message 扣款之貨幣</p></figcaption></figure></div>

{% hint style="info" %}
若看到以下畫面，代表目前已存在未綁卡的廣告帳號。一個商業資產只能有一個未綁卡的廣告帳號，**請選擇已經建立的廣告帳號來使用！**

<img src="/files/1YRmZlnDBZkTpauKVKVi" alt="" data-size="original">
{% endhint %}

6\. 確認欲連結的粉絲專頁與廣告帳號是否正確，然後&#x6309;**「確認」**

<figure><img src="/files/RQ6q4kSDZDyZmHoGDRPo" alt=""><figcaption></figcaption></figure>

7\. 稍等片刻即會顯示「你的帳號已連結至Omnichat Limited」，然後&#x6309;**「完成」**

<figure><img src="/files/NfEagmwBDzvGYJM1Imq0" alt=""><figcaption></figcaption></figure>

8. 確認權限都有開啟後，回到 Omnichat 後台，成功授權的 Facebook 專頁會在 「**串接 Facebook 專頁**」 小畫面列出，請勾選需要串接的 Facebook 粉專後點擊 「**串接**」 。

<figure><img src="/files/1QZU0ijtFfGtM0duwMUY" alt=""><figcaption></figcaption></figure>

9. 串接完成之後，畫面右上角會呈現 **「串接成功」** 的提示，並且在頁面列表當中也會出現串接好的 FB 粉專。

<figure><img src="/files/NdojFgWeBrZLNF5fRISY" alt=""><figcaption><p>成功串接 Facebook 粉絲專頁畫面</p></figcaption></figure>

#### **若須使用 Marketing Message、上傳 Facebook 廣告受眾、CAPI ，請繼續以下步驟。若不使用即完成串接**

10. 點擊「Facebook 廣告」切換頁面，並點&#x64CA;**「串接 Facebook 廣告帳號」**

<figure><img src="/files/m03oCGlUWbmw14wsEiae" alt=""><figcaption></figcaption></figure>

11. 將對應的廣告帳號與 Facebook 粉絲專頁串接在一起

<figure><img src="/files/yrVmqDv3tTR2UsaI94yG" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/hkgmOL1HmnXypBdkGNaP" alt=""><figcaption><p>廣告帳號與 Facebook 粉絲專頁串接完成畫面</p></figcaption></figure>

***

當以上步驟都設定完但還是串接失敗可以至「企業整合工具」 <https://www.facebook.com/settings/?tab=business_tools> 查看權限是否都開啟。

1. 在左側列表找到 「企業整合工具」 ，點擊 Omnichat 旁的 **「檢視並編輯」**
2. 下滑將所有權限項目都開啟，最下方 **「這個企業整合工具是否能傳送通知給你？」** 的設定選擇 **「是」**

<figure><img src="/files/1gb7H7tHIOKnjSgMzDbS" alt=""><figcaption><p>企業整合工具設定</p></figcaption></figure>

<div><figure><img src="/files/Os7isxqcD2XU3fD6KchN" alt=""><figcaption><p>將所有權限項目都開啟</p></figcaption></figure> <figure><img src="/files/srMWKyqMGLeTXDBiUPoM" alt=""><figcaption><p>將所有權限項目都開啟</p></figcaption></figure></div>

***

## 常見問題

### 1. 回覆 Facebook 事件時，彈出錯誤 「*傳送訊息到 Facebook Messenger 失敗，請檢查 Facebook Messenger 整合是否設置成功*」

如果回覆 Facebook 事件時，出現以下畫面，請先初步確認只有ㄧ個事件有出現，還是多個事件都有出現：

![](/files/-MKIXrhJINMclQMLnvaL)

* **單一事件出現：**&#x8ACB;完整截圖該事件的畫面，並從後台聯繫 Omnichat 線上客服
* **多個或所有事件出現：**&#x5C6C;於串接權限失效問題，請參考「[**如何排解權限失效狀態**](#ru-he-pai-jie-quan-xian-shi-xiao-zhuang-tai)」步驟

### 2. 出現整合錯誤

![](/files/-M0VYDbIZBaacsmKPSb3)

如果你看到上圖的錯誤提示，請先確認您的 Facebook 帳號是否已經擁有想要串接的 Facebook 專頁管理員權限。

### 3. 串接前，顧客與Facebook專頁的過往對話是否同步進到 Omnichat 後台中？

如果在您串接Facebook專頁到Omnichat以前，顧客已經與您產生過對話，串接後之前的這些對話是不會同步進來到Omnichat的。這是因爲Facebook原生後台並未開放回訊息回溯功能與權限給第三方系統廠商。但是在您串接後，顧客回覆您的對話都可以進到Omnichat後台中。

### 4. 串接後，若您在 Facebook 原生後台回覆顧客訊息是否進到 Omnichat 後台中？ <a href="#replyfbconinorgin" id="replyfbconinorgin"></a>

若您直接從 Facebook 原生後台 Messenger 收件夾回覆顧客，該回覆的訊息<mark style="color:red;">**不保證**</mark>能進到 Omnichat 的對話事件中，這是由於 Meta 官方針對第三方系統商分享對話資料經常有系統 Bug 導致該訊息無法正常出現在 Omnichat 後台，因此建議您非必要時<mark style="color:red;">**仍可以 Omnichat 系統端為主要回覆 Facebook 對話事件的平台**</mark>。

### 5. 串接FB廣告帳號是否會佔用到「社群渠道上限數」呢 <a href="#replyfbconinorgin" id="replyfbconinorgin"></a>

<mark style="color:red;">**不會。**</mark>社群渠道上限（例如支援多少個 FB Page / IG帳號 / WA 號碼）是針對訊息渠道設定的。<mark style="color:red;">**廣告帳號不是訊息渠道，不會佔用上限名額。**</mark>

### 6. 可以授權多個廣告帳號嗎？會衝突嗎？ <a href="#replyfbconinorgin" id="replyfbconinorgin"></a>

可以。Meta 容許品牌授權多個廣告帳號，Omnichat 也能支援，系統會依照客戶在 Omnichat 中選擇的廣告帳號進行受眾上傳與推播

### 7. 如果廣告帳號被封、被限制投放，會影響 Marketing Message 嗎？ <a href="#replyfbconinorgin" id="replyfbconinorgin"></a>

廣告帳號若失效，可能導致受眾上傳失敗、token 無法取得、Marketing Message 推播流程中斷等，因此品牌若發生廣告帳號被封，需要盡快替換為可用帳號。

***

## 如何排解權限失效狀態

{% hint style="info" %}
**權限失效原因**

Facebook 的授權會因為以下原因而失效，授權失效後會影響 Omnichat 系統的功能：

* 負責授權的 Facebook 用戶帳號更改密碼
* 負責授權的 Facebook 用戶帳號開啟了雙重驗證
* Facebook 偵測到用戶有異常行為，基於安全原因把授權取消
  {% endhint %}

### 一、重新授權

你可以根據以下步驟重新授權：

1. 登入 [Omnichat 後台](https://app.omnichat.ai/)
2. 在左側選單選擇 「**通訊渠道 >** [**社群帳號**](https://console.omnichat.ai/social-channels?tab=facebook-pages)」 *（點擊連結可直接進入團隊後台串接頁面）*
3. 打開 **Facebook Messenger 分頁**
4. 在**已串接的Facebook 專頁**，點擊 「**解除串接**」 把需要重新授權的 Facebook 專頁斷開連接
5. <mark style="color:$danger;">**新增「廣告帳號」，並連結 Facebook 粉絲專頁與廣告帳號**</mark>

<figure><img src="/files/ckVSH7s7cyYe2YEH6K0y" alt=""><figcaption></figcaption></figure>

6\. 斷開連接後，點擊 「**串接** **Facebook** 專頁」

<figure><img src="/files/Gx47Pe3qYJOcMnIyw6hy" alt=""><figcaption></figcaption></figure>

7\. 點擊 「**以** **OOO** **的身份繼續**」 完成重新授權

<figure><img src="/files/6x1PoWqDbKrXGNn0C1a4" alt="" width="563"><figcaption></figcaption></figure>

8\. 成功重新授權後， Facebook 專頁會列出，請勾選需要串接的 Facebook 粉專後點擊 「**串接**」。

<figure><img src="/files/PKUndIheMjWGLLKnYDWM" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
如果想要串接的專頁沒有出現，請回到 「第6步」 點擊下方 「**編輯設定**」 檢查是否有勾選想要串接的 Facebook 專頁及授權所有 Omnichat 要求的權限（如下圖）。

如果未跳出 「編輯設定」 ，請查看是否點擊 「**以** **OOO** **的身份繼續**」 後可至 「企業整合工具設定」 調整。
{% endhint %}

<figure><img src="/files/YcZETuLLjn6XVr6TUjtj" alt="" width="563"><figcaption></figcaption></figure>

### 二、更改 Facebook 粉絲專頁的訊息主要接收者

#### 若您為 **「舊版粉絲專頁」** 請參考此步驟，新版請往下繼續瀏覽。

1. 粉絲專頁設定 > 進階訊息

<figure><img src="/files/QW2YgGU26xZPgIqHupl3" alt=""><figcaption></figcaption></figure>

2. 找到交接通訊協定，並點擊 「Messenger reciever」 旁的設定按鈕

<figure><img src="/files/lObtR3gA5IMyeekx6ZML" alt=""><figcaption></figcaption></figure>

3. 將 「主要接收者」 設定成 Omnichat

<figure><img src="/files/gJuiGBMzhCPULIhszJiu" alt=""><figcaption></figcaption></figure>

#### 若您為 **「新版粉絲專頁」** 請參照下列圖文步驟

1. 管理粉絲專頁頁面 > 從右上角的頭像點擊 「設定與隱私」

<figure><img src="/files/00idkPTv1WDAWR6jCh7G" alt=""><figcaption></figcaption></figure>

2. 再點選 「設定」 > 選擇左側欄位的 **「🏳️ 粉絲專頁設定」**

<figure><img src="/files/JhS7SkGzqgU7NQmmJgu2" alt=""><figcaption></figcaption></figure>

3. 在粉絲專頁設定當中點選 「進階訊息」 右側的 **「查看」** 按鈕

<figure><img src="/files/xCL4oi7Ghz4wIiGBSuhS" alt=""><figcaption></figcaption></figure>

4. 頁面找到 「應用程式設定－交接通訊協定」 > 點擊 「Messenger 接收者」 右側的設定 > 選擇 「Omnichat」

<figure><img src="/files/eWRmcB5MUJMwn8Kf7Obg" alt=""><figcaption><p>「Messenger 接收者」 右側的設定</p></figcaption></figure>

<figure><img src="/files/Kp8Rw8z53qjZu32KVx0Y" alt=""><figcaption><p>選擇 「Omnichat」</p></figcaption></figure>

#### <mark style="background-color:red;">**若您的 「Messenger 接收者」 右側的設定反灰無法選擇（如下圖），請繼續往下看**</mark>

<figure><img src="/files/lgunsmsTLWyIu24ZgTJu" alt=""><figcaption></figcaption></figure>

### 三、設定 「Messenger 對話指派－預設轉送應用程式」

若 「Messenger 接收者」 右側的設定反灰無法選擇，請繼續往下看

1. 在左側列表，點擊 **「🏳️ 粉絲專頁設定」** ，選擇 「Messenger 對話指派」

<figure><img src="/files/WTb77bUaFEDTyDwbfDSn" alt=""><figcaption></figcaption></figure>

2. 在 「預設轉送應用程式」 點擊 「設定」

<figure><img src="/files/J9Vqmr9rUS6wmMH1KQJl" alt=""><figcaption></figcaption></figure>

3. 選擇 **Omnichat**

<figure><img src="/files/hcPgkbtYqxDzxDklUBcT" alt=""><figcaption></figcaption></figure>

4. **「預設轉送應用程式」** 設定完成畫面。

<figure><img src="/files/fvKbaHdLgWUwvKE4zuJ8" alt=""><figcaption><p>「預設轉送應用程式」 設定完成畫面。</p></figcaption></figure>

## 串接失敗之後台自動錯誤提示

{% hint style="info" %}
系統每小時會判斷一次串接是否有效，若串接失效會寄信通知，並在後台提示錯誤。
{% endhint %}

<figure><img src="/files/OcXD2ytnFHguPtJMHqjQ" alt=""><figcaption></figcaption></figure>

**渠道串接失效信件**

* 失效後只會寄出**一封**提醒信。
* 團隊方案已結束的客戶將不會收到信件。
* 失效原因及如何重新授權請參考[此處說明](#id-1.-chong-xin-shou-quan)。

<figure><img src="/files/MaRhpH9CHNQllT5JIniF" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.omnichat.ai/features/tong-xun-qu-dao/integrations/facebook-messenger.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.