01Who this is for
- Customer support teams, they need to know why a reply never arrives and how to reopen the 24 hour window.
- Marketing agencies, they must avoid marketing message limits that can halt campaign delivery.
- Resellers managing multiple business numbers, they must detect blocked numbers and invalid tokens across accounts.
02WhatsApp messages, explained
The feature reports a message status of “sent” while the delivery flag stays false. It reflects that the platform accepted the API request but could not hand the message to the recipient’s device. The status appears in the messaging dashboard and API response logs.
Delivery may fail for offline users, blocked numbers, unsupported regions, outdated app versions, exceeded marketing limits, invalid phone numbers, API errors, or authentication/permission problems when the access token lacks required scopes. All of these conditions are evaluated by the WhatsApp Business API before confirming delivery.
03How businesses use WhatsApp messages
- Digital marketing agency. The agency checks the status of bulk campaign messages. If a message stays at sent, they verify the access token scopes, confirm the recipient isn’t in a restricted country, and ask the client to update their WhatsApp app.
- Ecommerce store. The store monitors order confirmation texts. When a confirmation stays undelivered, they ensure the customer’s phone number is registered on WhatsApp and that the store’s token includes the whatsapp_business_messaging scope.
- Customer service department. Agents notice a support reply flagged as sent only. They request the user to send a message first, reopening the 24 hour window, and verify the user has not blocked the business number.
04The numbers and rules that matter
- WhatsApp stores messages for offline users for up to 30 days.
- Türkiye is supported for Cloud API messaging as of May 15, 2024.
- Outdated app versions: Android 2.21.15.15+, iOS 2.21.170.4+, Web 2.2132.6+.
- Marketing messages limit: Typically 5 to 6 per day per user.
- Meta API downtime may last up to 5 minutes (Error Code 2).
05Before you start
- A valid access token must exist for the WhatsApp Business API.
- The token must include the whatsapp_business_management and whatsapp_business_messaging scopes.
06How to set up and use WhatsApp messages in HighLevel
Resolve authentication and authorization errors
- Open the Access Token Debugger tool in HighLevel.
- Paste the current access token into the debugger.
- Check that the token lists both whatsapp_business_management and whatsapp_business_messaging scopes.
- If any scope is missing, regenerate a new token that includes the required permissions.
Handle Meta API downtime (Error Code 2)
- When the API returns error code 2, recognize that Meta may be temporarily updating its service.
- Wait five minutes before retrying the API call.
- If the issue persists, verify token validity and retry after another short interval.
07Settings that matter
- Access token scopes. Controls which WhatsApp API actions are allowed; the token must contain whatsapp_business_management and whatsapp_business_messaging to send messages.
08Things to know before you rely on it
- WhatsApp stores messages for offline users only up to 30 days; after that they are dropped.
- A user may receive roughly 5 to 6 marketing messages per day before further marketing messages are temporarily blocked.
- The Business Platform does not operate in Cuba, Iran, North Korea, Syria, or the Crimea, Donetsk, and Luhansk regions of Ukraine.
09If something goes wrong
- Authentication or permission error when sending a message. Validate the token with the Access Token Debugger and ensure it includes the required scopes; regenerate the token if needed.
- Meta API downtime (Error Code 2). Wait five minutes and then retry the API call.
10How it connects to the rest of HighLevel
- Set up WhatsApp automation workflows in HighLevel WhatsApp workflow integration
- Create and manage WhatsApp templates for messages WhatsApp templates
- Review HighLevel pricing and plans for WhatsApp access Pricing
Michael's take

WhatsApp delivery issues are often avoidable but can still bite you.
Skip this deep dive if you rarely use the WhatsApp Business API or only send occasional messages.