Overview
Coexistence lets you connect a phone number that’s already active in the WhatsApp Business app to your AI agent, without deleting the account or changing numbers. After you connect:- Your AI agent answers customers on that number.
- You can still read and reply to chats from the WhatsApp Business app on your phone.
- Your recent chat history and contacts are copied into Chatbase.
- When you reply from the app, Chatbase sees the reply and stops the AI for that conversation, so you and the AI don’t talk over each other.
If you’re connecting a new number, or a number you don’t use in the WhatsApp Business app, follow the regular WhatsApp setup instead.
Before you start
Make sure you have:- The WhatsApp Business app, version 2.24.17 or later, on the phone that uses the number. Update the app first if needed.
- The phone with you during setup. You confirm the connection from the app.
- A Facebook account that can manage your business on Meta.
- A few minutes. Connecting and importing your history can take several minutes.
Connect your WhatsApp Business app number
1
Open the WhatsApp channel
Go to the AI agent you’d like to connect. Click Channels in the sidebar, then click Setup on the WhatsApp card. If you already have a WhatsApp number connected, open Channels → WhatsApp, go to the Connection tab, and click Connect a new number.
2
Log in with Facebook
A Meta window opens. Log in with the Facebook account that manages your business, then click Continue.

3
Enter your WhatsApp Business app number
Choose your WhatsApp Business app profile, enter the phone number you use in the app, and click Next.

4
Verify your account details
Meta shows the business profile from your WhatsApp Business app. Check that it’s the right one and click Next. If it isn’t, click Back and change the number.

5
Choose your business portfolio
Select the business portfolio to share with Chatbase and click Next.

6
Connect from the WhatsApp Business app
Meta shows a QR code. Keep this window open and pick up your phone.
In the WhatsApp Business app, open the Business Platform screen:
Tap Connect to the Business Platform.

- If you see a message from the official Facebook Business account in your chats, tap Connect.
- If there’s no message, go to Settings → Account → Business Platform.


7
Choose whether to share your chat history
The app asks whether to share your chat history. Choose Share all chats to bring up to 6 months of one-to-one chats into Chatbase, so your AI agent and your team see what was said before. Group chats can’t be shared. Tap Confirm.

8
Scan the QR code
The app opens the camera. Scan the QR code in the Meta window on your computer.
9
Confirm your WhatsApp Business account
Back on your computer, Meta shows your WhatsApp Business account. Check the time zone and click Next.

10
Review the access and confirm
Meta lists what Chatbase can access and do. Click Confirm.

11
Finish
Meta shows Connecting your account for a few moments, then Your account is connected to Chatbase. Click Finish.
You can also click Add payment method here to set up Meta billing for the messages your AI agent sends, or add it later in Meta.

Importing your chat history and contacts
Right after you connect, Chatbase starts importing from the WhatsApp Business app:- Chat history: your recent conversations are added to Chat logs, so your AI agent and your team can see what was said before.
- Contacts: your WhatsApp Business app contacts are added to Contacts, and stay in sync when you add or remove them in the app.
When the import finishes, the status line disappears from the card and your AI agent starts replying.

Your AI agent doesn’t reply to customers while history is importing, so it doesn’t answer before it has the conversation’s past. Messages that arrive during the import still show up in the WhatsApp Business app and in Chat logs. The on/off toggle for the number is grayed out and can’t be changed until the import finishes.
Replying from the WhatsApp Business app
You can keep replying to customers from the WhatsApp Business app. Chatbase sees each reply and treats it as you stepping into the conversation:- If you use the Help desk: Chatbase takes over the conversation and opens a ticket with your reply in it. The AI stays off for that customer until the ticket is closed. The customer’s next messages go to the same ticket.
- If you don’t use the Help desk: Chatbase pauses the AI for that conversation. To hand it back to the AI, open the conversation in Chat logs, open its menu, and click Resume conversation.


Disconnecting
There are two separate ways to disconnect, and they do different things. Remove the number from Chatbase. Open Channels → WhatsApp, go to the Connection tab, click the ⋯ menu on the number, choose Delete Number, then click Delete to confirm. This removes the number from Chatbase and stops your AI agent on it, but the number stays connected to the WhatsApp Business Platform.

Import history again
Meta allows history to be imported once, within 24 hours of connecting. To import it again, disconnect in the WhatsApp Business app (Settings → Account → Business Platform), then go through Connect your WhatsApp Business app number again and share history when asked.Limitations
In Chatbase- Group chats aren’t supported. Your AI agent only works in one-to-one chats, and group chats aren’t imported.
- History is imported once. You can import up to about 6 months of one-to-one chats, once, right after connecting. To import it again, you need to disconnect and connect again.
- Older media isn’t imported. Photos, videos, and files older than 14 days show up as placeholders in Chat logs.
- Replying from the app pauses the AI for that conversation. See Replying from the WhatsApp Business app.
- Disappearing messages are turned off for one-to-one chats.
- View-once messages and live location can’t be sent.
- Broadcast lists are turned off. You can’t create new ones, and existing ones become read-only.
- Linked devices are logged out during setup. You can link up to 4 again afterwards. WhatsApp for Windows and WhatsApp for Wear OS aren’t supported as linked devices.
- Open the WhatsApp Business app at least once every 14 days. If you don’t, Meta disconnects the number from the platform and your AI agent stops replying.
- Changing the number, deleting the account, or moving the number to regular WhatsApp also disconnects it.
- If you reinstall the app or move to a new phone, keep the option to reconnect your connected platforms checked when you register again, and the connection comes back on its own.
Next steps
Takeover
Learn how taken-over conversations and tickets work.
WhatsApp Templates
Reach customers after the 24-hour window closes.