短信服务提供商(自带 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 SID 和 Auth Token——对话框中会显示破坏性操作警告。
在确认之前,请仔细阅读警告 —— 此切换操作具有破坏性:
- 您通过平台购买的所有号码都将被永久释放。 如果您想继续使用某个号码,请将其保留在托管账户中(不要切换),或者先将其购买/迁移到您自己的 Twilio 账户中。
- 已批准的 WhatsApp 模板不会转移。 模板归属于拥有该发送方的 WhatsApp Business 账户 —— 您需要在自己的账户中重新提交它们并等待重新批准。
- 现有的聊天和消息记录仍然可见,但针对已释放号码的新回复将会失败(因为号码已不存在)。
- 您可以稍后切换回来,但您将获得一个新的托管账户,其中没有任何号码和模板 —— 您旧的号码和模板不会恢复。
在哪里查找您的 Account SID 和 Auth Token:登录 Twilio 控制台 console.twilio.com。两者均位于主仪表板的“账户信息 (Account Info)”面板中。Account SID 以 AC 开头,长度为 34 个字符。
在您输入两个值并确认后,系统将执行以下操作:
- 验证凭据是否有效。
- 从 Twilio 释放每个托管电话号码。
- 关闭托管子账户。
- 保存您的凭据,以便将来所有的 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 发送方的设置。
步骤
- 前往 设置 → 渠道 组 → 渠道。
- 在 WhatsApp Business API 卡片上,点击 关联您的发送方。
- 输入国际格式的 WhatsApp 号码(例如
+31612345678),必须与 Twilio 发送方中显示的号码完全一致。 - (可选)为其设置一个 标签 — 即该号码在应用内的名称。如果留空,将使用您 Twilio 发送方配置文件的名称。
- 点击 关联发送方。
您无需重新输入 Account SID 或身份验证令牌:我们已通过账户切换获取了这些信息。
后台处理流程
- 我们会在您的 Twilio 账户中查找该号码的发送方,并检查 Twilio 是否已将其上线。
- 我们会确保您的账户中存在消息服务,并将其入站 Webhook 指向我们(如果您还没有,我们会创建一个以该应用命名的消息服务)。这也是模板发送功能得以实现的原因。
- 我们会将您的发送方链接到该消息服务。
- 我们会将发送方自身的 Webhook 指向我们,以便接收传入的消息。
- 该号码将出现在您的号码列表中,并标记为 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.