# 连接 WhatsApp

> 通过 QR 码绑定您的 WhatsApp 号码，管理多个号码并排除连接问题。

Source: https://waslo.io/zh-CN/docs/connecting-whatsapp · Last updated: 2026-10-16

> WhatsApp 是最常见的入门渠道，但只是六大渠道之一。如果客户更多通过 Telegram、Instagram、Messenger 或邮件联系你，请参考 [集成](/docs/integrations) 文档。

## 三种 WhatsApp 连接方式

| 方式 | 如何连接 | 手机上的应用还能用吗？ | Meta 收费 | 适合场景 |
|------|----------|------------------------|-----------|----------|
| **Waslo QR** | 在 WhatsApp → 已关联的设备中扫描 QR 码 | 能 | 无 | 默认选项——快速，无需 Meta 审核手续 |
| **官方 QR（WhatsApp Business 应用）** | 先在 Meta 的窗口中操作，再用 WhatsApp Business 应用扫码 | 能 | 按 AI 代理发送的每条消息收费 | 你想用 Meta 官方 API，**同时**继续在 Business 应用里聊天 |
| **WhatsApp Cloud API** | 在 Meta 的窗口中接入一个新号码 | 不能——该号码只在 API 上运行 | 按 AI 代理发送的每条消息收费 | 专用号码、消息模板、大批量群发 |

Waslo QR 方式是一种类似 WhatsApp Web 的多设备连接——与你在笔记本电脑上关联设备时使用的会话相同。它不是 Meta Business API 集成。官方 QR 和 Cloud API 都运行在 Meta 官方的 WhatsApp Business 平台上。

**一个号码只能用一种方式连接。** Waslo 不允许同一个号码同时通过 Waslo QR 和官方 QR 或 Cloud API 连接——否则两个连接会同时回复每一位客户。请先从一种方式断开，再通过另一种方式连接。

## 连接您的第一个号码

1. 前往**仪表板 → 集成**
2. 点击**添加号码**
3. 给这个号码起一个你认得出的名字（例如“前台”），然后点击**连接**
4. 在手机上打开 WhatsApp → 设置 → 已关联的设备 → 关联设备
5. 扫描 Waslo 中显示的 QR 码
6. 等待几秒钟 — 您的状态将变为**已连接**

二维码在屏幕上会自动刷新。如果大约两分钟没有扫描，请点击**重新连接**并扫描新的码。关联成功后，您的电话号码将显示在仪表板中，AI 代理会立即开始回复。

**首次同步。** 刚关联完成时，联系人较多的账号会与 WhatsApp 同步几分钟。号码卡片会显示 **正在与 WhatsApp 同步：已同步 N 位联系人**，并提示：“AI 代理已经在回复客户。同步完成前请勿解除关联或重新扫描此号码，通常需要几分钟。”在提示消失前请不要操作该号码：同步中途解除关联或重新扫描，可能导致已关联的设备无法读取消息，直到重新关联该号码。

## 连接你的 WhatsApp Business 应用（官方 QR）

保留你在 WhatsApp Business 应用中已在使用的号码，继续在手机上聊天，同时让 AI 代理通过 Meta 官方 API 回复。

1. 将 WhatsApp Business 应用更新到 **2.24.17 或更高版本**
2. 在 Waslo 中：**集成 → WhatsApp Official API → 连接我的 WhatsApp Business 应用**（引导向导中也提供此选项）
3. 在 Meta 的窗口中，选择连接你**现有的 WhatsApp Business 应用**，并按步骤操作
4. 用手机上的 WhatsApp Business 应用扫描 Meta 显示的代码
5. 号码会带着 **Business 应用** 标记出现

连接完成后，Waslo 会立即向 Meta 请求你应用中的联系人以及最多 **180 天的聊天记录**。旧聊天会作为历史记录进入你的收件箱：AI 代理不会回复它们，也不会为此收费。Meta 只允许在连接后 24 小时内发起一次这样的请求。

**连接期间：**
- 你可以随时在 Business 应用中回复。你的回复会显示在 Waslo 的对话中，并**暂停该客户的 AI 代理**。应用自带的自动问候语和离开消息不会暂停它。
- 群组、限时消息、一次性查看消息和广播列表都留在应用中——AI 代理看不到它们。
- Meta 将共享号码的发送上限设为每秒 20 条消息。

如果 Meta 的窗口连接的是普通号码而不是你的 Business 应用（如果你在那里选了其他选项，就可能发生这种情况），Waslo 会提示你。重新打开窗口并选择 Business 应用即可。

## 通过 Cloud API 连接

适用于专用号码、模板营销或大量消息：

1. 在 Waslo 中：**集成 → WhatsApp Official API → 使用 WhatsApp 连接**
2. 按照 Meta 窗口的提示：选择或创建你的企业、WhatsApp Business 账户和号码
3. 号码显示为**已启用**

按钮下方的**高级设置（手动）**也可以改为填写 WABA ID、电话号码 ID 和访问令牌，适用于通过你自己的 Meta 应用设置的号码。

官方 WhatsApp 连接（Cloud API 或官方 QR）在两种方案中均已包含，无需开通费。

## 用于提醒、预约提醒和跟进的现成模板

客户最后一条消息发出 24 小时后，Meta 只允许官方号码发送它批准过的模板。每个官方号码都有一张**现成模板**卡片，其中有三个只需提交一次的模板：

| 模板 | 让该号码可以发送的内容 | Meta 费率 |
|------|------------------------|-----------|
| **团队提醒** | 在未连接任何 Waslo QR 号码时，向**设置 → 通知**中的 WhatsApp 号码发送操作员提醒 | 实用类（utility） |
| **预约提醒** | 向通过该号码预约的客户发送 24 小时提醒 | 实用类（utility） |
| **跟进消息** | 跟进功能开启时，向该号码上沉默的潜在客户发送自动跟进 | 营销类 |

点击**查看并提交**，检查文本和语言，然后提交给 Meta。卡片会显示每个模板的状态——审核中、已批准，或已拒绝并附上 Meta 的理由——点击**检查状态**即可刷新。你可以修改措辞，但请保留双大括号中的占位符，并在第一个占位符之前和最后一个占位符之后保留文字；否则 Meta 会拒绝。

## Meta 的收费（官方 QR 和 Cloud API）

通过 Meta API 发送的消息由 Meta 直接向你自己的 WhatsApp Business 账户收费——Waslo 不转售，也不加价。自 **2026 年 10 月 1 日**起：

- AI 代理发送的每条回复都由 Meta 收费，按每条送达的消息、以 Meta 针对你客户所在国家的费率计费。
- 客户通过点击跳转 WhatsApp 广告联系你后开始的 72 小时免费窗口内，消息仍然免费。
- 你自己在 WhatsApp Business 应用中输入的消息免费。
- 请在你的 WhatsApp Business 账户上保留一种付款方式，否则 Meta 会停止投递 AI 代理的回复。

Waslo 会在**设置 → 账单**以及 WhatsApp Official API 标签页上同步显示 Meta 的收费情况——总额、按消息类型和按客户国家的明细，每 30 分钟更新一次。同一卡片上的**查看 Meta 价格**会打开 Meta 的费率表。Waslo QR 方式没有 Meta 收费。

## 多个 WhatsApp 号码

无论 PAYG 还是 Growth，都可以连接多个 WhatsApp 号码：

| 方案 | 最大号码数 |
|------|-----------|
| PAYG | 免费 1 个，额外号码每个 1,500 积分（一次性），最多共 10 个 |
| Growth | 包含 3 个，最多可达 10 个——第 3 个之后每个号码一次性 1,500 积分 |

添加其他号码：
1. 前往**仪表板 → 集成**
2. 点击**添加号码**
3. 为其添加标签（例如"销售"、"客服"）
4. 使用不同的手机扫描 QR 码

在 PAYG 和 Growth 上，每个号码都可以拥有独立的 AI 配置（自定义提示词、分类规则、跟进策略、转人工关键词），通过 **AI Agent** 里的 Context Selector 设置——这不是 Growth 专属功能。你也可以在人格设置页面为任意单个号码关闭**"此号码上的 AI 智能助理自动回复"**开关——AI 只会停止在那个号码上自动回复（消息仍会保存并同步到 CRM），你其他的号码和渠道照常工作。

## 连接状态

您的 WhatsApp 连接可能处于以下状态之一：

- **已连接** — 活跃并接收消息
- **正在连接** — 正在建立连接（可能需要最多 60 秒）
- **扫描二维码** — 等待您扫描 QR 码
- **已断开** — 未连接，需要重新连接
- **已登出** — 会话已登出，需要重新扫描 QR 码

二维码显示期间，WhatsApp 会自动更换它。若约两分钟内未扫描，二维码会过期，号码卡片会提示：点击**重新连接**并扫描新的二维码。

## 自动重连

Waslo 自动监控您的连接，如果会话意外断开将尝试重新连接。此检查每 2 分钟运行一次，因此短暂的断开会自动处理。

## 故障排除

**QR 码未显示？**
- 刷新页面并重试
- 检查您的网络连接

**连接持续断开？**
- 确保您的手机有稳定的网络连接
- 不要在手机上退出 WhatsApp
- 避免将过多设备关联到同一个 WhatsApp 号码

**显示已连接，但收不到新消息？**
- 如果已连接的号码持续无法读取收到的消息，Waslo 会发邮件通知您
- 解决方法：点击该号码卡片上的**断开连接**，然后重新连接——无需新的二维码
- 只有在消息仍然收不到时：使用**退出**清除会话，然后扫描新的 QR 码重新关联该号码

**"被封禁"状态？**
- WhatsApp 可能会限制发送消息过快的账户
- 联系 WhatsApp 支持以解决账户限制
- Waslo 包含内置的速率限制以防止此问题

## 在 Waslo QR 和官方 QR 之间切换

1. 在号码当前所在的方式中断开它（点击其卡片上的**断开连接**）
2. 如果要完全退出官方 QR：在 WhatsApp Business 应用中前往**设置 → 账户 → 商业平台**并断开连接
3. 通过另一种方式连接该号码

客户仍是同一个潜在客户。新消息会在新方式下开启新的对话，旧对话仍保留在收件箱中。为 **WhatsApp Cloud** 渠道设置的提示词和知识库设置不会沿用到 Waslo QR 号码上，Waslo QR 号码使用你的工作区设置或按号码设置。

## 断开连接

要断开一个号码的连接：
1. 前往**仪表板 → 集成**
2. 点击号码旁边的**断开连接**按钮
3. 会话将被保存 — 您可以稍后重新连接，无需扫描新的 QR 码

要完全移除一个号码（清除所有会话数据），请使用**退出**，它位于号码卡片上**断开连接**的旁边。