# 短信服务提供商（自带 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 月的变更](../messaging-channels/whatsapp-pricing.md)。）此设置仅在您明确希望 WhatsApp Business API 在您自己的 Twilio 账户上运行时才相关。 > **短信服务始终需要自带 Twilio 账户。** 由于短信监管（A2P 10DLC、品牌注册、发送方 ID 审批）必须以您自己企业的名义进行，因此平台不提供托管的短信号码。请在“设置”→“渠道”中使用 **SMS via Twilio** 卡片单独配置短信服务（此外还有一个 Android 手机短信网关选项）。此页面（即 **Twilio Account** 卡片）仅控制 WhatsApp Business API 账户，不会更改您的短信号码。 ## 为什么要将 WhatsApp Business API 切换到我自己的 Twilio 账户？ 大多数用户不需要这样做。托管账户更简单： - WhatsApp 号码租赁、模板提交、发送方注册以及号码健康状况均由我们为您处理。在此处租赁号码的费用至少为每月 50 个积分，该租金包含 WhatsApp 连接服务——请参阅 [电话号码](phone-numbers.md#monthly-phone-number-billing)。 - 不会产生单独的 Twilio 发票。如果您已连接自己的 Anthropic 密钥 (BYOK)，托管式 Twilio WhatsApp 消息的费用为每条 0.05 个积分（包括入站和出站消息）。在所有其他账户中，这些投递成本已包含在您的 AI 积分费率中，因此不会产生单独的按消息收费。有关 2026 年 10 月 1 日即将生效的 WhatsApp 定价变更，请参阅 [WhatsApp 成本与 2026 年 10 月的变更](../messaging-channels/whatsapp-pricing.md)。 - 客服团队可以直接协助调试投递问题。 在以下情况下，您可能需要自带 Twilio 账户： - 您已经拥有一个成熟的 Twilio 账户，其中包含已获批的 WhatsApp 模板和希望继续使用的预热号码。 - 贵公司出于采购或合规性原因，需要直接向 Twilio 付款。 - 您希望全面了解底层的运营商级使用情况和定价。 > **保留预热号码需要分两步完成。** 切换账户（见下文）仅会更改我们发送消息所使用的 Twilio 账户。在您完成关联之前，现有的 WhatsApp 号码不会显示为渠道——请参阅 [关联您已有的 WhatsApp 号码](#attaching-a-whatsapp-number-you-already-have)。请按此顺序操作。 --- ## 如何切换 **操作路径：** 设置 → **渠道**组 → **渠道**，然后找到 **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](https://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](mailto:hi@youraiconnector.com) and we can help you decide.