# WhatsApp Web 通过配对手机将您现有的 WhatsApp 账户（个人或企业）连接到平台——无需 Meta Business 验证。其工作原理与在浏览器中关联 WhatsApp Web 完全相同，但您的 WhatsApp 对话会直接流入应用程序，而不是浏览器。 --- ## 什么是 WhatsApp Web 集成？ WhatsApp Web 集成允许您将现有的 WhatsApp 号码连接到平台，而无需经过官方的 WhatsApp Business API 设置流程。您无需购买新电话号码或完成 Meta Business 验证，只需在应用程序中配对手机，不到一分钟即可完成。 这非常适合希望利用现有 WhatsApp 账号快速上手的企业。 --- ## WhatsApp Web 与 Business API 的对比 ### WhatsApp Web 为您提供什么 - **几分钟内完成设置** — 您只需配对手机，无需进行 Meta Business 验证。 - **使用您现有的 WhatsApp 号码**，无论是个人号码还是企业号码。（此处无法使用通过平台租用的号码，因为该号码背后没有实体手机，而是通过 Business API 连接。） - **费用：** 每个已连接号码每月 50 积分，无单条消息费用。 - **向已选择接收消息的用户发送信息时，封号风险较低。** 会话在带有专用代理的私有服务器上运行；风险主要来自向陌生人进行群发，从而导致被举报。 - **标准的 WhatsApp 发送限制**，并带有自动预热机制。 - **仅支持基础的消息送达追踪**。 - **可靠性：** 会话在我们的服务器上运行，因此您的手机可以离线长达 14 天。 - **最适合**小型企业、快速启动以及个人号码使用。 ### WhatsApp Business API 为您提供什么 - **设置需要数小时到数天**，因为需要进行 Meta Business 验证。 - **该号码必须尚未在 WhatsApp 上注册** — 您可以在此处租用一个新号码，或使用一个未注册的号码。 - **费用：** 号码租用费每月 50 积分起（号码卡片会显示其确切价格），外加按成本价收取的 Meta 模板费用。如果您已连接自己的 Anthropic 密钥 (BYOK)，托管的 Twilio WhatsApp 消息每条收费 0.05 积分（入站和出站）。在所有其他账户中，这些发送成本已包含在您的 AI 积分费率中，因此没有单独的单条消息费用。请参阅 [WhatsApp 费用与 2026 年 10 月的变更](whatsapp-pricing.md) 以了解 2026 年 10 月 1 日起生效的变更。 - **封号风险较低**，因为该渠道是 Meta 官方渠道，但向举报您的用户进行冷外联仍可能导致号码受限。 - **分级消息限制**（从 250 条到无限制，在投资组合级别设置）。 - **完整的送达和已读回执**。 - **可靠性：** 完全基于云端，无需手机在线。 - **最适合：** 大批量发送者、企业和受监管行业。 ### WhatsApp Web 与 Business API 对比 | 功能 | WhatsApp Web | WhatsApp Business API | |---|---|---| | **Meta Business 验证** | 不需要 | 需要 | | **模板消息** | 不支持（在对话中也不需要） | 支持（在 24 小时窗口外发起聊天时必需） | | **已读回执** | 应用内不追踪 | 完整的送达/已读回执 | | **输入状态指示器** | 支持 | 不可用 | | **24 小时窗口** | 无限制 | 由 Meta 强制执行 | ### WhatsApp Web 的费用：每个连接每月 50 积分，无单条消息费用 WhatsApp Web 适用于当前所有套餐。每个已连接的号码每月收费 50 积分，且不收取额外的单条消息费用。 ::: warning **重要提示：** WhatsApp Web 集成是非官方的。会话在我们的服务器上运行，因此即使您的手机处于睡眠状态或关机，消息也能持续发送。只有在您于 WhatsApp 中取消关联设备、WhatsApp 撤销会话，或者您的手机离线超过 14 天（此时 WhatsApp 会断开所有已关联设备，您需要重新配对）时，它才会停止。对于大批量、任务关键型的商业消息发送，[WhatsApp Business API](whatsapp-business.md) 是更可靠的选择。 ::: --- ## 设置 WhatsApp Web ### 第 1 步：打开连接流程 1. 在左侧边栏底部附近，点击 **Settings**（设置）。 2. 在设置左侧导航栏的 **Channels**（渠道）下，点击 **Channels**（渠道）。 3. 找到 **WhatsApp Web** 卡片并点击 **Connect**（连接）（如果您已经配对过，此处会显示 **Add number**（添加号码））。 ### 第 2 步：输入电话号码和导入选项 系统会打开一个名为 **Connect WhatsApp Web**（连接 WhatsApp Web）的弹出窗口。 1. 输入您要连接的 WhatsApp 账户的**电话号码**，包括国家/地区代码。 2. 如果您希望在首次连接时将现有的 WhatsApp 联系人导入收件箱，请开启**导入现有联系人**。开启此选项会显示更多选项： - **将联系人设为私密** — 导入的联系人的消息不会通过平台存储或发送，且 AI 不会对其生效。如果手机中包含大量个人聊天记录，请使用此选项。 - **导入聊天记录** — 同时导入导入联系人的消息记录（可能需要几分钟）。导入的消息会填充“聊天”中的对话，但它们不会计入您的 [仪表板](../get-started/dashboard.md) 数据和图表中，因此连接前的聊天记录不会影响您的统计数据。 - **对导入的联系人保持 AI 暂停状态** — 建议开启，且默认开启。保持开启状态可防止 AI 自动向您的现有联系人发送消息；准备好后，您可以稍后针对每个联系人单独关闭此设置。 3. 点击**获取二维码**以继续默认的扫描流程（见下文第 3 步），或者如果您不想扫描，而是希望在手机上输入短代码，请点击按钮下方的**改用电话号码链接**。 > **通过平台租用的号码无法在此处配对。** WhatsApp Web 会链接一个已经在您输入的号码上运行 WhatsApp 的手机。您在“渠道”（Channels）页面购买的号码是一个没有实体手机支持的虚拟号码，因此没有设备可以扫描二维码，如果您尝试这样做，应用程序会阻止您。要使用租用的号码，请改为点击“渠道”页面中该号码行上的**完成设置**（Finish setup） — 这将通过 WhatsApp Business API 连接它。 > **正在连接一个您也在个人使用的号码？** 没问题，模态框中也说明了这一点。只需记住，一旦号码上线，AI 将会回复该号码上的每一条聊天信息。用于限制 AI 的两个开关——**对导入的联系人保持 AI 暂停状态**和**将联系人设为私密**——仅在开启**导入现有联系人**后才会出现，且它们仅适用于当时导入的联系人。在您连接号码*之后*发送消息的任何人，都会作为全新的聊天进入，且 AI 处于活动状态。因此，请在加载完您的真实联系人列表并准备好上线之前，保持您的代理处于关闭状态。请注意，稍后重新连接号码时不会记住这些选择——请在新的连接上重新设置它们。 > **导入仅在号码首次链接时运行。** WhatsApp 仅在设备首次链接时才会发送您的联系人。如果该号码之前已连接过并再次重新连接，WhatsApp 会识别出该设备并跳过此步骤，因此导入选项将无法执行任何操作——连接仍然会成功，只是不会导入任何联系人。要强制进行全新链接，请在手机上打开 **WhatsApp**，前往 **设置 > 已链接的设备**，退出 Your AI Connector 设备，然后使用您想要的导入选项重新连接该号码。 点击 **改用电话号码连接** 会在当前界面进行切换：按钮变为 **获取配对码**，链接变为 **改用二维码扫描**，以便您随时切回。 ### 第 3 步：连接您的手机 **扫描二维码（默认）：** 1. 屏幕上会出现一个二维码，并附带说明：在手机上打开 WhatsApp → **设置 → 已关联设备 → 关联新设备**，然后扫描显示的二维码。 2. 等待几秒钟以建立连接。配对成功后，状态会自动更新，您的电话号码将显示在“渠道”页面上。 ::: note **注意：** 二维码在等待期间大约每 30 秒会自动刷新一次，因此旧代码过期不会造成任何问题。 ::: **改用电话号码连接：** 1. 点击 **改用电话号码连接**。 2. 屏幕上会出现一个短代码，并附带说明：在手机上前往 **WhatsApp → 已关联设备 → 关联新设备 → “改用电话号码连接”**，然后输入显示的短代码。 3. 等待几秒钟。连接成功后，系统会自动完成配置，过程与扫描二维码相同。 您可以随时在此界面通过 **改用二维码扫描** / **改用电话号码连接** 在两种方法之间切换。 连接成功后，您即可通过平台访问 WhatsApp 对话，分配给此渠道的 AI 智能体也可以回复收到的消息。 --- ## 会话管理 ### 检查连接状态 您的 WhatsApp Web 连接状态显示在 **渠道** 页面（**设置 → 渠道 → 渠道**）中号码的旁边。可能的状态包括： | 状态 | 含义 | |---|---| | **已连接** | 处于活跃状态，可接收/发送消息 | | **配对中** | 正在建立连接，或正在等待您扫描/输入代码 | | **已断开** | 会话不再处于活跃状态 | ### 重新连接 如果您的会话断开（网络问题、手机重启等），请打开 **设置 → 渠道 → 渠道**，找到 WhatsApp Web 卡片中的号码，并使用其重新连接操作。系统会尝试自动恢复之前的会话；如果失败，系统会像首次设置一样弹出新的二维码（或配对码）。 ### 断开连接 若要主动断开连接，请在 **渠道** 页面找到该号码，并使用其移除/断开连接操作。这将注销会话并从您的账户中移除该号码。您可以稍后通过重新配对来再次连接。 ::: tip **提示：** 您也可以通过手机端 WhatsApp 进入 **已关联的设备** 并移除该会话来断开连接。 ::: --- ## 连接遇到问题？请使用浏览器扩展程序 有时连接或重新连接无法完成，是因为 WhatsApp 增加了额外的安全步骤——它会要求输入 **通行密钥 (passkey)**，而普通的二维码或代码连接无法自行完成此步骤。遇到这种情况时，请使用名为 **Your AI Connector** 的小型浏览器扩展程序，它在您自己的 Chrome 浏览器中运行，通行密钥步骤在那里可以正常完成。 您只需执行此操作一次。号码连接成功后，扩展程序便完成了它的任务，一切将照常在云端运行。 ### 开始之前 - 目前仅适用于 **台式机或笔记本电脑上的 Google Chrome 浏览器**。 - 该扩展程序是一个 **一次性辅助工具**——连接成功后，它就不会再干扰您的操作。 ### 操作步骤 1. 在 WhatsApp Web 连接界面，选择 **连接遇到问题？通行密钥拦截？使用浏览器扩展程序**。 2. **下载扩展程序。** 它会以压缩 (zip) 文件的形式保存到您的电脑上。 3. **解压文件**——这将创建一个普通文件夹。 4. 在 Chrome 中打开一个新标签页，访问 **chrome://extensions**。 5. 开启 **开发者模式**（右上角）。 6. 点击 **加载已解压的扩展程序**。 7. 选择您刚才解压的文件夹。 8. 回到连接界面，点击 **连接**。系统会自动打开一个已加载连接代码的 WhatsApp Web 标签页，扩展程序会自动识别它。 9. 在该标签页中 **登录 WhatsApp**——因为这是您自己的 Chrome 浏览器，通行密钥步骤可以在此正常完成。它会自动导入，屏幕将显示 **已连接**。 10. **显示“已连接”后，请关闭该 WhatsApp Web 标签页。** 这一点很重要：如果您在浏览器中保持 WhatsApp Web 开启，它会运行该会话的第二个副本，从而与我们的系统产生冲突，可能导致您的号码再次离线。您的手机会保持正常连接——只需关闭浏览器标签页即可。 > **“连接”按钮没有打开 WhatsApp Web？** 请改用 **高级：手动粘贴代码** 选项——自行打开 web.whatsapp.com，登录，点击浏览器扩展程序，粘贴连接界面上显示的连接代码，然后按 **导入**。 ::: warning **重要提示：** 此后请保持该 WhatsApp Web 标签页处于关闭状态。如果您稍后在同一浏览器中重新打开 web.whatsapp.com，可能会导致您的号码再次离线——如果发生这种情况，只需从应用中重新连接即可。 ::: --- ## 每个号码对应一个智能助手 连接两个或更多 WhatsApp Web 号码，每个号码都可以拥有自己的 AI 智能助手。在“AI 智能助手”页面上，“**谁来回复新对话**”面板为 WhatsApp Web 显示了一个“**按号码设置**”区块，其中包含每个已连接号码的选择器：将号码保留为“**与 WhatsApp Web 相同**”以遵循该渠道的智能助手，或者仅为该号码选择不同的智能助手（或“**无人回复**”）。向您的第二个号码发送消息的客户将获得该号码对应的智能助手，并且每条回复都将通过他们发送消息的同一个号码发出。详细信息：[入口点 → 每个 WhatsApp 号码对应一个智能助手](../ai-agents/entry-points.md#one-agent-per-whatsapp-number)。 ## 发送限制与预热 每个配对的 WhatsApp Web 号码都有其专属的**发送限制与预热**指标，直接显示在“渠道”页面的对应行下方： - **今日已发送消息**和**今日新增联系人**，均显示在当日上限内。 - 处于预热期时显示**第 X 天（共 61 天）**徽章，完全预热后显示**已达满额容量**。 - 明日上限预览以及距离达到满额容量的剩余天数。 - 一个**为什么我会受到限制？**说明，解释其原因。 新号码的每日上限较低（**第一天 50 条消息**），该上限会在约 60 天内自动提升，以防止被封号。这种预热是正常且必要的——一个全新的号码如果过快发送过多消息，最容易导致被封。请参阅 [安全扩展 WhatsApp 外联](scaling-whatsapp-outreach.md) 以获取完整的预热公式，以及如何为已有真实历史记录的号码加速预热。 点击号码指标下方的**提高每日上限**以打开**每日发送限制**面板，您可以在其中进行以下操作： - **提前或推迟预热天数**（1–60 天）——对于您已知有真实历史记录的号码，向前调整可以更快解锁更高的上限；仅在调高上限时需要您勾选风险确认框。 - **突破自动预热限制**（仅限号码完全预热后，即第 58 天起）——可手动设置每日 750 条至 5,000 条消息的上限，以 250 条为步长。此操作存在实际封号风险，在生效前需要您进行更明确的确认。 > **注意。** 作为安全措施，新连接的 WhatsApp Web 号码**默认关闭自动跟进功能**，显示为每个号码指标下方的**自动跟进**开关。在通过三个预热门槛（号码使用时长、活跃度提升以及近期联系人互动，每个门槛均按约 30 天衡量）之前，该功能保持关闭——开关在整个过程中均可见，但面板会显示您尚未通过的门槛。一旦您的号码预热完成且状态稳定，即可重新开启跟进功能。 --- ## 输入状态指示器 WhatsApp Web 集成支持输入状态指示器——即当 AI 正在准备回复时，您的联系人看到的“正在输入...”气泡。此功能自动启用，无需任何配置。 --- ## 手动回复会暂停 AI 如果您手动回复了某次对话，AI 将针对该联系人暂停，以免打断您的对话。无论您是从应用内的**聊天**界面回复，**还是**直接在手机上的 WhatsApp 中回复，都会发生这种情况。这两者很容易混淆：在手机上回复聊天时，应用内看起来没有任何变化，但 AI 实际上已经悄悄停止回复该联系人了。 **AI 会一直保持暂停状态，直到有人将其重新开启。** 它不会在一小时、一天或联系人发送下一条消息后自动恢复。请在**聊天**中打开该对话，并使用顶部的开关——当 AI 关闭时，它显示为“AI 已暂停”，选择它即可重新开启 AI。 > **如果您的团队成员通过手机回复，请先检查这一点。** 当多人处理同一个 WhatsApp 号码时，大多数对话在无人知晓的情况下悄悄切换为手动模式是常有的事。如果 AI 看起来“停止工作”了，请在更改任何营销活动设置之前，打开几个聊天窗口并查看 AI 开关的状态。 仪表板的**收件箱**面板会显示您已暂停 AI 并正在亲自处理的聊天数量，这是在整个账户中快速发现此情况的最快方法。 --- ## 哪些内容会被复制到应用中（哪些不会） 配对手机的方式与在笔记本电脑上关联 WhatsApp 的方式相同：从关联生效的那一刻起，该号码的一对一对话就会流入应用并存储在其中，以便 AI 和您的团队可以处理这些对话。在关联您同时用于个人用途的号码之前，了解其涵盖的范围非常重要。 **会同步的内容：** - 从您关联那一刻起，该号码上的每一条**一对一聊天**（双向）——包括您从手机上发送的消息。 - **现有联系人，以及可选的聊天记录**，但前提是您在关联时开启了**导入现有联系人**（请参阅上方的第 2 步）。如果保持关闭，则关联之前的内容都不会被复制。 **永远不会同步的内容：** - **群聊。** 群组消息会被完全忽略——它们不会创建联系人，不会出现在您的收件箱中，不会被存储，AI 也永远不会在群组中回复。您从应用发送的任何内容也不会发送到群组。您的群组在手机上的 WhatsApp 中保持正常运行；应用只是无法看到它们。 - **状态更新和广播列表。** - **其他号码上的聊天。** 只有您配对的号码会被连接。 **如果您要关联一个同时也用于个人聊天的号码，** 以下两个选项可以保持隐私： - 在导入期间开启**将联系人设为私密**。这些联系人的消息不会通过平台存储或发送，AI 也不会针对他们开启。 - 或者为业务使用不同的号码。这是最彻底的隔离方式，如果您的个人聊天涉及敏感信息，我们建议这样做。 请记住，这两个导入选项仅涵盖在关联时导入的联系人。在您关联*之后*向该号码发送消息的任何人，都会作为普通的新聊天记录进入系统。 ### 删除已复制的对话 关联导入的所有内容都是普通账户数据，删除它们的方式与删除其他任何内容相同： - **单个对话或联系人** — 在**联系人**中删除该联系人。删除联系人会立即删除其对话历史记录。 - **批量删除** — 在**联系人**或列表中选择它们并一起删除，或者删除整个列表。 - **全部删除** — 在**设置 → 渠道**中取消关联该号码，然后删除它导入的联系人。取消关联会停止接收新消息，但不会删除已经导入的内容。 在此处删除不会影响您手机上的 WhatsApp：您的聊天记录会保留在 WhatsApp 应用中。如果您想在删除前备份任何内容，请参阅[下载您的数据](../privacy/data-export.md)。 --- ## 限制 - **不支持群聊。** 群组消息在两个方向上都会被忽略，AI 也从不在群组中回复 —— 请参阅上方的 [哪些内容会被复制到应用中](#what-gets-copied-into-the-app-and-what-doesnt)。 - **不支持模板消息。** 你无法发送预先批准的模板消息。所有消息均为自由格式。这也意味着 WhatsApp Web 上**没有模板批准步骤**：你在该渠道发送的广播会直接作为你个人 WhatsApp 账号的普通消息发出，无需提交给 Meta，也无需等待。模板批准仅适用于 [WhatsApp Business API](whatsapp-business.md)。 - **你的手机必须至少每 14 天上线一次。** WhatsApp Web 会话本身在我们的服务器上运行，因此即使你的手机处于睡眠状态或关机，消息也能正常收发。但如果你的手机离线超过 14 天，WhatsApp 会断开所有已关联设备，你必须重新进行配对。 - **非官方集成。** 不受 Meta 官方支持；其侧的变更可能会影响此功能。 - **有限的送达追踪。** 你仍然可以在 WhatsApp 本身中看到蓝色勾选标记（已读回执），但应用内的送达状态追踪功能比 Business API 更为有限。 - **账号风险。** 过度的自动化或类似垃圾信息的行为可能导致 WhatsApp 账号被临时或永久封禁。请遵循下方的预热和最佳实践。 - **单设备限制。** 连接会占用你已关联设备名额中的一个；WhatsApp 最多允许关联 4 台设备。 - **没有“此号码是否在 WhatsApp 上”的检查功能。** 出于安全考虑，本应用从不向 WhatsApp 查询号码是否已注册：从企业号码进行批量查询会被 WhatsApp 视为抓取行为，如果一个新号码对数百个未知联系人执行此操作，很快就会受到限制。发送给不在 WhatsApp 上的号码的消息会显示为已发送但永远不会送达，且仍会计入该号码的每日限额，因此请在上传列表前进行清理（请参阅 [安全地扩展 WhatsApp 外联](scaling-whatsapp-outreach.md)）。 --- ## 故障排除 ### 连接屏幕无法加载代码 - 刷新页面并重试。 - 确保您的互联网连接稳定。 - 如果问题仍然存在，请先断开任何现有会话并重新开始。 ### 连接频繁中断 - 检查您的手机是否有可靠的互联网连接（建议使用 Wi-Fi）。 - 确保手机的电池优化设置没有在后台关闭 WhatsApp。 - 从“频道”页面重新连接会话。 ### 消息无法发送 - 验证连接状态是否显示为 **已连接**。 - 检查您的账户是否有足够的额度。 - 确保收件人号码正确且已安装 WhatsApp。 - 如果您最近达到了每日发送限额，请等待其重置或查看预热指标。 当消息发送失败时，应用程序会在聊天记录中的该消息上显示原因，而不仅仅是显示“失败”。常见原因包括： - **WhatsApp 正在限制发往此联系人的消息。** 收件人可能已屏蔽您的号码，或者 WhatsApp 尚未允许您的号码与他们发起新对话。反复重试会使情况恶化——请等待联系人先给您发消息，或通过其他渠道联系他们。 - **临时 WhatsApp 连接问题。** 这是一次性的小故障——发往该联系人的下一条消息通常可以成功发送。 ### “重新连接一直要求输入密钥” 该安全步骤无法仅通过常规的二维码或代码连接完成——请参阅上方的 [连接遇到问题？使用浏览器扩展程序](#trouble-connecting-use-the-browser-extension)。 ### 手机显示“已登出” 您的会话已在手机端终止。请前往 **设置 → 频道 → 频道**，断开现有会话，并建立新的连接。 ### WhatsApp 向我发送了警告 有时，在您关联新设备后不久，WhatsApp 会在您的手机上显示警告，通常还会伴随将关联设备登出的操作。这是 WhatsApp 针对新连接发出的自动提醒，如果您的号码是新号，或者您向尚未保存您的号码或未曾主动联系过您的人发送消息，这种情况更容易发生。这并不意味着您已被封号，通常也与发送量无关。 建议操作： 1. 在接下来的几天里，请在手机上的 WhatsApp 应用中正常使用该号码。 2. 重新连接会话，并在最初的一两周内，让 AI 主要**回复**主动联系您的用户——暂时不要进行广播或主动发起首次联系。 3. 如果您确实需要发送外发消息，请拉开发送间隔并变换措辞——内容完全重复的文本是触发警告的典型原因。 4. 若需进行常规的大批量外发，请改用 [WhatsApp Business API](whatsapp-business.md)：模板会预先经过 Meta 审核，因此发送消息不会使您的号码面临此类风险。 如果您收到的消息明确指出您的账户已被**封禁**（而不仅仅是警告），请附上截图联系客服。 --- ## 最佳实践 - **确保您的手机至少每 14 天上线一次** — 在此之后，WhatsApp 会取消所有已关联的设备。 - **在手机上使用 Wi-Fi** 以获得最稳定的连接。 - **留意发送限制指标**，以保护您的 WhatsApp 账户免受限制。 - **从较低的自动化发送量开始**，并随着您建立起消息发送模式而逐渐增加。 - **如果您需要更高的发送量、模板消息或保证可靠性，请考虑 [WhatsApp Business API](whatsapp-business.md)。**