> 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/whatsapp.md).

# WhatsApp

## 简介

WhatsApp第三方平台串接到客服系统是以 WhatsApp Business API 进行串接，串接完成即可以在AICAN后台查看、回复个别客户与群组里的客户问题。

{% hint style="danger" %}

#### **无法使用手机登录 App**

WhatsApp Business API 核心功能是实现多客服协作、系统集成和自动化，所以不能使用手机登录 App。
{% endhint %}

***

## 一、操作流程准备工作：

在开始前，请确认您已准备好：

* 一个可正常登录的 **Facebook 个人帐号**
* 公司合法的营业资料（用于企业验证）
* 一组 **尚未注册 WhatsApp 的手机号码**
* 一张可线上付款的信用卡（用于后续计费设置）

> 📌 提醒：\
> WhatsApp Business API 是**官方企业级服务**，不能直接使用个人 WhatsApp 帐号。

{% hint style="warning" %}

#### 手机号码重要规则<mark style="color:red;">（请务必确认）</mark>

* 此手机号码 **不能** 已注册普通 WhatsApp
* 也不能已注册 WhatsApp Business App
* 若曾使用过，需先解除绑定后才能使用，解除绑定后大约需要 **几分钟到数小时** 才能重新激活。
  {% endhint %}

***

## 二、申请步骤1：建立 Meta Business Suite（MBS）

业务资产组合是 Meta 用来管理公司 WhatsApp、Messenger 与系统串接的核心管理空间，首次使用 Meta 的客户必须先建立。

{% hint style="success" %}

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

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

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

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

### Step 1：建立或登录 Meta Business Suit&#x65;**（MBS）**

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

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

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

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

### Step 2：**建立新的「业务资产组合」（商业帐号）**

#### 若您是首次使用 Meta 商业工具 → 请选择 **「创建业务资产组合（Business Portfolio）」**

→ 填写公司基本资料(依画面填写以下公司信息)：

* 公司名称（法定或正式使用名称）
* 公司地址
* 官方网站（如有）

> 📌 提醒：此处填写的公司资料，将作为后续 **企业验证** 与 **WhatsApp 商业帐号审核** 的参考依据。

#### 若公司已有业务资产组合 → 可直接选择使用现有的资产组合行下一申请步骤

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

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

请依画面填写以下公司信息：

* 公司名称（法定或正式使用名称）
* 公司地址
* 官方网站（如有）

> 📌 提醒：此处填写的公司资料，将作为后续 **企业验证** 与 **WhatsApp 商业帐号审核** 的参考依据。

***

### Step 3：企业验证（Business Verification）

在成功新增 **WhatsApp 商业帐号（WABA）**&#x540E;，系统会要求您完成「企业验证」。\
这是 Meta 用来确认您公司真实性的重要步骤。

#### 为什么需要进行企业验证？

* 确认该 WhatsApp 商业帐号属于**真实合法的公司**
* 提升 WhatsApp API 的使用权限与消息发送额度
* 后续若要申请官方商业帐号（蓝勾），**必须完成企业验证此步骤**

***

#### 企业验证操作说明

1. 在[ **Meta Business Suite（MBS）**](https://business.facebook.com/)中，进入「设置」
2. 找到「业务信息」查看公司验证详情 或「安全中心」
3. 依画面指示填写以下公司资料：
   * 公司法定名称（需与营业文件一致）
   * 公司地址
   * 公司网站（若有）
4. 上传公司证明文件（如营业执照或公司登记证明）
5. 提交后，等待 Meta 审核结果

📌 审核时间说明：

* 通常需数个工作天
* 审核期间不影响您继续进行其他设置步骤

📌 提醒：

* 请务必确保填写资料与上传文件内容一致
* 若资料不符，验证可能会被退回并要求重新提交

<figure><img src="/files/0XdbNPuzqdDEszzr8qK5" alt=""><figcaption></figcaption></figure>

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

***

## 三、申请步骤2：开启 Meta Developer 平台（建立应用）

完成 WhatsApp 商业帐号与企业验证后，下一步是建立「应用（App）」，让系统可以正式与 WhatsApp 官方平台进行串接。

***

### Step 1：登录 Meta Developer 平台

1. 使用同一个 **Facebook 个人帐号**
2. 前往 [**Meta Developer 平台**](https://developers.facebook.com/apps/)&#x20;
3. 若是第一次使用：
   * 依画面指示启用「开发者身份」
   * 同意相关使用条款即可

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

***

### Step 2：建立应用（App）

#### 若您尚未建立应用请依下方步骤建立：

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>

３．建立完成后，即可进入下一步骤 →  [在应用中启用 WhatsApp](#step-3-zai-ying-yong-zhong-qi-yong-whatsapp-gong-neng)。

***

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

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

２．即可进入下一步骤 → [在应用中启用 WhatsApp。](#step-3-zai-ying-yong-zhong-qi-yong-whatsapp-gong-neng)

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

***

### Step 3：在应用中启用 WhatsApp 功能

* 在产品列表中新增 **WhatsApp**，该应用与您的 **WhatsApp 商业帐号（WABA）** 进行关联

<figure><img src="/files/9zHMd2MEPr6LGr9KiLNG" alt=""><figcaption></figcaption></figure>

***

### Step 4：将应用模式调整为上线

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

#### ①隐私政策网址

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

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

#### ②类别

选择 **「Messenger 商家智能助手」**

#### ③应用图标

当您在 Meta 开发人员平台将应用程式切换为「上线」状态时，必须设置 **应用图标**。

该图标将用于识别您的应用程式，并会显示在授权画面与相关应用资讯中，方便用户辨识应用来源。

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

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

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

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

***

应用模式调整为上线后，就可以在 「WhatsApp」>「API设置」 页面中产生临时口令并使用页面上的测试号码发消息测试。

{% hint style="warning" %}

#### **使用测试号码时，**<mark style="color:red;">**必须先验证接收者的电话号码**</mark>，并将该号码<mark style="color:red;">**加入接收者列表**</mark>，完成后才能进行消息发送测试。

{% endhint %}

<figure><img src="/files/89HhBzTlOfIrhPbZ2pXG" alt=""><figcaption></figcaption></figure>

***

### WhatsApp 测试号码说明

在使用 WhatsApp 测试号码进行消息发送时，请注意以下限制与操作要求：

1. **测试收件的号码需主动发起对话**\
   测试号码仅支持访客在 WhatsApp 中搜索联系人并主动发送消息，以启动与系统的对话流程。
2. **无法接收系统发送的 Webhook 回调**\
   使用测试号码时，系统无法接收由平台返回的 Webhook，因此不会生成相关回调数据。
3. **需将测试收件的号码加入收件人并完成验证后发送一次 API**\
   为确保系统能够成功识别访客并建立初始会话，请将访客的电话号码加入收件人字段，完成号码验证后，再手动发送一次 API 消息。

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

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

***

## 四、申请步骤3：MBS 平台设置系统管理权限

### Step 1：业务资产组合>用户>新增系统用户

至[Meta Business Suite (MBS) 平台](https://business.facebook/) ；开启 **「应用」>「系统用户」** 页面添加人员。

若「系统用户」内已有人员，可直接进入下一步 → MBS 「应用」中添加指定人员 。

<figure><img src="/files/3xfjFsJos3iqagqJs5fy" alt=""><figcaption></figcaption></figure>

> 📌 提醒：管理员系统用户(Admin)只能够存在一位，若之前已创建过就会无法再创建。

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

***

### Step 2：添加应用权限人员

在 **「帐户」>「应用」** 中，添加指定人员，并授予其完整控制权限，以确保可正常管理与操作应用。

完成后即可进入下个步骤 → [生成口令](#step-3-sheng-cheng-kou-ling-zheng-shi)。

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

***

### Step 3：生成口令(正式)

1．**「用户」>「系统用户」** 页面，选择用户后在右上方点击【生成口令】按钮生成口令。

2．选择「应用」；选择您在需要生成口令的「应用」。

3．口令有效期选择【永不】

4．授与权限：输入 Business，将以下权限勾选后生成口令。

* <mark style="color:purple;">business\_management</mark>&#x20;
* <mark style="color:purple;">whatsapp\_business\_messaging</mark>&#x20;
* <mark style="color:purple;">whatsapp\_business\_management</mark>&#x20;
* <mark style="color:purple;">whatsapp\_business\_manage\_events</mark>

5．以上步骤完成后就可以产生口令。

{% hint style="warning" %}

#### 产生口令时，账号若还未进行验证，需先进行验证

验证码会寄送到电子邮箱内，取得验证码后填入验证就可以产生口令完成。
{% endhint %}

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

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

***

## 五、配置上AICAN后台

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

1. **WhatsApp Business 业务账户编号（WABA ID）**&#x20;
2. **应用编号**
3. **应用密钥**
4. **口令**

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

### ①**WhatsApp Business 业务账户编号（WABA ID）**&#x20;

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

<figure><img src="/files/0ojvyqQoEBCvpPer8oBN" alt=""><figcaption></figcaption></figure>

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

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

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

#### ④口令

[Meta Business Suite (MBS) 平台](https://business.facebook/)后台设置>「系统用户」页面中获得。

👉[点我查看如何生成口令](#step-3-sheng-cheng-kou-ling-zheng-shi)

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

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

***

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

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

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

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

***

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

配置完成后，可以到 [Meta开发人员平台](https://developers.facebook.com/apps/)后台>「WhatsApp」>「API设置」> 【配置Webhook】 内确认是否绑定成功。

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

***

## 六、群发讯息

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

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

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

***

## 七、常见问题

### Q1. 访客发讯息，IM收不到的可能性

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

✅ 解决方式：

* &#x20;应用模式未切换为**上线**
* 若是「测试电话号码」，需将访客**加入收件人电话号码清单**，并透过API传送过讯息

***

### Q2.WhatsApp 号码常见失败原因说明

（常见失败原因与错误排查）

在新增 WhatsApp 使用号码时，若遇到失败，通常是以下原因之一：

#### ❌ 号码已注册 WhatsApp App

* 该号码曾用于：
  * 普通 WhatsApp
  * WhatsApp Business App

✅ 解决方式：

* 先在手机上将该号码从 WhatsApp App 中**删除或解除注册**
* 等待一段时间后(几分钟到几小时不等）才能在新应用或 API 中重新注册，再重新进行 API 号码注册

***

#### ❌ 无法接收验证码

* 手机号无法接收 SMS
* 或语音电话被阻挡

✅ 解决方式：

* 确认号码可正常接收国际短信或电话
* 改用「语音验证码」方式尝试

***

#### ❌ 企业验证未完成

* 部分帐号在未完成企业验证前，会被限制号码注册

✅ 解决方式：

* 先完成 **企业验证（Business Verification）**
* 审核通过后再重新尝试

***

#### ❌ 号码重复使用或异常

* 同一号码被多次尝试注册
* 或短时间内重复操作

✅ 解决方式：

* 等待一段时间（通常 24–48 小时）
* 再重新进行注册流程

{% hint style="warning" %}

#### 📌 小提醒

若持续失败，建议不要重复操作太多次，以免被系统暂时锁定。
{% endhint %}

***


---

# 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/whatsapp.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.