1. All Collections >
  2. Channels >
  3. WhatsApp >
  4. Offboard your WhatsApp number from respond.io

Offboard your WhatsApp number from respond.io

Avatar
Joshua Lim
5 min read

You own your WhatsApp Business phone number. You can switch it to another WhatsApp Solution Partner at any time. A WhatsApp Solution Partner is also called a Business Solution Provider (BSP). You can also move it to the WhatsApp Business App or another respond.io Organization. The steps depend on your WhatsApp account type and where the number is going.

Important: Deleting your respond.io Organization or WhatsApp Channel doesn't release your number, switch its partner, or move it. The number stays in your business portfolio until you complete the steps below. Respond.io can't do these steps for you.

Bringing a WhatsApp number to respond.io? Connect a new number with WhatsApp Business Platform (API) or connect your WhatsApp Business App number with Coexistence. If the number is with another partner, see how to connect your WhatsApp number to respond.io.

Before you begin

  • Admin access: You need admin access to the business portfolio that owns the number.

  • WhatsApp balance: Your balance doesn't carry over. To request a refund, contact respond.io support before you delete the Channel.

  • Account type: Check your WhatsApp account type first. The steps differ for each type.

How to check your WhatsApp account type

  1. Navigate to Workspace Settings > Channels in respond.io.

    WhatsApp Channel types on the Workspace Settings> Channels page
  2. Check the WhatsApp Channel type against the table below.

  3. If you also use the WhatsApp Business App, navigate to Account Settings > Business Platform in the app. If respond.io is listed, your number is on WhatsApp Coexistence.

Account type

How to recognize it

WhatsApp Business Platform (API)

WhatsApp Business Platform (API) Channel.

WhatsApp Cloud API

WhatsApp Cloud API Channel, connected through your own Facebook app.

WhatsApp Coexistence

You use the number in the WhatsApp Business App and respond.io at the same time.

Is your number only on the WhatsApp Business App or WhatsApp Personal App? See how to move your number from the WhatsApp app to the WhatsApp API. If you're not sure which type you have, contact respond.io support.

How to find the steps for your WhatsApp account type

Find your account type, then the place you want to move the number to.

Your account type

Another partner

WhatsApp Coexistence with another partner

WhatsApp Business App

Another respond.io Organization

API

Switch to a partner

Switch to Coexistence

Move to the app

Move to an Organization

Cloud API

Switch to a partner

Switch to Coexistence

Move to the app

Contact support

Coexistence

Switch to a partner

Switch to a partner

Keep on the app only

Contact support

Each partner gets its own Messaging account for your number. Switching to another partner creates a new Messaging account for that partner.

How to switch your WhatsApp number to another partner

The new partner controls its own sign-up and migration flow. Follow the new partner's instructions for those steps.

Switch a WhatsApp Business Platform (API) number to another partner

Your number stays in your WhatsApp account. You add the new partner, route conversations to it, then remove respond.io.

  1. Start the new partner's sign-up and share your existing number with them. Meta creates a new Messaging account for that partner.

  2. Set Conversation Routing in Meta Business Suite so the new partner is the primary responder. Follow Set respond.io as the primary responder in Conversation Routing and select the new partner in every dropdown.

  3. Recreate your message templates with the new partner and submit them for review. Templates don't carry over.

  4. Request a refund of your WhatsApp balance from respond.io support.

  5. Navigate to Workspace Settings > Channels in respond.io > select the WhatsApp Business Platform (API) Channel > delete it.

  6. Navigate to Meta Business Suite > Settings > Messaging accounts > remove respond.io's Messaging account.

Set Conversation Routing before you remove respond.io's Messaging account. Removing it doesn't update Conversation Routing, and Meta doesn't pick a new primary responder for you.

Switch a WhatsApp Cloud API number to another partner

  1. Follow the new partner's sign-up or migration steps for an existing number.

  2. Navigate to Workspace Settings > Channels in respond.io > select the WhatsApp Cloud API Channel > delete the Channel.

Don't delete the number from WhatsApp Manager when switching to another partner. Delete it only to use the number on the WhatsApp Business App.

Switch a WhatsApp Coexistence number to another partner

WhatsApp Coexistence connects to 1 partner at a time, so Conversation Routing isn't available. Remove respond.io before you connect the new partner.

Important: Don't delete your WhatsApp Business account during this process. You may lose data.

  1. Navigate to Account Settings > Business Platform in the WhatsApp Business App > remove respond.io as a partner.

  2. Navigate to Settings > Chats > Chat Backup in the WhatsApp Business App > tap Back Up Now. Wait for the backup to finish.

  3. Register the same phone number in the WhatsApp Personal App. Accept the prompt to switch the number to WhatsApp Personal.

  4. Register the same phone number again in the WhatsApp Business App.

  5. Select the backup when WhatsApp detects it, then restore your chat history.

  6. Start the new partner's WhatsApp Coexistence onboarding.

  7. Navigate to Workspace Settings > Channels in respond.io > delete the WhatsApp Coexistence Channel.

Companion devices are unlinked when you leave or join WhatsApp Coexistence. Wait up to 24 hours for WhatsApp to sync, then re-link them.

For more details, see Meta's documentation on switching partners.

How to switch your WhatsApp number to WhatsApp Coexistence with another partner

Switch a WhatsApp API number to WhatsApp Coexistence with another partner

This applies to WhatsApp Business Platform (API) and WhatsApp Cloud API numbers.

  1. Move the number to the WhatsApp Business App. Follow Move a WhatsApp Business Platform (API) or WhatsApp Cloud API number to the WhatsApp Business App.

  2. Start the new partner's WhatsApp Coexistence onboarding.

Meta decides WhatsApp Coexistence eligibility based on account age and messaging quality on the WhatsApp Business App. A number recently moved to the app may need more app activity before it qualifies.

For a WhatsApp Coexistence number, follow Switch a WhatsApp Coexistence number to another partner.

How to move your WhatsApp number to the WhatsApp Business App

Move a WhatsApp Business Platform (API) or WhatsApp Cloud API number to the WhatsApp Business App

Meta requires you to delete the number from the WhatsApp API before using it on the WhatsApp Business App.

Before you delete the number, check Meta's requirements:

  • Only business portfolio admins can delete a number.

  • You can't delete a number used to send paid messages in the last 30 days.

  1. Request a refund of your WhatsApp balance from respond.io support.

  2. Navigate to Workspace Settings > Channels in respond.io > select the WhatsApp Channel > delete the Channel.

  3. Navigate to WhatsApp Manager > Account tools > Phone numbers.

  4. Click the trash icon next to the number and complete the flow.

    Trash icon in the Delete column of the WhatsApp Manager Phone numbers list
  5. Register the number in the WhatsApp Business App.

Meta may need time to process the deletion. Learn more in Meta's guide to deleting business phone numbers.

Keep a WhatsApp Coexistence number on the WhatsApp Business App only

Your WhatsApp Coexistence number is already on the WhatsApp Business App. Remove respond.io as a partner to stop using respond.io.

  1. Navigate to Account Settings > Business Platform in the WhatsApp Business App.

  2. Remove respond.io as a partner.

Removing respond.io doesn't delete your WhatsApp Business account or phone number. Companion devices are unlinked, so re-link them after up to 24 hours.

How to move your WhatsApp number to another respond.io Organization

  1. Request a refund of your WhatsApp balance from respond.io support.

  2. Delete the WhatsApp Channel in the original Organization.

  3. Navigate to Meta Business Suite > Settings > Messaging accounts > remove respond.io's Messaging account.

  4. Connect the WhatsApp Channel again from the new Organization.

Skip steps 2 and 3 and the connection fails. The number is still linked to the original Organization.

How to connect your WhatsApp number to respond.io

Your number is now on

Follow

A new number, not on WhatsApp yet

Connect a new number with WhatsApp Business Platform (API)

Another partner

Add respond.io alongside your current partner

The WhatsApp Business App, and you want to keep using it

Connect your WhatsApp Business App number with Coexistence

WhatsApp Personal App or WhatsApp Business App only

Move your number from the WhatsApp app to the WhatsApp API

What carries over when you switch partners or move your WhatsApp number

Item

What happens

Phone number and WhatsApp Business account

Not deleted when you delete the Channel or remove respond.io as a partner.

Display name

Stays with your number. It belongs to your WhatsApp account.

Message templates

Don't carry over when you switch partners. Recreate them and submit them for review.

WhatsApp balance

Doesn't carry over. Request a refund from support before you delete the Channel.

Messaging through respond.io

Stops when you delete the Channel or remove respond.io as a partner. Webhooks to respond.io also stop.

Contacts and message history in respond.io

Stay in your Workspace when you delete the Channel, unless you delete them.

Companion devices (WhatsApp Coexistence)

Unlinked. Re-link them after up to 24 hours.

FAQ and troubleshooting

Does deleting my respond.io Organization release my WhatsApp number?

No. Deleting the Organization or the WhatsApp Channel doesn't release your number or switch its partner. Find the steps for your account type.

I already deleted my Organization or WhatsApp Channel. What happens to my number?

Your number is still in your business portfolio. Check your account type, then continue with the remaining steps.

What's next?

Share this article
Telegram
Facebook
Linkedin
Twitter

Can't find what you're looking for? 🔎