Most missing messages come from an unverified phone or email, a WhatsApp connection that needs reconnecting, a missing template or a payment setup at Meta. Here is how to find which.
An agent said it sent you a summary, or your app should have emailed a new lead, and nothing came. Find the message you see, then work through the checks for the channel that failed. How the channels are set up is in WhatsApp numbers and Agents on WhatsApp and email.
You see | What it means | What to do
"The agent WhatsApp connection needs attention" | The WhatsApp line of an agent stopped working. | Click it and reconnect. See Agent problems.
"WhatsApp disconnected - reconnect" | The number connected by QR was logged out on the phone. | Click it and scan the QR code again with the phone.
"Meta could not deliver; the exact cause was not disclosed" | Meta refused the message and did not say why. | Check that the number uses WhatsApp. It does not prove the person blocked you.
"Could not load WhatsApp templates. Refresh or check the connection." | The broadcast screen could not read your approved templates from Meta. | Refresh. If it repeats, reconnect WhatsApp on Connections.
"The workflow needs an approved WhatsApp template as the first touch." | A flow that writes first to a customer must open with a template Meta approved. | Pick an approved template for the first step. See Audience workflows.
"Media is unavailable. It may have expired on WhatsApp." | WhatsApp keeps photos and voice notes for a limited time. | Ask the customer to send it again.
"Failed to load WhatsApp triggers" | The triggers list of the app did not load. | Reload the tab. Your triggers are not deleted.
"Could not save trigger" | A trigger was not saved, usually a missing field or a dropped connection. | Check the fields and click save again. See WhatsApp triggers.
1. Is your phone verified?: Agents message only a verified owner phone. In the Studio open Settings, Notifications, and turn on the WhatsApp switch. If your number is not verified yet, Your WhatsApp number opens: send the code and verify.
2. Is a number connected to the agent?: If no pool number was free, the agent writes to you by email until one opens up. Check your inbox.
3. Did you message the right number?: A shared number routes your messages to your agent only when they come from your verified phone.
When Meta rejects a send from your WhatsApp Business number, the reason shows on the connection. The common ones:
Reason | What to do
The display name needs approval | Open WhatsApp Manager, choose the number and check the display-name approval. After approval, send again.
The connection authorization is no longer valid | Open Connections and reconnect WhatsApp with the account that owns the number.
Required permissions are missing | Reconnect WhatsApp and grant access to the right business account and number.
Payment setup (Meta billing issue) | Check the payment method and billing status in WhatsApp Manager.
Meta restricted the account | Open WhatsApp Manager and follow the account-review steps.
The number must be registered | Open Connections and complete the number connection again.
Meta limited marketing message delivery | Send less often; do not resend right away.
Templates need a payment method at Meta: Replying to a customer within 24 hours of their last message is free text. Outside that window only a Meta-approved template can be sent, and to send templates you add a payment method in WhatsApp Manager; Meta bills you directly. Answering incoming chats needs no payment method.
New WhatsApp Business accounts have a daily limit: A new account can start conversations with up to 250 different people per 24 hours, until Meta verifies the business or the number earns a higher tier.
You see | What it means | What to do
"Buttons JSON must be a valid array" | The buttons field of a template is not written in the right form. | The field starts as [ ], an empty list. Keep the square brackets around all the buttons and check every quote mark is closed. Not sure? Leave it as [ ] (no buttons) or ask your developer.
"Template parameters must be valid JSON" | The values for {{1}}, {{2}} in the template are not written in the right form. | Keep the form of the sample the field starts with: it fills {{1}} with the contact's first_name, and with "there" when the name is missing. Add one item for each variable, in order.
"Pending templates cannot be edited until Meta finishes review." | Meta is still checking this template. | Wait for Meta's answer. If you need a change now, duplicate the template and submit the copy.
"Rejection reason" on a template | Meta did not approve it and wrote why. | Fix what the reason says and click Resubmit.
"Approve the workflow before launching it." | A WhatsApp workflow must be approved before it runs. | Review the workflow and approve it, then launch.
"Fix validation errors before approval." | One of the steps has a problem, such as a missing template. | Open the steps marked with an error, fix them, then approve.
"Select a list" | The campaign has no audience list. | Choose the list to send to.
"Set spread hours" | You chose to spread the sending, without saying over how many hours. | Type the number of hours.
"Set start and end time" | You limited the sending to hours of the day, without the hours. | Fill in both the start and the end time.
When to open a ticket: Your phone is verified, the agent has a number, and a message the agent shows as sent still did not reach you after an hour. Open a ticket with the agent name and the time of the message.
Q: The agent says it sent, but nothing arrived.
A: A message recorded by the agent is not proof of delivery. Check the steps above for that channel.
Q: Why do I get emails instead of WhatsApp?
A: Your phone is verified, but no pool number was free for this agent. The agent switches to WhatsApp when one opens up.
Q: Notifications from my app go to someone else's phone.
A: WhatsApp notifications of an app go to the number of the app's owner.
Q: A customer wrote and the agent did not answer.
A: Check that the agent is on and not muted, and that the number is connected to it. See Agent problems.
Related: WhatsApp numbers: the Fine Structure number or your own, Talk to your agents on WhatsApp and email, Send a WhatsApp campaign, An agent is not answering or not working, Email campaigns do not go out