> For the complete documentation index, see [llms.txt](https://aican.gitbook.io/aican/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aican.gitbook.io/aican/getting-started/integrations/messenger.md).

# Messenger

## 简介

Messenger 第三方平台串接到客服系统是以 **Messenger Platform API** 进行授权与通讯。\
串接完成即可以在AICAN后台查看、处理来自公共主页的访客讯息，并由客服人员统一回复访客的问题。

本章节说明如何将 **Facebook Messenger** 串接至 AICAN后台 ，并取得系统所需的串接资讯。**自行串接 Facebook 公共主页 Messenger 私讯功能**。

***

## 一、操作前准备工作：

在开始前，请确认您已具备以下条件：

* 一个可正常登录的 **Facebook 个人帐号**
* 一个已建立的 **Facebook 公共主页**
* 您对该公共主页拥有 **管理员权限**

> 📌 **说明：**Messenger 私讯功能必须绑定 Facebook 公共主页，无法单独使用。

***

## 二、申请步骤1：Meta Business Suite 平台添加公共主页

### Step 1：建立或登录 Meta Business Suite**（MBS）**

{% hint style="success" %}

#### 📌 什么是 Meta Business Suite（MBS）

Meta Business Suite 是 Meta 提供的**企业管理后台**，用于统一管理：

* Facebook 粉丝专页
* Instagram 帐号
* Messenger
* WhatsApp（商业帐号）
* 应用程式、广告帐户、系统用户等资产

📌 **Messenger / WhatsApp 串接文字客服平台时，通常必须先建立。**
{% endhint %}

#### **使用 Facebook 个人帐号登录 Meta Business Suite**

请使用您本人的 Facebook 个人帐号，登录 [Meta Business Suite 平台](https://business.facebook.com/)

> 📌 **说明：**Meta 要求所有企业资产，必须由真实的 Facebook 个人帐号建立与管理。

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

***

### Step 2：选择您的业务资产组合。

1. 若您是首次使用 Meta 商业工具 → 请选择 **「创建业务资产组合（Business Portfolio）」**
2. 若公司已有「业务资产组合」 → 可直接选择使用现有的资产组合行下一申请步骤

> 📌 **说明：**「业务资产组合」即原本的 **商业帐号（Business Manager），**&#x4E00;个公司通常只需建立 **一个** 业务资产组合。

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

***

### Step 3：添加Facebook公共主页

若已存在→点击左侧页下方【![](/files/AKVe1CpOlixeudn8YLEw)】开启「设置」>「公共主页」>页面右上角点击【添加】，添加现有的Facebook公共主页或是新建Facebook公共主页。

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

{% hint style="warning" %}

#### 【重要说明】Meta Business Suite 与 Meta Developer 的关联

在串接 Messenger 前，请务必先在 **Meta Business Suite（MBS）** 中建立或添加 Facebook 公共主页。

这是必要步骤，原因如下：

* Facebook 公共主页必须先成为公司资产
* Meta Developer 平台只能绑定「您已拥有管理权限的粉丝专页」
* 若未先在 MBS 中完成设置，应用将无法正常取得 Messenger 权限
  {% endhint %}

简而言之，两者缺一不可：

> **MBS 负责「拥有与管理公共主页」**\
> **Meta Developer 负责「让系统使用公共主页的 Messenger」**

***

## 三、申请步骤2：Meta Developer 平台绑定公共主页

### Step 1：进入 Meta Developer 平台

1. 使用 Facebook 个人帐号登录 [Meta开发人员平台](https://developers.facebook.com/apps/)
2. 若是第一次使用，系统会引导您启用开发者身份\
   → 依画面点击「继续」即可（不需填写复杂资料）

> 📌 **为什么要做这一步？**&#x4D;essenger API 的所有串接设置，必须透过「应用（App）」来完成。

***

### Step 2：在 Meta Developer 平台绑定公共主页

#### 若您尚未建立应用请依下方步骤建立后，绑定公共主页

1．进入【我的应用】→点击【创建应用】

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

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

２．创建应用步骤(依画面填写)：

* 应用名称（可自订，例如：公司名称 ）
* 关联的业务资产组合
* 应用类型请选择：**「业务」**

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

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

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

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

３．建立完成后，即可进入应用后台启用 Messenger 并绑定公共主页

> 📌 只有启用 Messenger 后，应用才能收发公共主页私讯；此应用将作为 **文字客服平台与 Messenger 沟通的桥梁**。

> 📌 **注意事项：**
>
> * 您必须是该公共主页的管理员
> * Messenger 对话将全部来自此公共主页

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

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

***

#### **若您已经拥有应用，使用既有应用绑定公共主页**

１．进入 [Meta Developer 平台](<https://developers.facebook.com/apps/ 	>)，选择既有应用

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

２．添加 **Messenger**，并绑定 Facebook 公共主页

> 📌 只有启用 Messenger 后，应用才能收发公共主页私讯；所有 Messenger 对话都会通过该公共主页进行。

> 📌 **注意事项：**
>
> * 您必须是该公共主页的管理员
> * Messenger 对话将全部来自此公共主页

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

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

***

## 四、申请步骤3：将应用模式调整为上线

列表 「应用设置」>「基本」 进行以下设置。

#### ①隐私政策网址

该网址用于说明平台如何收集、使用及保护用户资料，是应用程式审核与上线的必要项目。

请向 **平台搭建人员** 索取正确的隐私政策网址，并将其填入指定栏位中。

#### ②类别

选择 【Messenger 商家智能助手】

#### ③应用图标

当您在 Meta 开发人员平台将应用程式切换为「上线」状态时，必须设置 **应用图标**。\
该图标将用于识别您的应用程式，并会显示在授权画面与相关应用资讯中，方便用户辨识应用来源。

> **图标设置说明**
>
> * 支持格式：JPG、GIF 或 PNG
> * 图片尺寸：介于 **512 × 512** 至 **1024 × 1024** 像素
> * 文件大小：不可超过 **5 MB**
>
> 请确认图标已正确上传并符合规格，否则应用程式将无法顺利上线或通过审核。

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

以上完成后点击右下【保存更改】就可以**应用模式**调整为上线。

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

***

## 五、申请步骤4：取得公共主页访问口令

前往 「Messenger」 → 「Messenger API 设置」→点击【生成】产生访问口令

点击复制产生的口令 (Page Access Token)

> 📌 此口令用于让 AICAN后台 可以代表公共主页「收发讯息」。

{% hint style="danger" %}
「口令」生成后<mark style="color:red;">**只会出现一次**</mark>，要记得留存；如果没有留存就需要重新点击生成新口令。
{% endhint %}

<figure><img src="/files/2CFz78GQlW3Ofe7QqfLB" alt=""><figcaption></figcaption></figure>

***

## 六、申请步骤5：授权应用存取公共主页

{% hint style="info" %}

#### 📌 **重要先说明（Messenger 串接的必要条件）**

若未启用 **`pages_manage_metadata` 权限**，将会出现以下问题之一：

* ❌ AICAN后台 **收不到 Messenger 访客讯息**
* ❌ 出现提示：无法订阅 Messenger Webhook
* ❌ 公共主页无法正常与系统串接
  {% endhint %}

### 方法一（正式标准做法）：在 Meta Developer 平台启用权限

#### ✅ **适合正式上线、长期使用（推荐）**

***

为了让应用程式在正式环境中长期使用 Messenger 功能，Meta 需要确认你的应用确实用于企业业务。\
因此必须提交 **应用审核（App Review）**。以下为简化的审核流程：

承接上面申请步骤一\~五后，进行下面的操作。

#### **步骤 1：准备应用资讯**

在 [Meta 开发者后台](https://developers.facebook.com/apps/)填写必要资讯，包括：

* 应用说明
* 隐私权政策网址
* 使用权限目的（说明为何需要 pages\_manage\_metadata）

#### **步骤 2：录制测试流程影片**

Meta 会要求你提供一个操作影片或截图，清楚展示：

* 用户如何授权应用
* 应用如何读取公共主页资讯
* 权限的实际使用方式（仅展示需要   **`pages_manage_metadata`**  的操作）

#### **步骤 3：提交审核申请**

填写权限使用说明 → 上传示范影片 → 提交审核。

#### **步骤 4：Meta 审核**

Meta 审核人员会确认：

* 权限是否用于合法商业用途
* 流程是否与描述一致
* 应用是否没有超范围使用权限

#### **步骤 5：审核通过并可配置上AICAN后台正式使用**

审核通过后：

* 你的应用即可在正式环境使用 Messenger API
* &#x20; **`pages_manage_metadata`**  权限将正常启用
* 系统即可稳定读取设定、接收 Webhook、处理对话

{% hint style="warning" %}

#### 📌 提醒

审核时间不固定，可能需要**数天**，请耐心等待。
{% endhint %}

***

### 方法二（快速工具方式）：使用 Meta 工具

承接上面申请步骤一\~五后，进行下面的操作。

1. 进入 [访问口令调试工具](https://developers.facebook.com/tools/debug/accesstoken)
2. 选择 【访问口令】 ，贴上获取的口令，点击【调试】按钮。
3. 点击 【调试】 按钮后，就会出现 【访问口令】 信息，这里会出现应用编号、类型、公共主页编号、应用范围内用户编号、认证日期、到期日…等资讯。

#### 要检查的重点为以下这些，可参考下方图片：

* 应用编&#x53F7;**：**&#x6CE8;意该口令提供哪个Facebook应用程式使用。
* 到期&#x65E5;**：**&#x5230;期日需为「**禁止**」。
* 范围：查看是否具备  **`pages_manage_metadata`**  权限。

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

若没有   **`pages_manage_metadata`**  权限，需要操作以下步骤：

到 [图谱 API 探索工具](https://developers.facebook.com/tools/explorer/)新增权限。

1. 栏位内填入「口令」
2. 权限栏位新增 **`pages_manage_metadata`** 权限
3. 点击上方蓝色【Generate Access Token】按钮产生Access Token。

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

完成后再进入 [访问口令调试工具](https://developers.facebook.com/tools/debug/accesstoken)再度填入口令确认。

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

***

### 📌 重要权限说明（请务必确认）

在此步骤中，请务必确认已启用以下权限：

✅ **`pages_manage_metadata`（必要）**

此权限用于让 AICAN后台 系统：

* 正常接收 Messenger 访客讯息
* 正常发送回复讯息
* 订阅并接收公共主页的讯息事件

📌 若未启用此权限，可能会导致：

* 系统无法接收 Messenger 讯息
* 看似已串接成功，但无法正常使用
* 客户讯息不会进入客服后台

{% hint style="danger" %}

#### 请务必在授权画面中确认已允许该权限。

{% endhint %}

***

## 七、配置上AICAN后台

完成以上设置后取得资讯到 AICAN后台 上进行串接；系统串接会需要以下资讯：

1. **应用编号**
2. **应用密钥**
3. **口令**

> 📌 这些资讯通常依照下面指示复制提供

***

### ① 应用编号+②应用密钥

进入[Meta开发人员平台](https://developers.facebook.com/apps/)后台>「应用设置」>「基本」

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

### ③ 口令（Page Access Token）

#### **取得方式：**

1. [Meta开发人员平台](https://developers.facebook.com/apps/)后台>「Messenger」>「Messenger API 设置」页面
2. 针对已绑定的公共主页生成口令 （Page Access Token）
3. 复制该口令

{% hint style="danger" %}
「口令」生成后<mark style="color:red;">**只会出现一次**</mark>，要记得留存；如果没有留存就需要重新点击生成新口令。
{% endhint %}

> 📌 说明：此口令决定系统是否能「真的帮您回讯息」。

<figure><img src="/files/8DcDaZD9GIgx403oFkfv" alt=""><figcaption></figcaption></figure>

***

将以上获得的资讯依序填入 **AICAN 后台** 内：

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

完成步骤后，访客在 **Facebook Messenger** 中发送的消息，即可通过该 **Messenger 渠道** 同步至 **AICAN 后台；**&#x5BA2;服人员可在 AICAN 后台中 **接收并回复访客消息**。

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

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

***

#### 或是确认 【配置Webhook】&#x20;

配置完成后，可以到 [Meta开发人员平台](https://developers.facebook.com/apps/)后台>「Messenger」>「Messenger API 设置」页面【配置Webhook】 内确认是否绑定成功；绑定成功会栏位内自动生成网址。

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

***

## 八、Messenger 使用规则说明（请务必阅读）

### 📌 Messenger 重要限制：

* **访客必须先发送第一则讯息**
* 企业只能在 **24 小时内回复**
* 超过 24 小时将无法主动发送讯息

### 📌 其他说明：

* Messenger API **不需要 WhatsApp 商业帐号**
* Messenger 与 WhatsApp 是两套独立串接流程
* 若功能需正式上线，可能需要提交 Meta 审核

***

## 九、群发讯息

#### 路径：「设置」→「群发讯息」→【新增群发讯息】

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

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

***

## 十、常见问题

### Q1. 访客发讯息，爱挚能后台收不到的可能性

#### ❌ 开发人员平台上应用模式未切换为上线

* [Meta Developer 平台](https://developers.facebook.com/apps/) 上的应用模式未切换为上线
* 未启用  **`pages_manage_metadata`** 权限
* 公共主页未正确绑定应用
* 使用了错误的公共主页存取口令

✅ 解决方式：

* 在 [Meta Developer 平台](https://developers.facebook.com/apps/) 确认是否绑定应用，将应用模式切换为上线。
* Meta工具确认权限是否取用。
* 重新产生公共主页存取口令重新配置上 AICAN后台。

***

### Q2.AICAN 串接常见失败原因说明(开发人员平台上设置)

#### ❌ 常见口令存取失败原因：产生权杖后仍无法使用

* 使用的是「用户权杖」而非「公共主页存取口令」
* 口令过期，需重新产生

✅ 解决方式：

* 「公共主页存取口令」在 [Meta Developer 平台](https://developers.facebook.com/apps/) 取得。

***

#### ❌ 常见取得口令问题：应用找不到公共主页

* Facebook 帐号不是公共主页管理员
* 公共主页未加入商业管理平台

✅ 解决方式：

* 确认该 Facebook 帐号在公共主页中是「管理员」。
* [Meta Developer 平台](https://developers.facebook.com/apps/)后台>「新增产品」页面启用 Messenger。

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://aican.gitbook.io/aican/getting-started/integrations/messenger.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.