Login with Facebook does nothing
- The first click sometimes only prepares Meta’s sign-in and shows Facebook is ready. Click Connect again to continue. Click the button again.
- Meta’s window has to open from your click. If nothing opens, allow pop-ups for the Popcorn app in your browser and try again.
- If Meta reports a problem you see Error; if you closed the window you see Cancelled. Start again with Login with Facebook, or with Connect another number on the Account tab.
The number does not connect
Popcorn shows the reason under Error:A number is missing from Connected Numbers
Popcorn checks each WhatsApp Business account with Meta when it lists your numbers. If Meta permanently refuses Popcorn’s access to one account, the numbers of that account are hidden from Connected Numbers; numbers on your other WhatsApp Business accounts stay listed. If every number belongs to that one account, the page shows Connect your WhatsApp Business Account as if nothing were connected. Connect the number again with Login with Facebook, which stores a fresh authorization for that account; nothing is deleted in the meantime. A temporary problem at Meta does not hide anything.Connected, but no messages arrive yet
After a successful connection Popcorn shows Your WhatsApp Business Account has been set up successfully. It may take up to 15 minutes to start receiving messages. Wait 15 minutes, then send a test message to the number. If the number also runs in the WhatsApp Business app, messages sent from the app follow the WhatsApp app message behavior setting (see Coexistence).Message Limit shows “Syncing with Meta…” or “Limit unavailable”
The Message Limit column on the Account tab is read from Meta and refreshed every 24 hours. Until Meta has confirmed a limit, campaign messages from that number are held and retried every minute; if the limit is still unknown after about an hour, they are marked as failed.- Syncing with Meta…: Popcorn has not received the limit yet, or Meta no longer accepts Popcorn’s access to the number. If it does not change within a day, connect the number again with Login with Facebook.
- Limit unavailable: the last check hit a temporary error. Popcorn retries by itself, starting 15 minutes later.
Display name pending or rejected
On the Profile tab, WhatsApp display name shows the review state:
Display names can only be changed in Meta. More in WhatsApp profile.
Messages are not delivered
Open the message in the Inbox: failed messages carry Meta’s reason. The most common ones:
For campaigns, open the campaign and read Why some messages didn’t deliver; Marketing Message Limits and Rate Limits are explained there. A campaign larger than the number’s daily limit is spread over several days, which Popcorn announces before you send. See Campaign troubleshooting and Inbox troubleshooting.
The widget does not show on my site
Check in this order:- Is the code installed? The snippet must be on the page, ideally before
</body>. Copy it again from Get Embed Code (WhatsApp button) or Embed Code (Website Chat). - Is the channel on and saved? The WhatsApp button needs Enable Widget on under Channels → WhatsApp → Widget; Website Chat on a store needs Show on my store on under Channels → Website Chat. Both need Save changes. With both off, the storefront script shows nothing.
- Is a number selected? The WhatsApp button needs a WhatsApp Business Number. If that number was deleted, the button has no destination and is not drawn.
- Is another widget already on the page? Only one Popcorn widget loads per page, and the chat bubble never loads inside an embedded frame. Remove duplicate snippets.
- Is the domain shared? If your store’s domain is connected to more than one Popcorn workspace (an old trial, for example), Popcorn refuses to guess and shows nothing. Disconnect the store from the workspace you no longer use.
- Older Zid installation? Zid stores installed earlier without workspace details are matched by domain. Save the Widget tab once with Enable Widget on so Popcorn has an explicit setting for the store.
Product cards or the catalog are not working
If the health card shows all products live but cards still do not appear, click Connected on the Products in WhatsApp card for the steps to link the catalog manually in Meta’s WhatsApp Manager. Full details in Products in WhatsApp and Integrations troubleshooting.