Before you start
- The number is active in the WhatsApp Business app.
- A Meta login that can manage your business.
- A role with edit access to Integrations.
What changes in the WhatsApp Business app
Popcorn’s setup lists these before you connect (See what keeping the app changes in Quickstart). Your number and chats stay, and a few things work differently:
Before you connect, update WhatsApp Business: Facebook’s window asks you to confirm in the app on your phone and to choose whether to share your chats. Turn off greeting and away messages under Business tools so customers get one answer, and add anything they mention that your agent should know, such as your working hours, to your agent first. Connect the number customers already message. Your chats stay on your phone; new chats show in Popcorn, and so do the last 6 months if you share them.
Set up coexistence
1
Start the WhatsApp connection
Go to Integrations → WhatsApp and click Connect WhatsApp (or Connect another number on the Account tab). See Connect a WhatsApp number for the full flow.
2
Choose your WhatsApp Business app number in Meta's window
Meta’s sign-up offers to connect a number that is already on the WhatsApp Business app. Pick that option and follow Meta’s steps for the app. Popcorn also asks Meta directly whether the number is on the app, so a number that is on the app is connected through coexistence even if you took the standard option in Meta’s window.
3
Check the number in Popcorn
After WhatsApp is connected, the number appears under Connected numbers with a Uses WhatsApp Business app badge next to Live. If you chose the app option but Meta doesn’t show the number on the app, the connection stops with This number isn’t on the WhatsApp Business app. Click Connect again and choose to connect it as a new number, or set the number up in the app first.
4
Connect the number to an agent
A number that is attached to no agent is answered by your default agent. To bind it to a specific agent, open the agent, go to its Channels tab, switch the number on and publish. See Connect knowledge, tools and channels.
Choose what happens when you reply from the app
Every message your team sends from the WhatsApp Business app also appears in the Popcorn conversation, as an outgoing message labelled via WhatsApp app. If the conversation was closed, it reopens. What your agent does next is a workspace setting. On the Account tab, the WhatsApp Business app panel appears when at least one of your numbers is shared with the app:
Switch it, then click Save changes in the bar that appears; you see Settings saved. The change applies to messages sent from the app after you save; it does not change conversations already handed over. To give a conversation back to the agent, use Hand back to agent in the Inbox. See Work a conversation.
How a coexistence number behaves differently
Messages from the app that Popcorn shows in the Inbox are copies of what your team already sent; Popcorn does not send them again.
If you later move the number off the WhatsApp Business app onto the Cloud API and connect it again, Popcorn treats it as a standard number from then on: the Uses WhatsApp Business app badge disappears, Delete replaces How to disconnect, and campaigns send at the standard speed.
Disconnect the number
Meta does not allow Popcorn to disconnect a coexistence number, so you do it from the app. On the Account tab, the row menu shows How to disconnect instead of Delete, with these instructions:1
Open the WhatsApp Business app
Go to Settings > Account > Business Platform and choose Disconnect Account.
2
Let Popcorn catch up
Meta notifies Popcorn, which removes the number from Connected numbers. Your conversation history in Popcorn is kept. If the number was your default, the most recently updated remaining number becomes the default.
If you move the app to a new phone
Moving the WhatsApp Business app to another phone can make Meta briefly take the connection down. Popcorn shows the number as Reconnecting (“Meta is checking this connection. Messages may pause for a few minutes.”) and keeps it. Meta normally restores it by itself. If access is still gone after about 45 minutes, Popcorn takes the number off Connected numbers; if Meta restores it within 7 days, Popcorn brings it back.A number can be connected to only one Popcorn workspace. If the connection stops with This number is in another workspace, contact support to move it, or disconnect it there first.
Related
Connect a WhatsApp number
The standard connection, connected numbers and message limits.
Inbox overview
Where handed-over conversations go and how to give them back to the AI.
Delivery and reachability
Message statuses, limits and retries for campaigns.
Channel troubleshooting
Number not connecting and messages not delivering.