WhatsAppResources
WhatsApp guides. Find your next step.
Explore practical guides, channel explanations and operating advice. Connect the first message to a useful conversation, a business action and a result you can measure.
Companies that trust Bird across their communications.
Read Bird customer storiesPlan a campaign
The Basics of WhatsApp MarketingUnderstand campaigns, templates, conversations, native Flows and measurement. Choose the right WhatsApp journey for your customers.WhatsApp Marketing Launch GuidePlan your first WhatsApp campaign: audience permission, approved templates, response handling, attribution and a controlled launch.How to Grow Your WhatsApp Subscriber ListBuild a WhatsApp audience with clear opt-ins, useful entry points and source tracking. Improve qualified growth and keep preferences current.A WhatsApp Ecommerce Campaign BlueprintBuild an ecommerce WhatsApp journey from audience and product data to approved content, customer help, checkout and confirmed order attribution.
Create a useful customer experience
How to Write Effective WhatsApp TemplatesDesign WhatsApp templates with clear copy, accurate categories, useful actions and reliable personalization. Prepare approval and test the complete journey.14 Ways to Personalize WhatsApp MarketingMake WhatsApp messages more useful with customer preferences, relevant triggers, accurate product data, helpful AI and connected destinations.12 Practical WhatsApp Campaign ExamplesUse twelve WhatsApp campaign briefs for discovery, purchase and retention, with sample copy, appropriate destinations and measurable outcomes.Practical AI Tactics for Email, SMS and WhatsAppUse AI for campaign briefs, creative variants, analysis and customer assistance, with accurate source data and measurable outcomes.
Measure and grow
How to Benchmark WhatsApp Marketing PerformanceDefine delivery, read, click, reply and conversion rates correctly. Compare similar cohorts and use business outcomes to improve WhatsApp campaigns.How to Calculate WhatsApp Marketing ROICalculate WhatsApp campaign ROI using published rates, confirmed outcomes, contribution margin and an explicit attribution model.How to Scale WhatsApp MarketingScale WhatsApp campaigns through relevant audiences, connected commerce, AI assistance, quality monitoring and measured business outcomes.How to Choose a WhatsApp Marketing PlatformEvaluate WhatsApp platforms through a real campaign, including account ownership, templates, AI handoff, attribution, pricing and migration.
Coordinate channels and seasons
How to Coordinate Email and WhatsApp MarketingPlan email and WhatsApp around one customer journey, with channel-specific consent, matched content, shared stop conditions and honest attribution.Email Lessons for SMS and WhatsApp MarketingAdapt email practices for SMS and WhatsApp: clear permission, relevant audiences, concise creative, controlled automation and comparable measurement.How to Build a WhatsApp Campaign CalendarPlan WhatsApp campaigns around relevant local events, customer needs and operational deadlines. Use a reusable calendar brief and launch sequence.Build Customer Loyalty on WhatsApp During Peak SeasonPlan useful holiday WhatsApp journeys for gift advice, order updates, returns and repeat purchases, with accurate promises and coordinated frequency.
Start a customer conversation
WhatsApp overviewHow Bird WhatsApp works: send templates from a Bird-managed or your own number, receive messages, track delivery, and find each guide.WhatsApp phone numbersThe two kinds of WhatsApp sender: Bird-managed numbers that need no setup, and a number of your own connected through Embedded Signup.Sending WhatsApp messagesSend a WhatsApp template or service message with POST /v1/whatsapp/messages: the request envelope, the customer service window, the async 202 model, and cost.Receiving WhatsApp messagesRead inbound WhatsApp messages over the API or the dashboard, fetch the media a contact sent, and subscribe to the whatsapp.received webhook event.FastAPI integrationSend WhatsApp from a server route, retain request identity and inspect its status.Express integrationSend WhatsApp from a server route, retain request identity and inspect its status.Next.js integrationSend WhatsApp from a server route, retain request identity and inspect its status.Build a WhatsApp customer-service workflowWork through a booking request, expired-window recovery and handoff with a reusable service checklist.Prepare a WhatsApp AI agent and handoffConnect trusted knowledge, authorized actions, evaluation and a clear human continuation.Business-scoped user IDsWhy WhatsApp contacts reach you without a phone number, what a business-scoped user ID is, and how to ask a contact to share their number.Resolve a WhatsApp customer-service requestBuild a signed FastAPI receiver and persistent reply worker; follow delivery and read events.
Templates and campaigns
Authoring WhatsApp templatesCreate a WhatsApp template of your own, by duplicating one from Bird's catalog or starting from scratch, then write each language, submit it for review, and send it.Launch a useful WhatsApp campaignPrepare an eligible audience, approved message, response handling and measurable business outcome.WhatsApp templatesBrowse the WhatsApp templates a workspace can send, inspect each one's category, languages, and variables, then send it by slug.WhatsApp authentication templatesSend a one-time passcode over WhatsApp with an authentication template, including the copy-code button and the business verification gate.WhatsApp marketing templatesSend a promotional WhatsApp message with a marketing template, including the business account you need and the opt-out expectation.WhatsApp utility templatesSend order updates, appointment reminders, and account notices over WhatsApp with a utility template, and fill its variables correctly.
Native interactions
WhatsApp interactive messagesSend reply buttons, list menus, link buttons, media carousels, and location or contact requests inside an open customer service window.WhatsApp media carouselsSend two to ten swipeable WhatsApp cards, each with its own image or video and buttons, and read which card the recipient acted on.WhatsApp contact info requestsAsk a WhatsApp recipient to share a phone number with a single button, and read the contact card they send back.WhatsApp link buttonsSend a WhatsApp message with one call-to-action button that opens a URL, and see what a tap does and does not report back.WhatsApp list menusSend a WhatsApp list menu of up to ten rows across its sections, and read which row slug the recipient tapped from the reply.WhatsApp location requestsAsk a WhatsApp recipient to share their location with a single button, and read the coordinates that come back as an inbound message.WhatsApp reply buttonsSend up to three tappable quick-reply buttons on a WhatsApp message and read which one the recipient chose from the reply.Build a focused WhatsApp FlowDesign a native form, connect live choices and validate the submitted result.Receiving WhatsApp interactive repliesRead what a WhatsApp contact tapped: a reply button, a list row, or a template quick reply, and the two taps that answer on other arms.
Media and message content
WhatsApp service messagesThe nine content arms a WhatsApp service message can carry, the customer service window that gates delivery, sending media by URL, and what a failed fetch costs.WhatsApp audio messagesSend a voice note or audio clip by URL on WhatsApp, its size limit, the voice flag, and how to read an inbound audio message.WhatsApp contact cardsSend up to five contact cards on WhatsApp, the name and length limits Bird enforces, what earns a card a tappable button, and how a card reads back.WhatsApp document messagesSend a PDF, spreadsheet, or other file by URL on WhatsApp, its size and filename limits, and how to read an inbound document.WhatsApp image messagesSend a photo or graphic by URL on WhatsApp, its size and caption limits, and how to read an inbound image a contact sent you.WhatsApp location messagesSend a pin with a latitude and longitude on WhatsApp, its coordinate and text limits, and how an inbound location shared by a contact reads back.WhatsApp plain text messagesSend a WhatsApp message that carries only a body and an optional link preview, its length limit, and how an inbound reply reads back.WhatsApp sticker messagesSend a WebP sticker by URL on WhatsApp, its size limits for static and animated stickers, and how to read an inbound sticker.WhatsApp video messagesSend a video clip by URL on WhatsApp, its size and caption limits, and how to read an inbound video a contact sent you.Receiving WhatsApp audioRead an inbound WhatsApp audio message, tell a recorded voice note from an attached file, and fetch the audio a contact sent you.Receiving WhatsApp contact cardsRead a contact card a WhatsApp contact shared or a phone number they disclosed by tapping your request, and tell the two apart with origin.Receiving WhatsApp documentsRead an inbound WhatsApp document, its filename and caption, and fetch the file a contact sent you without trusting the name they gave it.Receiving WhatsApp imagesRead an inbound WhatsApp image, its stored media reference and caption, and fetch the bytes a contact sent you with your API key.Receiving WhatsApp locationsRead an inbound WhatsApp location, the place name and address it sometimes carries, and the pin that answers a location request you sent.Receiving WhatsApp text messagesRead the text a WhatsApp contact typed, on the API and on the whatsapp.received webhook, including a message they sent as a quoted reply.Receiving WhatsApp stickersRead an inbound WhatsApp sticker, tell an animated one from a static one, and fetch the WebP file a contact sent you.Unsupported WhatsApp message typesRead an inbound WhatsApp message whose content the API does not model, including catalog orders and system notices, and handle a content type added later.Receiving WhatsApp videoRead an inbound WhatsApp video message, its stored media reference and caption, and fetch the clip a contact sent before it expires.
Delivery and operations
WhatsApp eventsRead WhatsApp message timelines through the events API and subscribe to public outbound delivery events through webhooks.WhatsApp logBrowse, filter, and inspect every WhatsApp message your workspace sends from the Messages page: statuses, the per-message event timeline, and delivery detail.Opt-outs and keywordsHow Bird answers STOP and START on your numbers, how a suppression or an opt-out preference stops your sends, and how to change the replies or add keywords of your own.Use read acknowledgements, typing and reactionsMake service exchanges responsive while preserving message and reaction semantics.WhatsApp metricsHow to read the WhatsApp Metrics page in the Bird dashboard: delivery and failure rates, accepted volume, latency, and the per-dimension breakdowns.
Provider migrations
Plan a WhatsApp migration from 360dialog to BirdInventory the 360dialog integration, prepare the supported sender transition and verify the complete WhatsApp journey in Bird.Plan a WhatsApp migration from Infobip to BirdInventory the Infobip integration, prepare the supported sender transition and verify the complete WhatsApp journey in Bird.Plan a WhatsApp migration from Twilio to BirdInventory the Twilio integration, prepare the supported sender transition and verify the complete WhatsApp journey in Bird.Plan a WhatsApp migration from Wati to BirdInventory the Wati integration, prepare the supported sender transition and verify the complete WhatsApp journey in Bird.
WhatsApp explained
How do click-to-WhatsApp ads differ from WhatsApp campaigns?A click-to-WhatsApp ad attracts a customer into a conversation. A WhatsApp campaign sends eligible messages to an existing audience.Do I need Meta verification before connecting a WhatsApp number?You can connect and send from your own WhatsApp number before Meta verifies your business, but the number itself must complete phone verification during setup.How do I change my WhatsApp business display name?Send the new name on the number's profile and wait. The old name keeps showing until WhatsApp decides, and a requested change cannot be withdrawn.How do I check whether WhatsApp will accept a phone number?Run Bird's WhatsApp number precheck before buying a candidate. Interpret available and unavailable, preserve retry keys, and understand what the check changes.How do I choose a WhatsApp Business API provider?Compare WhatsApp providers on account access, total fees, programmable setup, delivery events and migration support, with Meta's channel rules kept separate.How does WhatsApp Embedded Signup work?See what Embedded Signup connects, who must complete it, which assets stay with your business and what remains after the dialog closes.How is WhatsApp Business API messaging billed?Understand Meta's delivered-message charges, category rules, free entry points and provider fees before estimating a WhatsApp API bill.What are WhatsApp interactive messages, and which one should I use?Buttons, list menus and link buttons are separate message types with different limits. The choice follows how many options you have and where the answer lives.What is a WhatsApp click-to-chat link, and how do I build one?Build a WhatsApp link with your international number and optional encoded text, or create a short link whose prefilled message can change after publishing.What is a WhatsApp message template?Use approved WhatsApp content outside the service window, check which language can send, and create a fresh draft when you need to change a submitted version.What is the 24-hour customer service window on WhatsApp?Reply with free-form WhatsApp content within 24 hours of the customer's message or call, and use an approved template when that conversation window closes.What is WhatsApp opt-in?Learn what Meta requires a WhatsApp opt-in to say, how to keep permission evidence, and why an open service window is not consent.Is a WhatsApp AI agent the same as MCP access?A customer-facing AI agent handles a conversation. MCP access lets an authorized agent or tool operate Bird resources.WhatsApp Business app vs API: which do I need?Choose the WhatsApp Business app for hands-on conversations or the API for software-driven messaging, delivery events and team workflows.Is WhatsApp calling the same as a telephone call?WhatsApp Business Calling uses WhatsApp’s calling experience and permission model. It is distinct from ordinary telephone voice.Is a WhatsApp campaign the same as a group?A campaign sends private messages to individual recipients. A group is a shared conversation with deliberate participant visibility.What is the difference between whatsapp.failed and whatsapp.rejected?Separate Bird's uncharged WhatsApp rejections from message failures, inspect the event and error together, and choose recovery from the recorded cause.How are WhatsApp Flows different from automation journeys?WhatsApp Flows provides a native form inside the chat. An automation journey coordinates the wider business process.Does a WhatsApp read count as a conversion?A read is a messaging observation. A conversion is a separately defined and recorded business outcome.Why can a WhatsApp Business Account or number stop sending?A WhatsApp number can be rate limited, restricted or banned. Learn what each state means, where Bird reports it, and which recovery belongs to Meta.Why was my WhatsApp template rejected?Read the language's status and reason to separate Meta's content rejection from submission failures, then correct a draft or wait for an unknown result.
Account, policy and delivery help
WhatsApp account restrictions and appealsFind WhatsApp quality, restriction and ban states in Meta and Bird, request a review, and understand what Bird support can change.WhatsApp authentication-international ratesWhy authentication codes to some countries cost more, what Meta checks before charging the higher rate, and how you learn your start times for each market.WhatsApp business verificationUnderstand business verification, number verification and the requirements shown for your account.The WhatsApp customer service windowThe 24-hour customer service window on WhatsApp: when it opens, when it resets, and why reaching someone outside it takes an approved template.Marketing templatesHow a marketing template sends over Meta's Marketing Messages API, what the business account's onboarding status means, and where marketing is limited.Number quality and messaging limitUnderstand the quality rating and messaging allowance reported for your business, and the steps that protect your ability to reach customers.Why pre-verification fails, and when to try againCheck the verification route, code lifetime and retry timing when a code does not arrive.WhatsApp template guidelinesWhat Meta allows in a WhatsApp template: per-component character limits, variable rules, the review timeline, and the reasons templates get rejected.
Choose the task you are working on
WhatsApp marketingCreate relevant campaigns and help customers respond.WhatsApp APIConnect messages, replies and delivery events to your application.WhatsApp conversationsBring customer context, AI and your team into one conversation.WhatsApp AI agentsAnswer questions, take action and hand over to your team.WhatsApp FlowsLet customers book, choose and share details inside WhatsApp.WhatsApp callingContinue the conversation with a helpful voice call.
Put it into practice.
Continue with the documentation, guides and examples for this topic. Resources are in English.
Watch the guideConnecting WhatsApp to Bird: from buying a number to a live channelUse the toolWhatsApp message builderFollow the learning pathBuild your first integration
Try the practice and get an implementation briefTalk to our WhatsApp team
Put the guide into practice.
Connect your sender, prepare an approved template and follow the first exchange through to its result.