WhatsApp account restrictions and appeals
The same sending symptom can come from a volume ceiling, a quality or policy restriction, or a ban, and each path has a different owner.
Check the state in Bird
Open WhatsApp > Numbers in Bird and select the number. Read these fields together:
- WhatsApp status: includes states such as connected, flagged, rate_limited, restricted and banned.
- Quality rating: the quality value Meta last reported.
- Messaging limit: the volume Meta permits for the owning portfolio.
- Send rate: the throughput Meta permits for the number.
For a failed message, open the message details and keep the event, normalized error, meta_error_code and description. A rate_limited error means the send was throttled. The failed-versus-rejected explanation explains why the event type matters.
For a connected Business Account, read its ban field through the WhatsApp Business Account operation. Bird can include an appeal_url to Meta Business Support when the account's owning portfolio is known.
Check the state in Meta
Open WhatsApp Manager and open Phone numbers. The number's row shows its status, quality rating and messaging limit. A quality warning belongs to the number. An account or policy issue belongs in Meta's support tools.
Open Business Support Home, select the business portfolio that owns the WhatsApp Business Account, and open the WhatsApp account or issue shown there. Meta's available controls determine whether the issue can be reviewed.
Request a review
When Meta provides Request review, open the issue details, choose the available appeal reason, add accurate context, and submit it. Keep the policy or commerce requirement that Meta names in the issue in view while you prepare the request.
Meta's WhatsApp Business help article says a banned WhatsApp Business app account can show Request review and that most app reviews finish within 24 hours. That article does not promise the same timeline for a WhatsApp Business Platform account. For the Platform, follow the review status in Business Support Home and do not invent a completion date.
If Meta does not show a review option, the decision may not be appealable through that account. Contacting WhatsApp outside the review flow or through another account does not change the decision. A provider cannot remove a Meta ban.
What Bird support can do
Bird support can help you identify the Bird message, number or Business Account, explain the state Bird last received from Meta, and confirm whether the failure was failed or rejected. Include the message identifier, number identifier, event, error and meta_error_code when you open a case.
Bird support cannot change Meta's quality rating, messaging limit, restriction, policy decision or ban. Bird also cannot approve a Meta appeal or promise when Meta will finish it. Use Meta's review control for the decision, then read the number or account again in Bird after Meta responds.
Prevent a repeat issue
- Collect and honor WhatsApp opt-in.
- Send content that follows Meta's WhatsApp Business Policy and Commerce Policy.
- Watch the number quality and messaging limit before a quality problem becomes a sending restriction.
- Treat a failed or rejected send as evidence to investigate, not as proof that the number is banned.
Related pages:
Related resources
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 channelExplore the capabilityConnect WhatsAppFollow the learning pathBuild your first integration
Try the practice and get an implementation brief