WhatsApp error 4: API Too Many Calls

Code 4 is the Graph API's application-level rate limit. It counts calls made by your app as a whole, across every WABA and phone number, and it is distinct from the WhatsApp-specific throughput limit (130429) and the WABA rate limit (80007). When you see code 4, the platform is saying your app identity has made too many requests in the current window, regardless of what those requests were for.

For the Cloud API the documented allowance is 200 requests per hour per app per WABA by default, rising to 5,000 per hour per app per active WABA once the WABA has at least one registered phone number. Sends to the /messages endpoint are governed mainly by throughput and messaging limits, so code 4 most commonly appears on management and read traffic: polling phone numbers, listing templates, fetching media repeatedly, or tight loops that re-query state.

Your messages are not being judged for quality here. This is purely call volume.

Budget API calls per feature and log call counts per endpoint so you can see which consumer is burning the allowance. Use webhooks as the source of truth for state changes and reserve REST calls for actions. A client-side token bucket sized comfortably below the documented limit keeps bursts from reaching Meta at all. Message sending has its own ceilings - 130429 for speed and the daily messaging tiers for reach; every documented allowance is tabulated in the WhatsApp limits reference.