# 规划从 Twilio 到 Bird 的 WhatsApp 迁移

在迁移发送方的同时迁移客户工作流。号码连接成功并不能证明模板、自动化、事件和服务操作已经迁移完毕。

## 前提条件

确保拥有 Meta 商业资产的访问权限、当前提供商的配置以及接收消息的应用程序。指定一名切换负责人和一个在过渡期间能够响应客户的团队。

## 1. 盘点现有集成

盘点 Content SID、Messaging Service、状态回调、Studio 或 Flex 流程以及语音应用。在替换集成之前，将每项资源映射到其用途。

记录已批准的语言和模板内容、发送方归属、webhook 目标地址、发送许可和屏蔽数据，以及下游系统使用的客户标识符。保留一份只读配置记录，以便排查迁移问题。

## 2. 选择发送方过渡方式

审查该号码和账户支持的迁移路径或符合条件的共存方案。确认哪些资产可以转移，哪些需要重新创建。协调提供商的释放流程；在路径确认之前，不要删除现有的应用注册或断开当前发送方。

## 3. 映射客户工作流

将 Bird [消息 API](/products/whatsapp/sending)、[模板](/products/whatsapp/templates)和入站事件连接到预期的业务操作。保留回复标识符和应用任务状态。出站元数据不会自动出现在入站回复中。

| 现有职责            | 在 Bird 评估中需要验证的内容                                                                                       |
| ------------------- | ------------------------------------------------------------------------------------------------------------------ |
| 内容与语言          | 记录每个 Content SID、已批准的语言和变量。在 Bird 中重建预期消息，并测试实际解析的语言。                           |
| 发送方选择          | 记录应用程序如何选择发送方或 Messaging Service。在测试之前确认已连接的 Bird 发送方及其 WhatsApp Business Account。 |
| 回调与回复          | 在处理程序中转换事件含义和客户关联关系。回调 URL 或提供商消息 ID 不是可移植的会话记录。                            |
| Studio、Flex 和通话 | 列出发送 API 之外的步骤和团队分工。将消息自动化、联络中心工作和通话作为迁移的独立部分分别评估。                    |

## 4. 演练完整的消息交互

使用符合条件的受控收件人，测试已批准的模板、自由格式回复、交互式回复和转交人工处理。将投递观察结果与实际业务结果分开确认。演练发送结果不确定的情况、已关闭的服务窗口和不可用的集成。

## 5. 协调切换与恢复

商定如何处理排队中的发送和活跃会话。通过受支持的流程迁移流量，观察发送方和回调路由，并确保负责客户回复的团队随时可用。根据实际的提供商过渡约束来定义恢复方案，不要假设总能即时回退。

## 6. 核对结果

审查过渡两侧的消息批次和应用记录。通过账单记录核对相关费用。在宣布迁移完成之前，检查偏好设置、重复的业务事件、丢失的回复以及支持工作量。

## 使用你的智能体准备迁移

将此提示词复制到你的编码智能体中。它从只读盘点开始，并将每项任务路由到对应的指南。

```text
Help me prepare a WhatsApp migration from Twilio to Bird.
1. Check whether Bird MCP is connected or the Bird CLI is installed and signed in. Use either existing surface. If neither is available, follow https://bird.com/docs/ai/set-up-your-agent.md.
2. Read https://bird.com/docs/guides/whatsapp/migrate-from-twilio.md. Use the Markdown versions of the linked guides. Inventory the existing integration and customer workflows without changing them.
3. Read https://bird.com/docs/guides/whatsapp/phone-number-setup.md and identify the supported sender transition. Keep the current registration and routing active.
4. Follow https://bird.com/docs/guides/whatsapp/sending-whatsapp.md and https://bird.com/docs/guides/whatsapp/events.md to prepare a controlled message-and-reply test. Discover the available operations; do not invent commands or fields.
5. Show me the proposed changes, test recipient and expected charges. Ask before submitting templates, sending messages, changing routing or cutting over traffic.
6. After an approved test, report the observed delivery and customer outcome separately. Keep the production cutover pending my approval and describe any unresolved result.
```

## 后续步骤

- [比较 Bird 和 Twilio](/products/whatsapp/compare/bird-vs-twilio)。
- [连接 WhatsApp 号码](/docs/guides/whatsapp/phone-number-setup)。
- [浏览 WhatsApp 资源库](/products/whatsapp/resources)。

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)