WhatsAppApi
将 WhatsApp 消息添加到你的应用。
发送有用的更新、接收客户回复并跟踪每条消息的完整生命周期。使用 Bird 已发布的 API 和 SDK 将 WhatsApp 连接到客户已经依赖的应用和工作流。
通过你的代理进行设置：
1
2
3
4
5
6
7
8
const msg = await bird.whatsapp.send({
to: "+15551234567",
template: {
slug: "bird_otp",
components: [{ type: "body", parameters: [{ type: "text", text: "123456" }] }],
},
});
console.log(msg.id, msg.status);选择你的 SDK 或直接使用 HTTP。这些示例基于 Bird 已发布的操作生成。
一个清晰的请求
选择适合当下的消息类型。
对符合条件的商业发起消息使用已审批模板，或在客服窗口期内发送支持的自由格式回复。保持发送方、接收方、语言和内容明确。
使用已发布的示例
从上方生成的 SDK 或 HTTP 示例开始。遵循操作的实际内容结构和验证规则，而不是从营销示意图猜测方法。
控制工作负载速率
使用请求速率限制响应和有界队列。当应用扇出消息时，为每个目标接收方和请求保留持久记录。
可推理的生命周期
从接受跟踪到客户的响应。
API 接受请求后开始处理。Meta 接收消息、消息送达和已读更新属于后续阶段；这些状态并不保证客户已经完成相应的业务操作。
通过消息已读进行对账
消费相关的 webhook 并在排查差异时检索消息记录。将不确定的尝试与已确认的失败区分开。
精确控制重试决策
使用文档中描述的请求保护机制和错误分类。不要假设一次不确定的服务商尝试可以无限重复。
01
已接受
Bird 接受请求并返回消息标识。
02
处理中
消息进入发送流程。
03
已送达或已读
运营商的观测数据在可用时更新消息记录。
谢谢！我明天来取。
在同一集成中处理拒绝、失败和缺失的观测数据。
是对话，不只是接口
将有用的上下文带入回复。
使用明确的按钮或列表回复标识符以及应用的会话状态。回复可以引用之前的消息，但该引用是可选的，且可能不可用。
让元数据各归其位
出站元数据属于出站记录。不要假设它会被复制到客户的入站消息上。
使用相同权限连接工具
CLI 和 MCP 可以帮助开发者操作该通道。它们同样受工作区访问权限、发送者归属和发送规则的约束。
WhatsApp API 常见问题
请求被接受是否意味着消息已送达？
不能。API 接受请求、Meta 接收消息、送达和已读是不同的观测状态。请分别确认相关消息状态和业务结果。
我可以随时发送自由格式的消息吗？
自由格式回复取决于客服窗口期和支持的内容类型。在窗口期之外，请使用符合条件的已审批模板。
是否有 WhatsApp 批量发送端点？
已发布的消息 API 用于发送单条消息。请根据文档中的限制控制应用的扇出速率；不要假设邮件群发端点同样可以发送 WhatsApp。
如何将交互式回复匹配到我的应用？
使用显式的回复标识符关联你存储的会话或任务状态。引用消息引用在可用时可以提供帮助，但外发消息的元数据不会自动被回复继承。