Send WhatsApp updates, passcodes, and interactive replies from one API.

Deliver order confirmations, one-time passcodes, rich media, and interactive buttons or list menus right into your customers’ WhatsApp chats. Bird validates template parameters and checks the 24-hour customer service window before dispatching, preventing failed calls and surprise charges while streaming delivery and read receipts back to your app.

开始使用联系销售
1
2
3
4
5
6
7
8
9
10
11
// Install the SDK
// npm install @messagebird/sdk


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);

Send your first message in minutes with our TypeScript, Python, Go, or PHP SDKs, the Bird CLI, or direct HTTP requests. Start immediately with Bird’s pre-approved templates while your own WhatsApp Business number is being verified.

Templates and 24-hour window

Send the right format inside or outside the 24-hour window.

WhatsApp separates business-initiated outreach from active customer conversations. Reach customers outside an active chat using Meta-approved utility, authentication, or marketing templates, then switch to free-form text, media, and interactive menus for 24 hours after they message or call you.

Catch closed windows and variable mismatches upfront

Bird tracks the 24-hour customer service window per recipient and business number. If your app tries to send a free-form message after the window closes, or passes template variables that do not match your placeholders, the API rejects the call before anything is created or billed.

Rich media, interactive buttons, and list menus

When a conversation is open, send images, PDFs, audio clips, videos, locations, or contact cards from a single endpoint. Add quick-reply buttons, multi-option list menus, product carousels, or location and contact requests so customers can tap instead of typing.

Real-time delivery tracking

Track messages from API acceptance to read receipt.

Sending on WhatsApp is asynchronous. Once Bird accepts your request, webhook events and the per-message timeline show when the message is handed to WhatsApp, delivered to the customer’s phone, and opened in chat.

Diagnose rejections with Meta error details

If a message fails after acceptance, such as when a service window expires in flight or Meta blocks delivery, Bird records the failure description and underlying Meta error code on the message record so your team knows whether to retry or switch channels.

Prevent duplicate sends on network retries

Include an idempotency key with your send request so a timeout or worker retry within the retention window replays the original response instead of sending a duplicate message.

Context for two-way workflows

Keep customer replies connected to the right order or ticket.

Quote an earlier message so your customer sees which question or order you are answering right in their chat. When a customer taps a quick-reply button, picks a list option, or replies to a recent message, Bird returns the selected action and quoted message reference so your app can route the response immediately.

Tag and attach metadata to outbound sends

Add up to 20 filterable tags and 2 KB of custom JSON metadata to an outbound message. Slice message logs by campaign or workflow, and keep your internal order or ticket IDs attached to the outbound record across API reads and delivery webhooks.

Operate from your codebase, terminal, or AI agent

Send test messages, inspect delivery timelines, and filter recent history from the Bird CLI or connect your coding assistant through the Bird MCP server, governed by your workspace’s role and sender permissions.

WhatsApp sending questions

请求被接受是否意味着消息已送达？
不能。API 接受请求、Meta 接收消息、送达和已读是不同的观测状态。请分别确认相关消息状态和业务结果。
我可以随时发送自由格式的消息吗？
自由格式回复取决于客服窗口期和支持的内容类型。在窗口期之外，请使用符合条件的已审批模板。
是否有 WhatsApp 批量发送端点？
已发布的消息 API 用于发送单条消息。请根据文档中的限制控制应用的扇出速率；不要假设邮件群发端点同样可以发送 WhatsApp。
如何将交互式回复匹配到我的应用？
使用显式的回复标识符关联你存储的会话或任务状态。引用消息引用在可用时可以提供帮助，但外发消息的元数据不会自动被回复继承。

连接完整旅程

WhatsApp sending guideSend templates, free-form media, and interactive buttons, and verify delivery receipts.WhatsApp 模板Design utility, marketing, and authentication templates and track Meta approval by language.WhatsApp 会话Reply from a shared team inbox, manage labels, and hand off between AI and teammates.WhatsApp 分析Track delivery rates, read receipts, customer replies, and failure reasons across numbers.WhatsApp 资源库Browse developer guides, technical answers, and provider comparisons.WhatsApp 平台Explore business numbers, broadcasts, Flows, and two-way support on Bird.

规模扩展
不失控。

在工作区中组织团队，控制 API 访问权限，通过审计日志追踪变更。

工作区团队角色API 身份验证
了解企业方案

从 WhatsApp 开始。
使用 Bird 跨渠道构建。

开始使用联系销售

你的下一个创意。 随时连接。

开始使用联系销售