> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.chrisp.chat/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # How to troubleshoot WhatsApp integration issues __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**](https://app.crisp.chat) 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 | For the full setup flow, see [Connect WhatsApp Business Platform with Crisp](/en/article/connect-whatsapp-business-platform-with-crisp-11rcwkw/). --- # 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**](https://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. || When migrating from another provider, the number must usually be migrated through the provider migration flow, not verified as a brand-new number. --- # 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.