Skip to main content
Who can use this?
  • Gallabox users moving a WhatsApp Business App number to the WhatsApp Cloud API.
  • Roles: Owners and Admins — WhatsApp connection is configured in the Channels section.
Migrating from the WhatsApp Business App to Gallabox moves your number fully onto the WhatsApp Cloud API. You keep the same phone number, and your team manages every conversation from Gallabox. The WhatsApp Business App stops working for that number.
If you want to keep using the WhatsApp Business App on your phone and Gallabox on the same number, don’t migrate. Use WhatsApp Coexistence instead. Not sure which to choose? See Coexistence or Cloud API?

​
What changes when you migrate

​
Plan Availability

Connecting or migrating WhatsApp is available on all Gallabox plans. See Billing and Subscriptions for user and team limits, and Chat AI Agent for AI Agent availability.

​
Steps

1

Step 1: Back up your WhatsApp chat history

Gallabox doesn’t import chat history when you migrate, and deleting your WhatsApp account in the next step removes your chats from the app. Export any chats you want to keep first:
  1. Open the WhatsApp Business App on your phone.
  2. Go to Settings → Chats → Chat History.
  3. Tap Export Chat for any chats you want to save.
  4. Choose a destination, such as email or cloud storage.
2

Step 2: Delete your WhatsApp account from the app

Meta doesn’t let a number that’s in use on WhatsApp be connected to the Cloud API. Delete the account from the app first:
  1. In the WhatsApp Business App, go to Settings → Account.
  2. Tap Delete my account, and follow the steps to confirm.
  3. Wait a few minutes before connecting. It can take up to 3 minutes for the number to become available.
Meta queues messages customers send to your number in the meantime.
Deleting your account can’t be undone. Once it’s deleted, the number can’t be used with Coexistence, which needs the number to be active on the WhatsApp Business App. Decide between Coexistence and migrating before you do this.
3

Step 3: Connect the number to Gallabox

Connect the number with the standard Cloud API setup. Follow Connect Your WhatsApp from How to Connect. You’ll verify the number with a one-time code sent by SMS or voice call, so keep the SIM active and to hand.
4

Step 4: Set up your team

Once the number is connected:
  1. Go to Settings → Team Members in Gallabox.
  2. Invite your team by email.
  3. Assign roles (Admin, Agent) based on responsibilities.
  4. Set up assignment rules so conversations route to the right people automatically.
  5. Configure your Chat AI Agent or bot flows if you have automation set up.

​
FAQs

Gallabox doesn’t import chat history when you migrate. New conversations after you connect appear in Gallabox. Export any chats you want to keep before you delete your account from the app. See Step 1.If you want your recent chats brought into Gallabox, use Coexistence, which can import up to 180 days of 1:1 chats.
Yes. Your phone number stays the same. Only where you manage it changes, from the WhatsApp Business App to Gallabox.
No. After migrating, the number works only through Gallabox. To use the app and Gallabox on the same number, use Coexistence instead.
Yes. The number first needs to be removed from the WhatsApp Cloud API:
  1. Contact Gallabox support and ask them to deregister your number.
  2. Once support confirms it’s done, sign up again in the WhatsApp Business App with the same number.
Conversations from Gallabox aren’t moved into the app.
Common reasons:
  • The number is still active on WhatsApp. Delete the account from the app first. See Step 2.
  • The number is connected to another WhatsApp Business API provider. Disconnect it from that provider first.
See Connect Your WhatsApp for more troubleshooting, or contact Gallabox support.