通过一个 API 发送 WhatsApp 通知、验证码和交互式回复。
将订单确认、一次性验证码、富媒体以及交互按钮或列表菜单直接发送到客户的 WhatsApp 聊天中。Bird 在发送前校验模板参数并检查 24 小时客户服务窗口，避免调用失败和意外费用，同时将送达和已读回执实时推送回你的应用。
// Install the SDK
// npm install @messagebird/sdk
const msg = await bird.whatsapp.send({
to: "+15551234567",
template: {
slug: "bird_otp",
parameters: { code: "123456" },
},
});
console.log(msg.id, msg.status);使用我们的 TypeScript、Python、Go 或 PHP SDK、Bird CLI 或直接发送 HTTP 请求，几分钟内即可发出第一条消息。在你自己的 WhatsApp Business 号码验证期间，可以立即使用 Bird 预先审核通过的模板。
模板与 24 小时窗口
在 24 小时窗口内外发送正确格式的消息。
WhatsApp 将企业主动发起的触达与进行中的客户对话区分开。在没有活跃聊天时，使用经 Meta 审核的实用、身份验证或营销模板联系客户；客户给你发消息或来电后的 24 小时内，可改为发送自由格式文本、媒体和交互菜单。
提前发现已关闭的窗口和变量不匹配
Bird 按收件人和企业号码跟踪 24 小时客户服务窗口。如果你的应用在窗口关闭后尝试发送自由格式消息，或传入的模板变量与占位符不匹配，API 会在创建或计费之前拒绝该调用。
富媒体、交互按钮和列表菜单
对话开启时，通过同一个端点发送图片、PDF、音频、视频、位置或联系人名片。添加快捷回复按钮、多选列表菜单、商品轮播，或位置和联系人请求，让客户点一下即可回复，无需打字。
实时送达跟踪
跟踪消息从 API 受理到已读回执的全过程。
在 WhatsApp 上发送是异步的。Bird 受理你的请求后，webhook 事件和单条消息时间线会显示消息何时交给 WhatsApp、何时送达客户手机以及何时在聊天中被打开。
借助 Meta 错误详情诊断拒绝原因
如果消息在受理后失败，例如服务窗口在发送途中过期或 Meta 拦截了投递，Bird 会在消息记录中保存失败描述和对应的 Meta 错误码，让你的团队判断是重试还是切换渠道。
防止网络重试导致重复发送
在发送请求中附带幂等键，这样在保留期内发生超时或工作进程重试时，会返回原始响应，而不会重复发送消息。
双向工作流的上下文
让客户回复始终关联到正确的订单或工单。
引用之前的消息，让客户在聊天中直接看到你在回答哪个问题或哪笔订单。当客户点击快捷回复按钮、选择列表选项或回复最近的消息时，Bird 会返回所选操作和被引用消息的引用信息，让你的应用立即分发该回复。
为外发消息添加标签和元数据
为外发消息添加最多 20 个可筛选标签和 2 KB 的自定义 JSON 元数据。按营销活动或工作流切分消息日志，并在 API 读取和送达 webhook 中，让内部订单号或工单号始终关联到外发记录。
在代码库、终端或 AI 代理中操作
通过 Bird CLI 发送测试消息、查看送达时间线并筛选近期记录，或通过 Bird MCP 服务器连接你的编程助手，权限受工作区角色和发送方权限管控。
WhatsApp 发送常见问题
请求被接受是否意味着消息已送达？
我可以随时发送自由格式的消息吗？
是否有 WhatsApp 批量发送端点？
如何将交互式回复匹配到我的应用？
规模扩展， 不失控制。
将生产流量和沙盒流量分隔到各自专用的工作区，将 API 密钥的权限限定为每个服务或智能体所需的确切渠道，并在审计日志中跟踪权限变更。