[{"data":1,"prerenderedAt":428},["ShallowReactive",2],{"navigation":3,"\u002Fblog\u002Fapi-whatsapp-official-the-stack-that-keeps-your-number-alive":156,"\u002Fblog\u002Fapi-whatsapp-official-the-stack-that-keeps-your-number-alive-surround":422},[4,23,41,60,78,90,108,137],{"title":5,"path":6,"stem":7,"children":8,"icon":22},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started\u002F1.index",[9,12,17],{"title":10,"path":6,"stem":7,"icon":11},"Introduction","i-lucide-house",{"title":13,"path":14,"stem":15,"icon":16},"Quick Start","\u002Fdocs\u002Fgetting-started\u002Fquick-start","docs\u002F1.getting-started\u002F2.quick-start","i-lucide-zap",{"title":18,"path":19,"stem":20,"icon":21},"Connect WhatsApp Phone Numbers","\u002Fdocs\u002Fgetting-started\u002Fconnect-whatsapp","docs\u002F1.getting-started\u002F3.connect-whatsapp","i-lucide-phone","i-lucide-rocket",{"title":24,"path":25,"stem":26,"children":27,"icon":30},"Team Inbox","\u002Fdocs\u002Finbox","docs\u002F2.inbox\u002F1.index",[28,31,36],{"title":29,"path":25,"stem":26,"icon":30},"Shared Inbox","i-lucide-inbox",{"title":32,"path":33,"stem":34,"icon":35},"Rich Messaging","\u002Fdocs\u002Finbox\u002Frich-messaging","docs\u002F2.inbox\u002F2.rich-messaging","i-lucide-message-square",{"title":37,"path":38,"stem":39,"icon":40},"Contact Details","\u002Fdocs\u002Finbox\u002Fcontact-details","docs\u002F2.inbox\u002F3.contact-details","i-lucide-user-check",{"title":42,"path":43,"stem":44,"children":45,"icon":59},"Messaging","\u002Fdocs\u002Fmessaging","docs\u002F3.messaging\u002F1.index",[46,49,54],{"title":47,"path":43,"stem":44,"icon":48},"Single Message","i-lucide-send",{"title":50,"path":51,"stem":52,"icon":53},"Broadcast","\u002Fdocs\u002Fmessaging\u002Fbroadcast-campaigns","docs\u002F3.messaging\u002F2.broadcast-campaigns","i-lucide-megaphone",{"title":55,"path":56,"stem":57,"icon":58},"Campaign History","\u002Fdocs\u002Fmessaging\u002Fcampaign-history","docs\u002F3.messaging\u002F3.campaign-history","i-lucide-bar-chart","i-lucide-message-circle",{"title":61,"path":62,"stem":63,"children":64,"icon":77},"Contacts","\u002Fdocs\u002Fcontacts","docs\u002F4.contacts\u002F1.index",[65,67,72],{"title":10,"path":62,"stem":63,"icon":66},"i-lucide-book-user",{"title":68,"path":69,"stem":70,"icon":71},"Contact Lists","\u002Fdocs\u002Fcontacts\u002Flists-segmentation","docs\u002F4.contacts\u002F2.lists-segmentation","i-lucide-list-filter",{"title":73,"path":74,"stem":75,"icon":76},"Bulk Import","\u002Fdocs\u002Fcontacts\u002Fimporting-contacts","docs\u002F4.contacts\u002F3.importing-contacts","i-lucide-file-spreadsheet","i-lucide-users",{"title":79,"path":80,"stem":81,"children":82,"icon":84},"Templates","\u002Fdocs\u002Ftemplates","docs\u002F5.templates\u002F1.index",[83,85],{"title":10,"path":80,"stem":81,"icon":84},"i-lucide-file-text",{"title":86,"path":87,"stem":88,"icon":89},"Template Syncing","\u002Fdocs\u002Ftemplates\u002Fsyncing-managing-templates","docs\u002F5.templates\u002F2.syncing-managing-templates","i-lucide-refresh-cw",{"title":91,"path":92,"stem":93,"children":94,"icon":97},"AI Chatbots","\u002Fdocs\u002Fai-chatbots","docs\u002F6.ai-chatbots\u002F1.index",[95,98,103],{"title":96,"path":92,"stem":93,"icon":97},"WhatsBox Bots","i-lucide-bot",{"title":99,"path":100,"stem":101,"icon":102},"Tools","\u002Fdocs\u002Fai-chatbots\u002Ftools","docs\u002F6.ai-chatbots\u002F2.tools","i-lucide-wrench",{"title":104,"path":105,"stem":106,"icon":107},"MS Copilot Studio","\u002Fdocs\u002Fai-chatbots\u002Fcopilot-studio","docs\u002F6.ai-chatbots\u002F3.copilot-studio","i-lucide-cpu",{"title":109,"path":110,"stem":111,"children":112,"icon":136},"Integrations","\u002Fdocs\u002Fintegrations","docs\u002F7.integrations\u002F1.index",[113,116,121,126,131],{"title":114,"path":110,"stem":111,"icon":115},"Developer API","i-lucide-code",{"title":117,"path":118,"stem":119,"icon":120},"Google Sheets","\u002Fdocs\u002Fintegrations\u002Fgoogle-sheets","docs\u002F7.integrations\u002F2.google-sheets","i-lucide-sheet",{"title":122,"path":123,"stem":124,"icon":125},"Firebase Extension","\u002Fdocs\u002Fintegrations\u002Ffirebase-ext","docs\u002F7.integrations\u002F3.firebase-ext","i-lucide-flame",{"title":127,"path":128,"stem":129,"icon":130},"Slack","\u002Fdocs\u002Fintegrations\u002Fslack","docs\u002F7.integrations\u002F4.slack","i-lucide-slack",{"title":132,"path":133,"stem":134,"icon":135},"Zapier","\u002Fdocs\u002Fintegrations\u002Fzapier","docs\u002F7.integrations\u002F5.zapier","i-lucide-blocks","i-lucide-plug",{"title":138,"path":139,"stem":140,"children":141,"icon":155},"Settings & Billing","\u002Fdocs\u002Fsettings","docs\u002F8.settings\u002F1.index",[142,145,150],{"title":143,"path":139,"stem":140,"icon":144},"Team Members","i-lucide-users-round",{"title":146,"path":147,"stem":148,"icon":149},"Miscellaneous","\u002Fdocs\u002Fsettings\u002Faccount-settings","docs\u002F8.settings\u002F2.account-settings","i-lucide-building",{"title":151,"path":152,"stem":153,"icon":154},"Billing","\u002Fdocs\u002Fsettings\u002Fbilling-usage","docs\u002F8.settings\u002F3.billing-usage","i-lucide-credit-card","i-lucide-settings",{"id":157,"title":158,"authors":159,"badge":164,"body":166,"date":406,"description":407,"draft":408,"extension":409,"image":410,"meta":411,"navigation":412,"path":413,"schemaOrg":414,"seo":415,"sitemap":417,"stem":420,"__hash__":421},"posts\u002Fblog\u002Fapi-whatsapp-official-the-stack-that-keeps-your-number-alive.md","API WhatsApp Official: The Stack That Keeps Your Number Alive",[160],{"name":161,"avatar":162},"WhatsBox Team",{"text":163},"WB",{"label":165},"Api whatsapp official",{"type":167,"value":168,"toc":389},"minimark",[169,177,184,189,201,204,207,210,214,224,227,230,233,242,246,249,277,285,289,292,295,298,301,304,308,311,314,322,326,329,340,343,356,360,365,368,372,375,379,382,386],[170,171,172,176],"p",{},[173,174,175],"strong",{},"The API WhatsApp official term names one thing: Meta's WhatsApp Business Platform, the managed gateway that replaced the consumer app's one-to-one model with a system built for automation, shared inboxes, and programmatic control."," Everything else that calls itself a WhatsApp API, from wrapper libraries to browser automation scripts, is a different animal with a different legal footing. The distinction matters because the cost of picking wrong shows up months later as a banned number.",[170,178,179],{},[180,181],"img",{"alt":182,"src":183},"cover","https:\u002F\u002Fstatic.whatsbox.io\u002Fblog-images\u002Fwhatsbox\u002Fai-1682773099-825644091e8700f8e6a7622e.webp",[185,186,188],"h2",{"id":187},"what-api-whatsapp-official-actually-names","What API WhatsApp Official Actually Names",[170,190,191,200],{},[173,192,193,194,199],{},"The official ",[195,196,198],"a",{"href":197},"\u002Fblog\u002Fwhatsapp-business-api-what-most-setup-guides-get-wrong-about-it","WhatsApp Business"," API is Meta's gateway for sending and receiving messages at scale through approved partners, not a piece of software you install."," Onboard a number through a Business Solution Provider, connect a webhook, and Meta routes your traffic from there. Nothing lands on your laptop.",[170,202,203],{},"That gateway serves a specific shape of business: one sending transactional updates to thousands of customers, routing replies to a team, or triggering messages from a CRM. A one-person shop answering a handful of questions a day does not need it, and the free business app covers that ground.",[170,205,206],{},"The confusion starts with vocabulary. A wrapper library that drives the consumer app is not the official API. Neither is a session-based script that logs in with a QR code. Both can look identical in a demo because both send a text message. The difference is who owns the pipe.",[170,208,209],{},"Meta separates the free WhatsApp Business app, the paid Business Platform, and the consumer app into distinct products with distinct rules. Sending through the business app is described as private one-to-one messaging to multiple people at once, and the official documentation says you can message people even if they have not saved your number, which is a convenience that also explains why opt-in enforcement lives at the platform level rather than in the app.",[185,211,213],{"id":212},"how-the-pipeline-works-under-the-hood","How the Pipeline Works Under the Hood",[170,215,216,217,223],{},"The API is a hybrid control plane and delivery rail: Meta's cloud hosts the routing, the business host runs the webhook listener that answers it. A 2026 study of the WhatsApp Business API in the Indian market frames it this way, as a service layer businesses integrate against rather than software they operate (",[195,218,222],{"href":219,"rel":220},"https:\u002F\u002Fdoi.org\u002F10.5281\u002Fzenodo.18831419",[221],"nofollow","Zenodo","). Concrete moving parts sit between your message and the recipient's phone.",[170,225,226],{},"A message template is the first of them. Outside an open 24-hour customer service window, every business-initiated message must use a template that Meta approved in advance, with placeholders filled at send time. The template is not a formatting suggestion; it is the permission slip, and its category (marketing, utility, authentication) determines what the send costs.",[170,228,229],{},"The webhook is the second. When a customer replies, Meta posts that event to your endpoint. If the endpoint is down, the message does not queue politely for a week. It is delivered as an event and then gone, which is why message logging belongs on your side of the connection.",[170,231,232],{},"The 24-hour window is the third, and it is the one that drives most of the architecture. A customer's inbound message opens a window in which you can reply with free-form text. The window closes 24 hours later, and the next outbound message must be a template again. Teams that build their automation without modeling that clock end up with workflows that work in testing and fail in production.",[170,234,235,236,241],{},"Understand the history and the shape makes sense. In March 2024, Meta announced that WhatsApp would let third-party messaging services enable interoperability with WhatsApp, a requirement of the EU's Digital Markets Act (DMA) (",[195,237,240],{"href":238,"rel":239},"https:\u002F\u002Fen.wikipedia.org\u002Fwiki\u002FWhatsApp",[221],"WhatsApp on Wikipedia","). Interoperability pressures the platform toward standard interfaces, and the API's already-strict onboarding rules are the visible edge of that pressure. Meta wants a system where identity, consent, and content are all checkable at the boundary. It is why the review process exists and why a number can be cut off for behavior that would be unremarkable on email.",[185,243,245],{"id":244},"how-to-do-it","How to Do It",[170,247,248],{},"Getting from zero to a live send is a sequence, not a signup form. Skipping a step sends you back to the start.",[250,251,252,256,259,262,265,268,271,274],"ol",{},[253,254,255],"li",{},"Claim a phone number that has never been registered on the consumer WhatsApp app. If it has, deregister it and wait for the cooldown.",[253,257,258],{},"Create or join a Meta Business Manager account and finish business verification: legal name, address, and the documents that match them.",[253,260,261],{},"Pick how you will connect. Either work through a Business Solution Provider, or go direct where Meta offers a self-serve path. This is the decision that changes your timeline more than any other.",[253,263,264],{},"Register the display name you want customers to see. Meta reviews it against the business name on file, and a mismatch stalls the whole setup.",[253,266,267],{},"Generate a permanent access token and store it like a password, never in client-side code.",[253,269,270],{},"Point your webhook at a server you control, subscribe to the message events you need, and confirm the verification handshake.",[253,272,273],{},"Submit your first message templates, one per use case, and wait for approval before building flows that depend on them.",[253,275,276],{},"Test in a sandbox or with a small internal list before you touch a real customer, then check whether your reply routing still holds when a second agent logs in.",[170,278,279,280,284],{},"That last step is where a send tool becomes a conversation system. If multiple people will answer customers, the tooling around the API has to handle assignment and session state, or two agents will reply to the same person twice. Teams that need that layer usually find it as a feature set rather than something they assemble from endpoints, which is what separates the ",[195,281,283],{"href":282},"\u002Fblog\u002Ftop-5-features-of-whatsapp-business-api-every-marketer-should-know","features every marketer should know"," from a bare HTTP client.",[185,286,288],{"id":287},"common-mistakes-to-avoid","Common Mistakes to Avoid",[170,290,291],{},"Treating an unofficial library as a budget version of the real thing tops the list. A wrapper that automates the consumer app can send messages, but it does it by impersonating a user, so Meta's anti-spam systems see a human account behaving like a robot. The ban arrives without an appeal process you can win, and you lose the number your customers already know.",[170,293,294],{},"Importing email's opt-in culture is the second trap. Email tolerates a fair amount of ignore-and-delete before a sender's reputation suffers. WhatsApp does not. A pre-approved template sent to someone who never consented gets the template paused, and a run of blocks gets the number's quality rating cut. The old pattern of buying a list and testing it has no safe version here.",[170,296,297],{},"Ignoring the session clock is the third, and it looks like a bug when it is not. An automation that fires a free-form message on day two works in development, where you open windows manually, and fails in production. Build the 24-hour window into your state machine on day one, and the surprise never happens.",[170,299,300],{},"Picking a provider on list price alone is the fourth. The conversation fee is only part of the bill, and a cheap per-message rate often hides per-seat charges, onboarding fees, or markup on template sends. The provider pricing comparisons worth reading break out every line rather than quoting one number, because the number that catches you is rarely the advertised one.",[170,302,303],{},"Letting business verification lag is a fifth, and it sabotages everything downstream. Display names do not get approved against unverified businesses, templates get rejected, and the whole launch slides by a week while nothing on your side is broken. Finish the paperwork before you write code.",[185,305,307],{"id":306},"how-to-decide","How to Decide",[170,309,310],{},"You face two real options, and the honest framing is not \"which is cheaper.\" The question is who owns the pipeline when something breaks at 11 p.m.",[170,312,313],{},"If your messaging is high-volume, transactional, or tied to a CRM, a managed platform earns its fee by absorbing the plumbing. You get onboarding handled, template management surfaced in a UI, and webhooks that someone else monitors. In return you accept a platform in the middle and whatever their integration limits are. If your volume is a few hundred conversations a month and one person answers them, the free business app is genuinely sufficient, and moving to the API would add overhead you do not get back.",[170,315,316,317,321],{},"The signal that settles it is the second person. The moment two or three agents need to answer the same number without stepping on each other, the consumer app stops working, and the question is not whether to move but what carries you. That need alone pushes teams toward the API and away from any hand-rolled script. The ",[195,318,320],{"href":319},"\u002Fblog\u002Fthe-whatsapp-mailbox-why-a-shared-inbox-needs-the-business-api","shared inbox and the business API"," problem is structural: the consumer app has no concept of an agent queue, so no amount of clever scripting gives you one built on top of it. Build on the wrong layer and you fix the same problem twice.",[185,323,325],{"id":324},"about-whatsbox","About WhatsBox",[170,327,328],{},"We built on the official WhatsApp Business Platform because the alternative eventually punishes the customer, and the shared Team Inbox is where most teams feel the difference first. Message history, templates, and assignment live in one place, so a reply does not depend on which phone is in whose pocket.",[170,330,331,332,334,335,339],{},"Around that inbox we put the pieces we kept watching teams build by hand: bulk broadcast campaigns through the WhatsApp Business API, custom-trained AI chatbots with a knowledge base, and workflow automations that run through a Zapier connection to ",[195,333,117],{"href":118}," and Google Forms. A human-in-the-loop escalation path handles the conversations a bot should not close on its own, and a whitelabel ",[195,336,338],{"href":337},"\u002Fwhatsapp-chat-widget","chat widget"," puts the same inbox on your website. The Pay-Per-Use plan is free during its beta phase, with no seat fees, no user limits, and no contract.",[170,341,342],{},"Choose something else if your volume is a handful of conversations a week and one person answers them, because the free business app costs nothing and the API would add setup you never use.",[170,344,345,346,350,351,355],{},"For everyone running broadcast campaigns next to support, ",[195,347,349],{"href":348},"\u002Fcontact-us","our contact page"," is how we start, and ",[195,352,354],{"href":353},"\u002Fpricing","current pricing"," is where the plan details live.",[185,357,359],{"id":358},"frequently-asked-questions","Frequently Asked Questions",[361,362,364],"h3",{"id":363},"is-whatsapp-official-api-free","Is WhatsApp official API free?",[170,366,367],{},"No. Meta bills per conversation on the Business Platform, and the rate depends on the template category and the country you are sending into. Your provider may add its own layer on top, which is why the total cost usually differs from Meta's published rate. The free part is the WhatsApp Business app, a separate product with different limits. WhatsBox runs a Pay-Per-Use plan that is free during its beta phase.",[361,369,371],{"id":370},"who-are-the-official-whatsapp-api-partners","Who are the official WhatsApp API partners?",[170,373,374],{},"Business Solution Providers approved by Meta to onboard businesses and carry their traffic. They range from large communications vendors with their own developer tooling to smaller platforms focused on one vertical or one region. What they share is the right to provision your number and route your messages through Meta's infrastructure. The practical differences show up in support, template handling, and what the platform adds on top of the raw API.",[361,376,378],{"id":377},"is-the-whatsapp-api-legal","Is the WhatsApp API legal?",[170,380,381],{},"Yes, and it is the only compliant route for business messaging at scale. Meta authorizes the Business Platform, and using it with proper opt-in satisfies consent rules like the GDPR. The illegal-adjacent part is the unofficial side: libraries that automate the consumer app break Meta's terms and often breach data protection law by messaging people without a lawful basis. Legality turns on consent and authorization, not on the protocol.",[361,383,385],{"id":384},"do-i-need-a-new-phone-number-for-the-api","Do I need a new phone number for the API?",[170,387,388],{},"Yes, in nearly every case. The API covers a number that has never been registered on the consumer WhatsApp app, and if yours has, you deregister it and wait out the cooldown before onboarding. Reusing a number your customers already know is worth the wait, because the alternative is telling everyone to update their saved contact.",{"title":390,"searchDepth":391,"depth":391,"links":392},"",2,[393,394,395,396,397,398,399],{"id":187,"depth":391,"text":188},{"id":212,"depth":391,"text":213},{"id":244,"depth":391,"text":245},{"id":287,"depth":391,"text":288},{"id":306,"depth":391,"text":307},{"id":324,"depth":391,"text":325},{"id":358,"depth":391,"text":359,"children":400},[401,403,404,405],{"id":363,"depth":402,"text":364},3,{"id":370,"depth":402,"text":371},{"id":377,"depth":402,"text":378},{"id":384,"depth":402,"text":385},"2026-10-09","The official WhatsApp API is a managed message pipeline, not a download. Here is what the term covers, how onboarding works, and where unofficial shortcuts fail.",false,"md",{"src":183},{},true,"\u002Fblog\u002Fapi-whatsapp-official-the-stack-that-keeps-your-number-alive",null,{"title":158,"description":416},"API WhatsApp official means Meta's Business Platform, not a wrapper. What the term covers, how onboarding works, and what to check before you send.",{"loc":413,"images":418},[419],{"loc":183},"blog\u002Fapi-whatsapp-official-the-stack-that-keeps-your-number-alive","2gcuyGiSJR0UxLSIKhL5GxRuy47al0coNWMl6A2tCWs",[414,423],{"title":424,"path":425,"stem":426,"description":427,"children":-1},"Can I Send a Broadcast Message on WhatsApp? Yes, With Limits","\u002Fblog\u002Fcan-i-send-a-broadcast-message-on-whatsapp-yes-with-limits","blog\u002Fcan-i-send-a-broadcast-message-on-whatsapp-yes-with-limits","You can send a WhatsApp broadcast from a personal account, the free Business app, or the official Business API.",1791571879299]