[{"data":1,"prerenderedAt":391},["ShallowReactive",2],{"guide:anti-ban-guide":3},{"id":4,"title":5,"body":6,"date":377,"description":378,"extension":379,"meta":380,"navigation":381,"path":382,"seo":383,"stem":384,"tags":385,"updated":389,"__hash__":390},"guides\u002Fdocs\u002Fanti-ban-guide.md","WhatsApp Anti-Ban Guide",{"type":7,"value":8,"toc":368},"minimark",[9,18,23,26,81,88,92,101,191,199,203,213,224,235,256,262,268,274,280,286,300,304,307,345,348,352,358],[10,11,12,13,17],"p",{},"Wapito is an unofficial WhatsApp API. It drives a real WhatsApp account through the same protocol\nthe phone and desktop apps use, not through Meta's Cloud API, and that is the whole reason it can\ncreate groups, post to Channels and message anyone without a template. It also means WhatsApp\ncan ban the linked number, and ",[14,15,16],"strong",{},"no provider — Wapito included — can promise otherwise."," This\npage is the honest version of what that risk is, what Wapito does about it automatically, what\nonly you can do about it, and what happens on the day it goes wrong anyway.",[19,20,22],"h2",{"id":21},"what-actually-gets-numbers-banned","What actually gets numbers banned",[10,24,25],{},"Nobody outside Meta knows the exact rules, and the rules change. What follows is what every team\nthat has run linked numbers at volume has seen, in roughly the order of how much it matters.",[27,28,29,45,51,57,63,69,75],"ol",{},[30,31,32,35,36,40,41,44],"li",{},[14,33,34],{},"Being reported."," The strongest signal by far. When a recipient taps ",[37,38,39],"em",{},"Report"," or ",[37,42,43],{},"Block and\nreport",", WhatsApp receives your recent messages to them. A handful of reports on a young number\nis enough. Everything else on this list matters mostly because it leads here.",[30,46,47,50],{},[14,48,49],{},"Messaging strangers."," People who do not have your number saved and did not write to you\nfirst are the ones who report. A conversation the other side started almost never gets a number\nbanned, whatever the volume.",[30,52,53,56],{},[14,54,55],{},"Volume from a new number."," A number that was linked on Monday and sends five hundred\nmessages on Tuesday does not look like a person. WhatsApp expects volume to grow over weeks.",[30,58,59,62],{},[14,60,61],{},"Identical content."," The same text, the same link, to many recipients in a short time — the\nshape of a broadcast. Links in a first message are worse still.",[30,64,65,68],{},[14,66,67],{},"Adding strangers to groups."," Putting people into a group they did not ask to join is the\nsingle most reported action there is, and WhatsApp has been tightening the rules around it\nfor years.",[30,70,71,74],{},[14,72,73],{},"Machine-like timing."," Messages every 200 ms, at all hours, with no \"typing…\" and no reads\non the inbound side.",[30,76,77,80],{},[14,78,79],{},"A hollow account."," No profile name, no photo, no contacts, no history, freshly bought\nvirtual number, linked from a datacenter IP. Each of these is a small weight on the wrong side\nof the scale.",[10,82,83,84,87],{},"Notice what is ",[37,85,86],{},"not"," on the list: the API itself. Numbers are not banned for being driven by\nsoftware; they are banned for behaving like spam. A linked number that answers customers who wrote\nto it can run for years.",[19,89,91],{"id":90},"what-wapito-does-automatically","What Wapito does automatically",[10,93,94,95,100],{},"These controls are on for every channel and cannot be switched off — not on Premium, not on\nrequest — because they are what keeps the number alive. Their exact numbers are in\n",[96,97,99],"a",{"href":98},"\u002Fdocs\u002Frate-limits\u002F","rate limits","; this is what each one is for.",[102,103,104,115,129,135,141,155,161,167,185],"ul",{},[30,105,106,109,110,114],{},[14,107,108],{},"Send pacing."," One queue per channel; each message leaves about 1.5 seconds after the last,\nplus up to 1.5 seconds of random jitter. A burst of API calls becomes a stream of sends with\nhuman rhythm. A producer that outruns the queue gets ",[111,112,113],"code",{},"429 send_rate_limited"," rather than a\nfaster number.",[30,116,117,120,121,124,125,128],{},[14,118,119],{},"Typing simulation."," With ",[111,122,123],{},"typing_simulation: \"auto\""," (or ",[111,126,127],{},"typing_time"," on a send) the\nrecipient sees \"typing…\" for a duration proportional to the message, and a reply marks the\ninbound message as read first — the sequence a person produces.",[30,130,131,134],{},[14,132,133],{},"The warm-up ladder."," A newly linked number may send 50 messages on its first day, 100 on\nthe second, then 200, 350, 500, 750 and 1,000, and only after a week is it bound by the plan\nalone. The ladder follows the phone number, not the channel, and survives reconnects.",[30,136,137,140],{},[14,138,139],{},"The cold-send guard."," Only so many first messages to strangers per hour — ten in the first\ntwo days, twenty for the rest of the first week, then sixty on Premium and twenty on Sandbox.\nReplies to people who wrote to you are never limited by it. This is the control that turns\n\"reply-first\" from advice into a property of the platform.",[30,142,143,146,147,150,151,154],{},[14,144,145],{},"Timelock detection."," When WhatsApp pauses new reach-outs from a number, Wapito notices,\nreports it in ",[111,148,149],{},"GET \u002Fchannel\u002Flimits",", answers cold sends with ",[111,152,153],{},"423 reachout_timelocked"," and lets\nreplies through. You find out from the API, not from a customer.",[30,156,157,160],{},[14,158,159],{},"One steady connection."," A channel holds one session per number and does not reconnect in\nloops; bulk number checks run at low concurrency; nothing is fetched from WhatsApp that the\nendpoint you called did not need.",[30,162,163,166],{},[14,164,165],{},"A proxy per channel"," on Premium, so a number can keep a consistent, residential-looking\nexit address instead of sharing a datacenter one.",[30,168,169,172,173,176,177,180,181,184],{},[14,170,171],{},"The ban detector."," The engine's disconnect reasons are watched, and a ban is turned within\na minute into a ",[111,174,175],{},"channel"," webhook event with ",[111,178,179],{},"reason: \"banned\"",", a ",[111,182,183],{},"banned"," status in the\ndashboard and an e-mail to the account owner. The session is stopped so nothing keeps knocking.",[30,186,187,190],{},[14,188,189],{},"Offline nudges."," A linked device whose phone stays offline too long is eventually unlinked\nby WhatsApp. Wapito tracks when the phone was last seen and e-mails you before that happens.",[192,193,196],"callout",{"ban-risk":194,"type":195},"high","warn",[10,197,198],{},"Every control above lowers the odds. None of them changes what the number is doing, and what the\nnumber is doing is what WhatsApp judges. A well-paced, warmed-up, proxied number sending unwanted\nmessages is a well-paced, warmed-up, proxied number that will be reported.",[19,200,202],{"id":201},"what-only-you-can-do","What only you can do",[10,204,205,208,209,212],{},[14,206,207],{},"Reply first."," Design the integration so the customer's message is the trigger: a keyword, a\nform on your site that ends with \"message us on WhatsApp\", a ",[111,210,211],{},"wa.me"," link, a QR code on the\nreceipt. Once they have written to you, you may answer for as long as the conversation lasts,\nand the cold-send guard never touches you.",[10,214,215,218,219,223],{},[14,216,217],{},"Get consent, and keep it."," Message people who asked to hear from you, tell them how to stop,\nand stop when they say so. A \"STOP\" that is honoured is a report that never happens. This is also\nwhat the ",[96,220,222],{"href":221},"\u002Flegal\u002Facceptable-use\u002F","acceptable use policy"," you agreed to requires.",[10,225,226,229,230,234],{},[14,227,228],{},"Do not run cold outreach."," Bulk messages to lists of numbers that have never heard of you are\nthe thing that gets numbers banned, and the thing the platform is built to refuse. If your\nbusiness depends on unsolicited outreach, the Cloud API with approved templates is the honest\ntool; see ",[96,231,233],{"href":232},"\u002Fvs-cloud-api\u002F","how the two compare",".",[10,236,237,240,241,244,245,247,248,251,252,255],{},[14,238,239],{},"Respect the pacing."," Do not fire a thousand calls and retry every ",[111,242,243],{},"429"," in a tight loop. Feed\nthe queue at the rate the number can send, read ",[111,246,149],{}," before a batch, and treat\n",[111,249,250],{},"cold_send_limit"," and ",[111,253,254],{},"reachout_timelocked"," as instructions, not obstacles.",[10,257,258,261],{},[14,259,260],{},"Warm up before you need to."," Link the number a week before the first campaign. Use it from\nthe phone as well: save contacts, join a group, reply to a few people, set a profile name and\nphoto. Wapito's ladder paces the API side; the human side is yours.",[10,263,264,267],{},[14,265,266],{},"Write like a person."," Vary the wording, use the customer's name, skip the link in the first\nmessage, do not send at 3 a.m. in the recipient's time zone. If a message would look like spam\narriving on your own phone, it looks like spam on theirs.",[10,269,270,273],{},[14,271,272],{},"Keep the phone alive."," The number is still a phone. Keep it charged, online and occasionally\nin a human hand; a phone that is off for two weeks is unlinked by WhatsApp whatever Wapito does.",[10,275,276,279],{},[14,277,278],{},"One number, one system."," Do not run the same number through Wapito and another tool, or link\nit to several providers in turn. Repeated re-linking from different places is exactly the pattern\nan account-takeover check is looking for.",[10,281,282,285],{},[14,283,284],{},"Use a number you can afford to lose."," A real SIM with some history is safer than a freshly\nbought virtual number, and a number that is not your main business line is safer still.",[10,287,288,291,292,295,296,299],{},[14,289,290],{},"Watch the receipts."," A rising share of ",[111,293,294],{},"messages.status"," events with ",[111,297,298],{},"status: \"failed\"",", or\ninbound messages that suddenly stop, is the number telling you something before WhatsApp does.",[19,301,303],{"id":302},"when-the-ban-comes","When the ban comes",[10,305,306],{},"Sometimes it comes anyway. Here is what happens and what to do.",[27,308,309,325,332,339,342],{},[30,310,311,312,314,315,251,318,321,322,324],{},"The ",[111,313,175],{}," event fires with ",[111,316,317],{},"status: \"banned\"",[111,319,320],{},"previous_status: \"connected\"",", the\ndashboard shows the channel as banned, and the account owner gets an e-mail. Subscribe to the\n",[111,323,175],{}," event from day one so this reaches your on-call, not your inbox.",[30,326,327,328,331],{},"Wapito stops the session. Sends answer ",[111,329,330],{},"409 channel_not_connected"," from then on; nothing is\nqueued, nothing keeps retrying against a dead account.",[30,333,334,335,338],{},"On the phone, WhatsApp shows either a countdown — a temporary ban, usually hours to a few\ndays — or a permanent one with a ",[37,336,337],{},"Request a review"," button. The review is between you and\nWhatsApp. Wapito has no channel to Meta, no appeal process to run on your behalf, and no way\nto reverse a decision. Anyone who tells you otherwise is guessing.",[30,340,341],{},"After a temporary ban ends, the number can be linked again from the Connect tab. Start slower\nthan before: the ladder restarts only if the phone number changes, so it is on you to send at\na fraction of the previous volume for a while.",[30,343,344],{},"After a permanent ban, the number is gone. Move the channel to a new number, which resets the\nwarm-up ladder, and change whatever behaviour led here before you do.",[10,346,347],{},"If a customer's number was banned while running through Wapito, delete the channel or link a new\nnumber to it; the token, webhooks and settings all survive the switch.",[19,349,351],{"id":350},"what-we-will-never-tell-you","What we will never tell you",[10,353,354,355,357],{},"You will find providers that advertise \"ban-proof\" numbers, \"anti-ban algorithms\" or \"official\ngrade\" reliability on an unofficial API. There is no such thing. The protocol is the same for\neveryone, the judgement is WhatsApp's alone, and the only variables are how the number behaves and\nhow quickly you learn when it is in trouble. Wapito's promise is narrower and true: honest\ndefaults you cannot switch off, honest limits that say no before WhatsApp does, and honest\nsignals — the timelock, the receipts, the ",[111,356,175],{}," event — the moment something changes.",[10,359,311,360,364,365,367],{},[96,361,363],{"href":362},"\u002Fblog\u002Fhow-to-avoid-whatsapp-bans\u002F","long-form guide to avoiding bans"," goes deeper into the\nnumbers and the reasoning; the ",[96,366,222],{"href":221}," is the contractual\nversion of the same rules.",{"title":369,"searchDepth":370,"depth":370,"links":371},"",2,[372,373,374,375,376],{"id":21,"depth":370,"text":22},{"id":90,"depth":370,"text":91},{"id":201,"depth":370,"text":202},{"id":302,"depth":370,"text":303},{"id":350,"depth":370,"text":351},"2026-09-15","What actually gets a linked WhatsApp number banned, how to warm a new number up, pacing and jitter defaults, and how to react to a ban webhook.","md",{},true,"\u002Fdocs\u002Fanti-ban-guide",{"title":5,"description":378},"docs\u002Fanti-ban-guide",[386,387,388],"anti-ban","operations","honesty",null,"ScwP44vMgGsmw_LbYtT4Pak3NW7g86mGm1-qITvKhW8",1790464894220]