How to connect the WhatsApp Business app on your phone to XBASE
Step by step to connect the number you already use in the WhatsApp Business app on your phone to XBASE, without losing the app or your conversations.
Updated on
Connect to XBASE the same number you already use in the WhatsApp Business app on your phone. It keeps working in the app and also starts receiving conversations in XBASE, where your team and AI agents reply. It takes about 5 minutes.
What you need
- The WhatsApp Business app on your phone, version 2.24.17 or later, with the number you want to connect. Regular (personal) WhatsApp won't work: install WhatsApp Business on the same phone and, during the initial setup, agree to use the number and bring over your chats.
- A Facebook account with admin access to your company's business portfolio (Business Manager).
- A computer with XBASE open and your phone nearby: the connection ends with the app scanning a QR code on the screen.
- Permission to manage integrations in XBASE. If you don't have it, ask whoever manages the account.
- Knowing what changes in the app after you connect: broadcast lists, disappearing messages, view-once messages and live location stop working. The details are in WhatsApp coexistence: rules and limits.
Step by step
Open your WhatsApp numbers
In XBASE, open WhatsApp API → Numbers in the menu.
Start the connection
Click Add number and choose Connect with Meta. A Meta window opens.
Log in with Facebook
Log in with your Facebook account, if Meta asks, and click Continue on the welcome screen.
Type your WhatsApp Business number
On the "Add your WhatsApp phone number" screen, leave "Enter a new phone number" selected, choose your country code (for example, BR +55) and type the number exactly as it appears in WhatsApp Business (area code + number). Click Next. Even with the "new number" option, Meta recognizes on its own that the number is already in the app.
If Meta asks for a code by SMS or phone call, stop and close the window. It means Meta didn't recognize the number in WhatsApp Business, and finishing that way would remove the number from your phone.
Check the profile
Meta shows your WhatsApp Business profile (name, number and catalog). Check it and click Next.
Choose your company's portfolio
Choose your company's business portfolio (yours, not XBASE's) and click Next.
Scan the QR code with your phone
A QR code appears. On your phone, open the message from the official Facebook Business account in WhatsApp Business and tap Connect: the app asks to scan the QR code on the screen. If the message doesn't appear, go to Settings → Account → Business Platform in the app.
To bring over your old conversations, allow history sharing when the app asks.
Confirm the account
Check the account name and the time zone and click Next.
Finish in Meta
On the "Your account is connected" screen, click Finish. The Meta window closes.
Choose who will reply
XBASE asks which AI agent will serve the number. Choose now or close and set it up later.
What to expect
XBASE shows "WhatsApp connected! The number keeps working on your phone." and the number appears in Integrations. In WhatsApp API → Numbers, the number card shows the Sync with the phone block, with the Also on the phone badge and the progress of contacts and history.
A few minutes later, the text conversations from the last 6 months appear in the Chatcenter, with their original dates, and the contacts from the app come into XBASE. From then on, every new conversation shows up in both places.
Common problems
Next steps
WhatsApp coexistence: rules and limits
Blog: WhatsApp Business on your phone and the official API at the same time
Still have questions?
Talk to the XBASE team on WhatsApp. We help you set it up. Email: contato@xbase.app.
Meta billing
How Meta charges for WhatsApp on the official API: categories, 24-hour window, 1,000 free replies per number, who pays and where to see spend in XBASE.
Create a group
Step by step to create a WhatsApp group with the company's official number, invite customers with a link and chat with the group in the Chatcenter.