Home/HighLevel/Features/Reselling Products/HighLevel guide to troubleshooting undelivered WhatsApp messages

Payments and Sales

HighLevel guide to troubleshooting undelivered WhatsApp messages

In short

A WhatsApp message can appear as sent yet never reach the recipient. The platform may store the message for up to 30 days, block it due to user settings, regional limits, or token issues, and enforce quality limits. Understanding each cause lets you act quickly to restore delivery.

AreaReselling Products · WhatsApp
Used forDigital marketing agency, Ecommerce store, Customer service department
Setup steps7 steps in 2 tasks
Last updatedNovember 16, 2026

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

  1. Open the Access Token Debugger tool in HighLevel.
  2. Paste the current access token into the debugger.
  3. Check that the token lists both whatsapp_business_management and whatsapp_business_messaging scopes.
  4. If any scope is missing, regenerate a new token that includes the required permissions.

Handle Meta API downtime (Error Code 2)

  1. When the API returns error code 2, recognize that Meta may be temporarily updating its service.
  2. Wait five minutes before retrying the API call.
  3. 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

Michael's take

Michael Reimer
Michael ReimerFounder of CRM Pros, HighLevel Commander and Certified Admin

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.

Get More InformationOpens on HighLevelPublished November 2, 2026 · Updated November 16, 2026

Common questions

Common questions about WhatsApp messages.

Why does a WhatsApp message stay at sent but not delivered?

The recipient may be offline for more than 30 days, has blocked your number, is using an outdated app, has not accepted the latest Terms, is in a restricted region, or your token lacks required permissions.

How can I tell if a user blocked my number?

WhatsApp does not send a direct block notification. If other messages still deliver or the user does not respond for a long time, they may have blocked you.

What is the 24 hour customer service window?

After a user initiates a chat, you have 24 hours to reply with free form messages. Outside that period, only pre approved templates can be sent.

What happens if a user receives too many marketing messages?

WhatsApp may temporarily stop delivering additional marketing messages to that user. Utility templates are not affected, and you can wait before retrying.

Which countries cannot receive WhatsApp Business messages?

Messages cannot be delivered to users in Cuba, Iran, North Korea, Syria, or the Crimea, Donetsk, and Luhansk regions of Ukraine.

How do I fix authentication errors when sending messages?

Use the Meta Access Token Debugger to confirm your token includes whatsapp_business_management and whatsapp_business_messaging scopes, then regenerate the token if those scopes are missing.

Next step

Pick the features that matter. Then get the plan that unlocks them.

Explore the features you want, start with the five at the top, and upgrade through my link when you are ready. The bonuses and the team come with it.

The features directory explains every HighLevel feature in plain English. Browse it to see what the platform can do.

Back to the FeaturesSee the full details
⌃

Site preview

Explore the next page

This destination is reserved in the page inventory and is not built yet.