Harbor组织工作区生产环境沙盒
发送代理
API 密钥 · 客户运营团队ALAlex Lee 管理员权限已更新
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。
如何将交互式回复匹配到我的应用？
使用显式的回复标识符关联你存储的会话或任务状态。引用消息引用在可用时可以提供帮助，但外发消息的元数据不会自动被回复继承。
规模扩展
不失控。
在工作区中组织团队，控制 API 访问权限，通过审计日志追踪变更。
Harbor组织有效
审计日志
生产环境- 工作区
- 生产环境
- 资源
- 发送代理
- 读取权限读写
团队 客户运营操作者角色 管理员结果 成功时间 9 月 22 日，09:42:18 UTC
成功