WhatsApp 账号接入详解：Business App 与个人版支持范围、扫码配对及协议连接边界
支持 WhatsApp Business App 和 WhatsApp Messenger（个人版）账号，推荐 Business App。通过 WAthink 提供的 WhatsApp 协议连接接入，不提供 WhatsApp Business Platform（Meta 官方 API）接入。
本篇内容
概览
WhatsApp 是 WAthink 的主要沟通渠道。支持 WhatsApp Business App 和 WhatsApp Messenger（个人版）账号，推荐使用 Business App 开展客户沟通。这些账号统称为 WhatsApp 应用账号（Business App / 个人版），通过扫码或配对码完成 WhatsApp 协议连接。团队收件箱、营销活动、广播、流程、自动回复与模板按当前连接与功能权限使用。账号在 Channels 页面（即 Devices 设备界面）中管理；需要接入多个账号时见多号码（多设备）。
WAthink 提供的第三方连接服务采用 WhatsApp 协议连接方式，属于非官方接入，不代表 WhatsApp 或 Meta 官方授权或背书。目前不提供 WhatsApp Business Platform（Meta 官方 API）接入。 Business App 是手机应用，不等同于 Business Platform；推荐使用 Business App 不代表获得 Meta 官方授权，也不能消除平台限制或封号风险。
你需要什么（简版）：一部已登录 WhatsApp Business App 或 WhatsApp Messenger 的手机，以及账号所有者的授权。按提示扫码或输入配对码，服务费用与额度以所选方案为准。唯一需要常驻的是随包提供的辅助服务（连接运行服务）。
WhatsApp 协议连接
WhatsApp 协议连接通过关联设备方式，把 WhatsApp 应用账号接入为设备：扫码或输入配对码（pairing code）完成绑定，之后由随包提供的辅助服务（连接运行服务）保持连接并收发消息。这是应用账号的协议接入，不是 Business Platform 的 API 接入；费用与额度按所选方案确认。
| 项目 | 说明 |
|---|---|
| 适合场景 | 使用已授权的 Business App 或个人版账号，开展客户沟通与团队协作 |
| 你需要什么 | 一部已登录 WhatsApp Business App 或 WhatsApp Messenger 的手机，以及持续运行的连接服务 |
| 审核与费用 | 本接入方式不等同于 Meta 官方 API；服务费用与额度按所选方案确认 |
| 连接方式 | 扫描二维码，或输入 8 位配对码 |
| 可用能力 | 文本、媒体、按钮、列表、投票、位置、联系人名片、商品目录轮播、语音条 |
封号安全（WhatsApp 协议连接）。WhatsApp 协议连接像 WhatsApp Web 一样关联真实号码。新号码要互聊养号，控制发送节奏，并尊重用户订阅（opt-in）— 向冷淡名单激进群发是封号最快的路径。请配合 WAthink 的互聊养号（Warmer）、发送规则（每日预算 / 随机间隔 / 活跃时段）、每号代理（多 IP 隔离）（见每号代理）与号码检测来保护号码。
连接 WhatsApp 协议连接（扫码 / 配对码）
在 Channels 页面（Devices 设备界面）即可完成接入。配对由随包提供的辅助服务（连接运行服务）处理，它会代表你保持与 WhatsApp 的连接；该服务必须持续运行，否则设备无法保持在线、消息也无法收发。
- 打开 Channels 页面（Devices 设备界面），点击 Add device，选择 WhatsApp 协议连接/ Unofficial API（当前部署唯一可选项）。
- 扫描二维码：用手机上的 WhatsApp Business App 或 WhatsApp Messenger（Linked devices → Link a device）；或改用 pairing code 配对码，并在对应的手机应用中输入该码。
- 等待 Connected（已连接）。号码会像 WhatsApp Web 一样完成配对，并开始通过 WAthink 的辅助服务收发消息。
- 按 WhatsApp 当前的关联设备要求保持账号有效。连接中断时，先核对手机登录、关联设备授权与工作台连接状态，再决定是否重新配对。
按 WhatsApp 当前的关联设备要求保持账号有效。连接中断时，先核对手机登录、关联设备授权与工作台连接状态，再决定是否重新配对。
使用 WhatsApp
- 收件箱：双向聊天、媒体、表情回应、分配、备注与 24 小时会话窗口都在团队收件箱中。
- 可复用内容：WhatsApp 协议连接下无需企业审批 — 使用模板式可复用内容与快捷回复组织常用话术（亦见模板）。
- 营销活动与广播：批量发送，支持逐收件人送达追踪与防封号的发送节奏控制；详见营销活动与广播。
- 自动化：自动回复、流程与 AI 助手都可在 WhatsApp 上运行；AI 语音消息助手可处理语音条（转写 → 知识库作答 → 语音条回复）。
- WhatsApp 协议连接可用消息类型：文本、媒体、按钮、列表、投票、位置、联系人名片、商品目录轮播与语音条。
- 多号码：在同一工作区接入多个 WhatsApp 账号，由辅助服务在活跃设备之间分摊发送；详见多号码（多设备）。
故障排查
| 现象 | 原因与解决方法 |
|---|---|
| 号码频繁掉线 | 保持手机在线并登录 WhatsApp；如果设备显示 Needs re-pair，请从 Channels 页面重新配对。 |
| 按 WhatsApp 当前的关联设备要求保持账号有效。连接中断时，先核对手机登录、关联设备授权与工作台连接状态，再决定是否重新配对。 | 按 WhatsApp 当前的关联设备要求保持账号有效。连接中断时，先核对手机登录、关联设备授权与工作台连接状态，再决定是否重新配对。 |
| 二维码过期 / 扫描后未连接 | 二维码有时效，请在 Devices 页面重新 Generate QR（或改用 8 位配对码）；同时确认手机可正常访问 WhatsApp、系统时间准确。 |
| 消息发送失败或被登出 | 号码可能已被 WhatsApp 限制或封禁。请检查发送规则、降低发送频率并停止向冷淡名单群发；必要时更换专用号码并重新养号。 |
| 配置代理后号码无法连接 | 代理不可达或配置错误时，WhatsApp 协议连接会拒绝直连（fail-closed），不会回退到服务器共享 IP。请在号码的代理面板确认出口 IP 验证通过，或移除代理后重试。详见每号代理（多 IP 隔离）。 |
更多：账号接入步骤见连接通道；日常发送的节奏与限制见发送防护。