Change, reconnect or disconnect your number

Switch to a different number or Meta app, refresh an expired token, or reset the connection — and what happens to your data.

Updated 25 Oct 2026

Who can do this: Owner or Admin (needs the WhatsApp connection permission)Plan: All plans

A Vatli workspace holds one WhatsApp number at a time. Your contacts, chats, deals and settings stay in the workspace when you change the number.

Refresh an expired or revoked token (manual connections)

If messages fail with error 190 or the card says your credentials are invalid:

  1. Create a new permanent system-user token in Meta Business Settings.
  2. In Settings → WhatsApp, click Edit credentials under Manage connection, and paste it into Permanent Access Token.
  3. Click Save Configuration, then Test API Connection.

Switch to a different Meta app

  1. In Settings → WhatsApp, click Edit credentials under Manage connection.
  2. Enter the new Meta App ID, and paste the new app’s App Secret and Permanent Access Token. Vatli clears the old secret and token as soon as the App ID changes, so it never mixes credentials from two apps.
  3. Click Save Configuration, then copy the new Callback URL and Verify Token into the new app’s webhook settings.

Connect a different number

  1. In Settings → WhatsApp, click Connect a different number under Manage connection.
  2. Click Connect WhatsApp and pick the new number in Meta’s pop-up, as in Connect with Facebook. It replaces the old number when it finishes — no reset needed.

With manual setup, click Edit credentials instead and enter the new number’s Phone Number ID (and the new token, if it belongs to a different app).

Reset Configuration removes the stored credentials (nothing else is deleted). You only need it to disconnect the number completely.

Templates belong to a WhatsApp Business Account. If the new number is in a different WhatsApp Business Account, your old templates won’t work — create and approve them again, then use Sync from Meta in Settings → Templates.

What changing the number does to your data

  • Kept: contacts, tags, custom fields, conversation history, deals, automations, flows, broadcasts history, team and billing.
  • Customers see a new number: their next message to the new number opens a fresh 24-hour window. Messages they send to the old number no longer reach Vatli.