Your AI Connector Docs

短信服务提供商(自带 Twilio 账户)

此页面用于控制 WhatsApp Business API 所使用的 Twilio 账户。默认情况下,WhatsApp Business API 在平台托管的 Twilio 账户上运行——您无需接触 Twilio,也无需自行注册 Twilio。如果您已连接自己的 Anthropic 密钥 (BYOK),托管式 Twilio WhatsApp 消息的费用为每条 0.05 个积分(包括入站和出站消息)。在所有其他账户中,这些投递成本已包含在您的 AI 积分费率中,因此不会产生单独的按消息收费。(WhatsApp 自身的消息定价将于 2026 年 10 月 1 日变更——请参阅 WhatsApp 成本与 2026 年 10 月的变更。)此设置仅在您明确希望 WhatsApp Business API 在您自己的 Twilio 账户上运行时才相关。

短信服务始终需要自带 Twilio 账户。 由于短信监管(A2P 10DLC、品牌注册、发送方 ID 审批)必须以您自己企业的名义进行,因此平台不提供托管的短信号码。请在“设置”→“渠道”中使用 SMS via Twilio 卡片单独配置短信服务(此外还有一个 Android 手机短信网关选项)。此页面(即 Twilio Account 卡片)仅控制 WhatsApp Business API 账户,不会更改您的短信号码。

为什么要将 WhatsApp Business API 切换到我自己的 Twilio 账户?

大多数用户不需要这样做。托管账户更简单:

  • WhatsApp 号码租赁、模板提交、发送方注册以及号码健康状况均由我们为您处理。在此处租赁号码的费用至少为每月 50 个积分,该租金包含 WhatsApp 连接服务——请参阅 电话号码
  • 不会产生单独的 Twilio 发票。如果您已连接自己的 Anthropic 密钥 (BYOK),托管式 Twilio WhatsApp 消息的费用为每条 0.05 个积分(包括入站和出站消息)。在所有其他账户中,这些投递成本已包含在您的 AI 积分费率中,因此不会产生单独的按消息收费。有关 2026 年 10 月 1 日即将生效的 WhatsApp 定价变更,请参阅 WhatsApp 成本与 2026 年 10 月的变更
  • 客服团队可以直接协助调试投递问题。

在以下情况下,您可能需要自带 Twilio 账户:

  • 您已经拥有一个成熟的 Twilio 账户,其中包含已获批的 WhatsApp 模板和希望继续使用的预热号码。
  • 贵公司出于采购或合规性原因,需要直接向 Twilio 付款。
  • 您希望全面了解底层的运营商级使用情况和定价。

保留预热号码需要分两步完成。 切换账户(见下文)仅会更改我们发送消息所使用的 Twilio 账户。在您完成关联之前,现有的 WhatsApp 号码不会显示为渠道——请参阅 关联您已有的 WhatsApp 号码。请按此顺序操作。


如何切换

操作路径: 设置 → 渠道组 → 渠道,然后找到 Twilio Account 卡片。

您看到的内容取决于当前的设置:

如果您使用的是托管账户(默认)

您会在 Twilio 账户卡片上看到一段简短说明和一个 Manage(管理)按钮。点击该按钮将打开 Switch to your own Twilio account(切换到您自己的 Twilio 账户)表单,要求您输入 Twilio 的 Account SIDAuth Token——对话框中会显示破坏性操作警告。

在确认之前,请仔细阅读警告 —— 此切换操作具有破坏性:

  • 您通过平台购买的所有号码都将被永久释放。 如果您想继续使用某个号码,请将其保留在托管账户中(不要切换),或者先将其购买/迁移到您自己的 Twilio 账户中。
  • 已批准的 WhatsApp 模板不会转移。 模板归属于拥有该发送方的 WhatsApp Business 账户 —— 您需要在自己的账户中重新提交它们并等待重新批准。
  • 现有的聊天和消息记录仍然可见,但针对已释放号码的新回复将会失败(因为号码已不存在)。
  • 您可以稍后切换回来,但您将获得一个新的托管账户,其中没有任何号码和模板 —— 您旧的号码和模板不会恢复。

在哪里查找您的 Account SID 和 Auth Token:登录 Twilio 控制台 console.twilio.com。两者均位于主仪表板的“账户信息 (Account Info)”面板中。Account SID 以 AC 开头,长度为 34 个字符。

在您输入两个值并确认后,系统将执行以下操作:

  1. 验证凭据是否有效。
  2. 从 Twilio 释放每个托管电话号码。
  3. 关闭托管子账户。
  4. 保存您的凭据,以便将来所有的 WhatsApp 外发消息都使用您的账户。您单独连接的 SMS via Twilio 号码将独立存储,不会因本次切换而被释放或更改。

如果您有多个号码,这可能需要几秒钟到几分钟的时间。

如果您已经在使用自己的 Twilio 账户

该卡片会显示您已连接的账户,并允许您切换回托管设置。

切换回托管模式会配置一个新的托管子账户。如上所述:它不会恢复您之前拥有的号码或模板 —— 您将从零开始。


关联您已有的 WhatsApp 号码

一旦账户切换至您自己的 Twilio,WhatsApp Business API 卡片上的 Connect WhatsApp(连接 WhatsApp)按钮所提供的功能将发生变化:托管选项将变为 Through your Twilio account(通过您的 Twilio 账户),这会将 WhatsApp 发送方关联到您所连接的 Twilio 账户内,且不再提供购买托管号码的服务。这是有意为之的——购买号码或运行 Meta 注册流程会创建一个与您账户并行的第二个平台托管 Twilio 账户,导致您的消息从一个账户发送,而号码却存在于另一个账户中。

开始之前

您的号码必须已经是您自己 Twilio 账户内一个可正常工作的 WhatsApp 发送方:

  • 它已在 Twilio 中注册为 WhatsApp 发送方,并关联到您自己的 WhatsApp Business 账户。
  • Twilio 显示该发送方状态为 Online

此屏幕不执行任何注册操作。它不会创建发送方,不会与 Meta 通信,也不会提交您的号码进行审批 —— 它仅用于连接一个已经可以正常工作的发送方。如果您还没有发送方,请先在 Twilio 中完成 WhatsApp 发送方的设置。

步骤

  1. 前往 设置渠道 组 → 渠道
  2. WhatsApp Business API 卡片上,点击 关联您的发送方
  3. 输入国际格式的 WhatsApp 号码(例如 +31612345678),必须与 Twilio 发送方中显示的号码完全一致。
  4. (可选)为其设置一个 标签 — 即该号码在应用内的名称。如果留空,将使用您 Twilio 发送方配置文件的名称。
  5. 点击 关联发送方

您无需重新输入 Account SID 或身份验证令牌:我们已通过账户切换获取了这些信息。

后台处理流程

  1. 我们会在您的 Twilio 账户中查找该号码的发送方,并检查 Twilio 是否已将其上线。
  2. 我们会确保您的账户中存在消息服务,并将其入站 Webhook 指向我们(如果您还没有,我们会创建一个以该应用命名的消息服务)。这也是模板发送功能得以实现的原因。
  3. 我们会将您的发送方链接到该消息服务。
  4. 我们会将发送方自身的 Webhook 指向我们,以便接收传入的消息。
  5. 该号码将出现在您的号码列表中,并标记为 Your Twilio (BYO),随时可以分配给营销活动或代理。

您已获批的模板将保留在您自己的账户中,原封不动。无需重新提交,也不会被释放。

费用

通过此方式关联的号码无需支付月度维护费 — 您直接向 Twilio 支付号码费用及其按消息收取的费用。AI 回复仍照常消耗额度。

如果无法正常工作

  • “No WhatsApp sender for … exists in your Twilio account” — 该号码未在 Twilio 中注册为 WhatsApp 发送方,或者输入格式有误。请检查 Twilio 控制台中的确切发送方 ID,并以国际格式重新输入。
  • “The WhatsApp sender … is not online in Twilio” — 消息中包含了 Twilio 给出的具体原因。请先在 Twilio 中修复;如果关联一个在 Twilio 中处于离线状态的发送方,后续操作将会静默失败。
  • “… is already connected to another account” — 该号码已在此处的另一个账户中关联。请先在那个账户中解除关联。
  • “This account is still on the managed Twilio account” — 请先执行上述切换操作。
  • “we could not update its webhook in Twilio” — 该号码已关联且可以发送消息,但发送方仍指向您之前设置的 Webhook。请在 Twilio 控制台中清除该发送方的 Webhook,以便传入的消息能到达我们这里。

限制

  • 您每 24 小时 最多只能切换一次提供商。这可以防止频繁的切换导致 Twilio API 费用增加和速率限制。
  • 短信发送完全不受此设置影响 — 如果您已经通过 SMS via Twilio 卡片连接了自己的 Twilio,那属于不同的连接,无论您在此处做什么,它都会保持原样。

如果出现问题怎么办?

  • “Could not authenticate with the provided Twilio credentials” — 请仔细检查 SID(以 AC 开头,共 34 个字符)和身份验证令牌。两者均区分大小写。
  • “Account is not active” — 您尝试使用的 Twilio 账户已暂停或关闭。请使用一个活跃的账户。
  • “Please wait Xh before switching again” — 您处于 24 小时的冷却期内。请等待冷却期结束。
  • 部分迁移(部分号码已释放,部分未释放) — 请重新运行切换操作。该系统具有幂等性;它会从上次中断的地方继续,并完成剩余托管子账户中所有内容的释放。

如果您在切换后遇到问题(例如外发消息无法发送、模板未显示),请联系支持团队并提供您的 Account SID(切勿提供身份验证令牌)。


需要帮助?

If you’re not sure whether switching is right for you, or run into trouble, contact support and we can help you decide.