Skip to main content
Connect a WhatsApp Business phone number to Typewise so end customers can reach your support team directly through WhatsApp.
Already connected? Configure how the AI handles WhatsApp conversations in the WhatsApp Configuration page.

​
Prerequisites

Before you begin, make sure you have:
  • A Meta Business account (also known as a Facebook Business account)
  • A phone number that can receive SMS or voice calls for verification. This number will become your WhatsApp Business number.
You can use a phone number that is already registered with WhatsApp or WhatsApp Business. It will be migrated during the setup process. Before you start, delete the existing WhatsApp / WhatsApp Business account on the device that owns the number; otherwise the OTP verification step will fail. We recommend against using a personal WhatsApp number, as it is difficult to revert.
Virtual or VoIP numbers are not supported. WhatsApp requires a real mobile or landline number that can receive an OTP via SMS or voice call. Numbers from Twilio, Google Voice, or similar VoIP providers, and numbers behind an IVR or outbound-only systems, will fail OTP verification and cannot be registered.
For faster business verification, fewer initial messaging restrictions, and easier migration of an existing number, we recommend preparing the Meta side first. See Set up WhatsApp on Meta. Otherwise, Meta Embedded Signup (launched below) will create the Portfolio and WABA for you.

​
Connect your WhatsApp number

1

Enter your phone number

Go to the Installation page (Behavior → Channels → WhatsApp → Installation tab) and enter the phone number you want to use in international format (e.g., +15017122661).
2

Complete Meta Embedded Signup

Click Connect business number to launch the Meta Embedded Signup flow. A popup window will guide you through:
  • Logging in to your Meta Business account
  • Creating or selecting a WhatsApp Business Account (WABA)
  • Verifying your phone number via SMS or voice OTP
3

Wait for registration

After completing the signup, Typewise registers your phone number as a WhatsApp sender. Registration usually completes within a few minutes; the page refreshes automatically and shows the current status.If the status hasn’t moved to Online after about 30 minutes, the registration is considered stuck. See the Stuck state under Connection status for next steps.
4

Verify the connection

Once the status shows Online, your WhatsApp channel is fully connected and ready to receive messages.

​
Connection status

The Installation page shows the current state of your WhatsApp integration:
  • Not configured: No phone number has been connected yet. Follow the setup process above.
  • Connecting: Registration is in progress. The page refreshes automatically until it resolves to Online or one of the states below.
  • Online: Your WhatsApp channel is active and receiving messages. The connected phone number is displayed.
  • Online (updating): The channel stays online while the underlying sender configuration is being synced. No action required.
  • Offline: The sender is registered but currently unable to deliver messages. The page shows a reason code from the upstream provider; usually transient. Use Retry registration to refresh, or Disconnect to start over.
  • Action needed: Manual verification of the WhatsApp sender is required. Copy the displayed Sender ID and contact support. We will complete verification on your behalf.
  • Stuck: Registration didn’t complete within ~30 minutes. Use Retry to attempt again, or Disconnect to release the number and start a fresh setup.
  • Disconnected: The integration was previously active but is no longer connected. Re-run the setup process to reconnect.

​
Disconnect a WhatsApp number

Disconnecting a WhatsApp number removes its registration from Typewise and stops message delivery through this channel. Before you disconnect, you must disable two-step verification (2FA) for the number in Meta Business Suite. Otherwise the number stays locked to the WhatsApp Business Account and cannot be re-registered (with Typewise or any other provider).
⚠️ If you skip the 2FA step, re-registering the number will fail with Meta error 63110: “Already Registered”, and the number will be stuck in a stale state until 2FA is manually disabled.
1

Disable two-step verification in Meta Business Suite

Open WhatsApp Manager → Phone numbers, select the number you want to release, then go to Settings → Two-step verification and click Disable.
2

Confirm in the Release modal

On the Installation page, click the Disconnect (trash) icon next to the number. In the confirmation modal, tick “I have disabled two-step verification for this number”. The Release button stays disabled until this checkbox is checked.
3

Release the number

Click Release to remove the phone number registration from Typewise. The channel will move to the Disconnected state.
After disconnecting, you can reconnect at any time by going through the setup process again with the same or a different phone number.
Contact Typewise Support for help.