Conversations · 4 min read
Troubleshoot WhatsApp Coexistence Signup
Coexistence connects the number you use in the WhatsApp Business app to FunnelStreams, while you keep using the app on your phone. Meta decides which numbers are eligible.
Before you start
- Update the WhatsApp Business app to the latest version.
- Make sure the number is actively used in the app.
- Have admin access to the right Meta business portfolio.
- Use a stable internet connection, and keep the phone with you.
- Make sure the number isn't still connected to another WhatsApp API provider.
Number isn't eligible
Meta looks at a number's activity before allowing coexistence. New, inactive, or recently migrated numbers may not qualify yet.
- Keep using the number for real conversations in the app.
- Give it at least 7 days of activity. Some numbers need 30 to 60 days.
- Don't keep deleting and re-registering the app account.
- Try again later. You'll also need an approved display name.
Number is registered with another WhatsApp API provider
- Find out which provider it was connected to, and whether it still is.
- Disconnect it properly from that provider. This can affect messaging you run there.
- Use the number in the WhatsApp Business app for 1 to 2 months before trying coexistence again.
If you want to move to FunnelStreams without keeping the app, use the move-from-another-provider option instead. See WhatsApp Onboarding Options.
QR code missing or won't scan
- Update the WhatsApp Business app to version 2.24.17 or later.
- Restart coexistence setup from FunnelStreams.
- Scan using the WhatsApp Business app.
- Check your connection, clean the camera lens, and use good lighting.
- Wait a little and try again. Meta sometimes has short outages.
- As a last resort, reinstall the app and try again.
Chat sync is stuck
- Keep the WhatsApp Business app open.
- Stay on a stable connection.
- Allow time. Large histories can take up to 6 hours.
- If it fails, scan the QR code again to restart.
Don't delete the app or clear its data unless your chats are backed up.
Can't link a Meta business portfolio
- Log in to Meta Business Suite.
- Check you're an admin of the right portfolio.
- Make sure the business name, address, and website are filled in.
- Pick the right business during signup and try again.
Can't disconnect coexistence
Disconnect from the app, not by uninstalling it:
- In the WhatsApp Business app, go to Settings > Account > Business Platform.
- Select the connected platform and choose Disconnect.
Messages from some devices don't sync
Not every companion device syncs. Use WhatsApp Web or WhatsApp for Mac. Messages from some Windows or wearable apps may not show in Conversations.
Can't change the business name
Meta may lock the display name once coexistence is on. Make sure the name matches in the WhatsApp Business app and Meta Business Manager before you start. Name changes need Meta's approval.
Meta error codes
| Code | What it means | What to do | | --- | --- | --- | | 2655049, 2494028 | Account is shared with another partner. | Unshare it from the other partner in Meta Business Suite. | | 2494119 | Account already has this kind of provider. | Remove the existing provider first. | | 2655093 | Switching partners isn't supported. | Disconnect the existing partner in the WhatsApp Business app, then retry. | | 2494091 | Business verification needed. | Complete Meta business verification, then retry. | | 2593072 | Account ID doesn't exist or can't be accessed. | Check the account and your permissions. | | 2494029, 2494120 | Account can't be shared. | Contact support. | | 3441041 | Number isn't linked to the business you picked. | Pick the portfolio that owns the number. | | 2655095, 2655048 | Number isn't registered in WhatsApp Business. | Register it in the app, then retry. | | 3441042 | Coexistence isn't available in this region. | Wait for Meta to add your region, or use another setup option. | | 2655082 | Number is linked to another Facebook Page. | Pick the right Page, or unlink the wrong one in Meta Business Suite. | | 3441047 | Account uses MM Lite. | Choose an account without MM Lite, or use another setup option. |
Before you remove a partner's access, check it won't break messaging you rely on.
Still stuck?
Contact FunnelStreams support with your phone number (with country code), WhatsApp Business account ID, Meta business portfolio ID, the exact error and code, screenshots, and when it happened.