Troubleshoot common blockers when connecting or using WhatsApp Business Platform with Crisp.

Most WhatsApp issues are linked to the Meta connection flow, phone number eligibility, message templates, number migration, or phone number formatting. Use the sections below before contacting support.

Connection redirects to an error page

In some cases, the Meta connection popup lets you create or select a business, verify the phone number, and then redirects back to an error page in Crisp. This can also happen when reconnecting an existing WhatsApp Business account.

Try the alternate connection flow:

1. Go to Crisp
2. Open Plugins → WhatsApp
3. Hold Shift + Cmd on macOS or Shift + Ctrl on Windows
4. While holding those keys, click Connect to WhatsApp
5. In the popup, select the WhatsApp business you created or want to reconnect
6. Continue until the popup closes and Crisp resumes the connection flow

If the redirect still fails, contact Crisp support with the Meta business name and the step where the error appears.

WhatsApp Business App number is not visible

A phone number used in the WhatsApp Business mobile app may not appear in the standard WhatsApp Business Platform connection flow. Depending on your goal, you can either use Coexistence mode or move the number fully to the WhatsApp Business Platform.

Choose the right path:

• Keep using the WhatsApp Business mobile app → use Coexistence mode from the Crisp WhatsApp plugin when available for your setup
• Move the number fully to the WhatsApp Business Platform → delete the existing WhatsApp Business mobile app account for that number, then connect or migrate the number through Crisp
• Migrate from another provider → use the migration flow instead of verifying the number as a new account

Before trying again, check that:

• Country code → the number includes the correct international country code
• Formatting → the number is entered without spaces or dashes
• SMS or voice calls → the phone can receive the Meta verification code
• Meta status → the number is not stuck in a pending validation state in WhatsApp Manager

Outbound WhatsApp message is not delivered

To initiate a WhatsApp conversation, you must send an approved message template created in your WhatsApp Business Manager. Free-form messages can only be sent after the customer replies and opens the regular messaging window.

What to verify:

• Template status → the template is approved by Meta
• Template category and variables → required variables are filled correctly in Crisp
• Policy compliance → the message follows WhatsApp Business messaging policies

If no approved template exists yet, create one in WhatsApp Business Manager, wait for Meta approval, then retry from Crisp.

Meta popup says the page is blocked

This can happen when Facebook opens the connection popup while you are logged in as a Page instead of your personal admin profile.

To fix the blocked popup:

1. Close the popup
2. Open a new browser tab
3. Go to facebook.com
4. Click the profile picture in the top-right corner
5. Click See all profiles
6. Switch to the admin account that manages the Meta Business
7. Return to Crisp and start the connection again

Migration shows an existing WhatsApp account error

If you are migrating a number from another provider and the Meta popup says This number is registered to an existing WhatsApp account, check whether you went too far in the Meta flow.

If you reached Step 3 of 3: Verify your WhatsApp Business number, close the popup. Crisp should redirect you to the migration page, where you can continue the migration flow instead of registering the number as a new account.

Customer replies land in a new conversation

When initiating a WhatsApp conversation from Crisp, the recipient phone number must be in international format. If you use a local number format, the customer reply can return from an international-format number and create a separate conversation.

To confirm the mismatch:

1. Open the conversation you initiated
2. Open the new conversation created by the customer reply
3. Compare the phone numbers in Main Information
4. Update the contact number to international format
5. Start future template messages using the international-format number

If you are still blocked

If you still cannot connect WhatsApp after these checks, contact Crisp support with the Meta Business ID, WhatsApp Business Account name, phone number, and screenshots of the exact step where the error appears.

Updated on: 03/05/2026