Your AI Connector Docs

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 月的变更 以了解 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 积分,且不收取额外的单条消息费用。

重要提示: WhatsApp Web 集成是非官方的。会话在我们的服务器上运行,因此即使您的手机处于睡眠状态或关机,消息也能持续发送。只有在您于 WhatsApp 中取消关联设备、WhatsApp 撤销会话,或者您的手机离线超过 14 天(此时 WhatsApp 会断开所有已关联设备,您需要重新配对)时,它才会停止。对于大批量、任务关键型的商业消息发送,WhatsApp Business API 是更可靠的选择。


设置 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 不会对其生效。如果手机中包含大量个人聊天记录,请使用此选项。
    • 导入聊天记录 — 同时导入导入联系人的消息记录(可能需要几分钟)。导入的消息会填充“聊天”中的对话,但它们不会计入您的 仪表板 数据和图表中,因此连接前的聊天记录不会影响您的统计数据。
    • 对导入的联系人保持 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. 等待几秒钟以建立连接。配对成功后,状态会自动更新,您的电话号码将显示在“渠道”页面上。

注意: 二维码在等待期间大约每 30 秒会自动刷新一次,因此旧代码过期不会造成任何问题。

改用电话号码连接:

  1. 点击 改用电话号码连接
  2. 屏幕上会出现一个短代码,并附带说明:在手机上前往 WhatsApp → 已关联设备 → 关联新设备 → “改用电话号码连接”,然后输入显示的短代码。
  3. 等待几秒钟。连接成功后,系统会自动完成配置,过程与扫描二维码相同。

您可以随时在此界面通过 改用二维码扫描 / 改用电话号码连接 在两种方法之间切换。

连接成功后,您即可通过平台访问 WhatsApp 对话,分配给此渠道的 AI 智能体也可以回复收到的消息。


会话管理

检查连接状态

您的 WhatsApp Web 连接状态显示在 渠道 页面(设置 → 渠道 → 渠道)中号码的旁边。可能的状态包括:

状态 含义
已连接 处于活跃状态,可接收/发送消息
配对中 正在建立连接,或正在等待您扫描/输入代码
已断开 会话不再处于活跃状态

重新连接

如果您的会话断开(网络问题、手机重启等),请打开 设置 → 渠道 → 渠道,找到 WhatsApp Web 卡片中的号码,并使用其重新连接操作。系统会尝试自动恢复之前的会话;如果失败,系统会像首次设置一样弹出新的二维码(或配对码)。

断开连接

若要主动断开连接,请在 渠道 页面找到该号码,并使用其移除/断开连接操作。这将注销会话并从您的账户中移除该号码。您可以稍后通过重新配对来再次连接。

提示: 您也可以通过手机端 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,登录,点击浏览器扩展程序,粘贴连接界面上显示的连接代码,然后按 导入

重要提示: 此后请保持该 WhatsApp Web 标签页处于关闭状态。如果您稍后在同一浏览器中重新打开 web.whatsapp.com,可能会导致您的号码再次离线——如果发生这种情况,只需从应用中重新连接即可。


每个号码对应一个智能助手

连接两个或更多 WhatsApp Web 号码,每个号码都可以拥有自己的 AI 智能助手。在“AI 智能助手”页面上,“谁来回复新对话”面板为 WhatsApp Web 显示了一个“按号码设置”区块,其中包含每个已连接号码的选择器:将号码保留为“与 WhatsApp Web 相同”以遵循该渠道的智能助手,或者仅为该号码选择不同的智能助手(或“无人回复”)。向您的第二个号码发送消息的客户将获得该号码对应的智能助手,并且每条回复都将通过他们发送消息的同一个号码发出。详细信息:入口点 → 每个 WhatsApp 号码对应一个智能助手

发送限制与预热

每个配对的 WhatsApp Web 号码都有其专属的发送限制与预热指标,直接显示在“渠道”页面的对应行下方:

  • 今日已发送消息今日新增联系人,均显示在当日上限内。
  • 处于预热期时显示第 X 天(共 61 天)徽章,完全预热后显示已达满额容量
  • 明日上限预览以及距离达到满额容量的剩余天数。
  • 一个**为什么我会受到限制?**说明,解释其原因。

新号码的每日上限较低(第一天 50 条消息),该上限会在约 60 天内自动提升,以防止被封号。这种预热是正常且必要的——一个全新的号码如果过快发送过多消息,最容易导致被封。请参阅 安全扩展 WhatsApp 外联 以获取完整的预热公式,以及如何为已有真实历史记录的号码加速预热。

点击号码指标下方的提高每日上限以打开每日发送限制面板,您可以在其中进行以下操作:

  • 提前或推迟预热天数(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 应用中。如果您想在删除前备份任何内容,请参阅下载您的数据


限制

  • 不支持群聊。 群组消息在两个方向上都会被忽略,AI 也从不在群组中回复 —— 请参阅上方的 哪些内容会被复制到应用中
  • 不支持模板消息。 你无法发送预先批准的模板消息。所有消息均为自由格式。这也意味着 WhatsApp Web 上没有模板批准步骤:你在该渠道发送的广播会直接作为你个人 WhatsApp 账号的普通消息发出,无需提交给 Meta,也无需等待。模板批准仅适用于 WhatsApp Business API
  • 你的手机必须至少每 14 天上线一次。 WhatsApp Web 会话本身在我们的服务器上运行,因此即使你的手机处于睡眠状态或关机,消息也能正常收发。但如果你的手机离线超过 14 天,WhatsApp 会断开所有已关联设备,你必须重新进行配对。
  • 非官方集成。 不受 Meta 官方支持;其侧的变更可能会影响此功能。
  • 有限的送达追踪。 你仍然可以在 WhatsApp 本身中看到蓝色勾选标记(已读回执),但应用内的送达状态追踪功能比 Business API 更为有限。
  • 账号风险。 过度的自动化或类似垃圾信息的行为可能导致 WhatsApp 账号被临时或永久封禁。请遵循下方的预热和最佳实践。
  • 单设备限制。 连接会占用你已关联设备名额中的一个;WhatsApp 最多允许关联 4 台设备。
  • 没有“此号码是否在 WhatsApp 上”的检查功能。 出于安全考虑,本应用从不向 WhatsApp 查询号码是否已注册:从企业号码进行批量查询会被 WhatsApp 视为抓取行为,如果一个新号码对数百个未知联系人执行此操作,很快就会受到限制。发送给不在 WhatsApp 上的号码的消息会显示为已发送但永远不会送达,且仍会计入该号码的每日限额,因此请在上传列表前进行清理(请参阅 安全地扩展 WhatsApp 外联)。

故障排除

连接屏幕无法加载代码

  • 刷新页面并重试。
  • 确保您的互联网连接稳定。
  • 如果问题仍然存在,请先断开任何现有会话并重新开始。

连接频繁中断

  • 检查您的手机是否有可靠的互联网连接(建议使用 Wi-Fi)。
  • 确保手机的电池优化设置没有在后台关闭 WhatsApp。
  • 从“频道”页面重新连接会话。

消息无法发送

  • 验证连接状态是否显示为 已连接
  • 检查您的账户是否有足够的额度。
  • 确保收件人号码正确且已安装 WhatsApp。
  • 如果您最近达到了每日发送限额,请等待其重置或查看预热指标。

当消息发送失败时,应用程序会在聊天记录中的该消息上显示原因,而不仅仅是显示“失败”。常见原因包括:

  • WhatsApp 正在限制发往此联系人的消息。 收件人可能已屏蔽您的号码,或者 WhatsApp 尚未允许您的号码与他们发起新对话。反复重试会使情况恶化——请等待联系人先给您发消息,或通过其他渠道联系他们。
  • 临时 WhatsApp 连接问题。 这是一次性的小故障——发往该联系人的下一条消息通常可以成功发送。

“重新连接一直要求输入密钥”

该安全步骤无法仅通过常规的二维码或代码连接完成——请参阅上方的 连接遇到问题?使用浏览器扩展程序

手机显示“已登出”

您的会话已在手机端终止。请前往 设置 → 频道 → 频道,断开现有会话,并建立新的连接。

WhatsApp 向我发送了警告

有时,在您关联新设备后不久,WhatsApp 会在您的手机上显示警告,通常还会伴随将关联设备登出的操作。这是 WhatsApp 针对新连接发出的自动提醒,如果您的号码是新号,或者您向尚未保存您的号码或未曾主动联系过您的人发送消息,这种情况更容易发生。这并不意味着您已被封号,通常也与发送量无关。

建议操作:

  1. 在接下来的几天里,请在手机上的 WhatsApp 应用中正常使用该号码。
  2. 重新连接会话,并在最初的一两周内,让 AI 主要回复主动联系您的用户——暂时不要进行广播或主动发起首次联系。
  3. 如果您确实需要发送外发消息,请拉开发送间隔并变换措辞——内容完全重复的文本是触发警告的典型原因。
  4. 若需进行常规的大批量外发,请改用 WhatsApp Business API:模板会预先经过 Meta 审核,因此发送消息不会使您的号码面临此类风险。

如果您收到的消息明确指出您的账户已被封禁(而不仅仅是警告),请附上截图联系客服。


最佳实践

  • 确保您的手机至少每 14 天上线一次 — 在此之后,WhatsApp 会取消所有已关联的设备。
  • 在手机上使用 Wi-Fi 以获得最稳定的连接。
  • 留意发送限制指标,以保护您的 WhatsApp 账户免受限制。
  • 从较低的自动化发送量开始,并随着您建立起消息发送模式而逐渐增加。
  • 如果您需要更高的发送量、模板消息或保证可靠性,请考虑 WhatsApp Business API