Connect your WhatsApp number
Link a WhatsApp number to CRMWA via Meta Embedded Signup, keep the mobile Business app with coexistence, or connect manually with API credentials.
7 min read Owners & admins
Choose a connection method#
| Method | Best for | Button |
|---|---|---|
| Embedded Signup | Most businesses. A guided Meta popup creates or selects your business portfolio, WhatsApp account and number. | Connect WhatsApp No. |
| Coexistence (same popup) | You already use the WhatsApp Business app on this number and want to keep using it on your phone. | Connect WhatsApp No., then choose the existing app number |
| Manual Entry | You already have a WhatsApp Cloud API setup in Meta and an access token. | Manual Entry |
Connect with Embedded Signup (recommended)#
- Step 1: Open Settings → Phone Numbers (open it).
- Step 2: Click Connect WhatsApp No. A Facebook window opens. Allow popups in your browser if nothing appears.
- Step 3: Log in with the Facebook account that manages your business.
- Step 4: Select an existing Business Portfolio or create a new one. Fill in the business name, website and country exactly as on your business documents.
- Step 5: Select or create a WhatsApp Business Account.
- Step 6: Enter the phone number and the display name customers will see. Choose SMS or voice call to receive the verification code, then enter the code.
- Step 7: Review the permissions and click Finish. The window closes and CRMWA saves the token and registers the number for you.
- Step 8: The page reloads and the number appears under connected numbers with a Connected badge.
Keep using the WhatsApp Business app (coexistence)#
Coexistence lets one number work in both the WhatsApp Business app on your phone and CRMWA. Messages appear in both places.
- Step 1: Update the WhatsApp Business app on your phone to the latest version.
- Step 2: In CRMWA, click Connect WhatsApp No. and continue in the Facebook window.
- Step 3: When asked, choose to connect your existing WhatsApp Business app number.
- Step 4: Open the WhatsApp Business app on your phone and scan the QR code / approve the request shown in the popup.
- Step 5: Choose whether to share chat history. When finished, the number shows the Coexisting label in CRMWA.
Connect manually with API credentials#
Use this only if you created your own app in Meta for Developers.
- Step 1: In Meta for Developers, open your app → WhatsApp → API Setup. Copy the Phone number ID and WhatsApp Business Account ID.
- Step 2: Create a permanent access token from a System User in Meta Business Settings, with
whatsapp_business_messagingandwhatsapp_business_managementpermissions. (Temporary tokens expire in 24 hours.) - Step 3: In CRMWA, click Manual Entry and fill in Access Token, Phone Number ID, WABA Account ID, Phone Number (with country code) and Verified Name.
- Step 4: Click Save & Activate.
After connecting#
- Each connected number shows its quality rating (Green, Yellow, Red) and platform (Cloud API or Coexisting).
- If a number shows a red Action Required warning, Meta has flagged it. Use Retry for registration errors, or reconnect if the token expired.
- Use the edit icon to update credentials and the delete icon to disconnect a number.
- Next: set your profile picture and description in Settings → Business Manager, then create a template.
Common problems#
| Problem | Fix |
|---|---|
| Facebook window does not open | Allow popups for this site, disable ad blockers for a moment, and try again. |
| Number already registered | The number is in use on another WhatsApp API account. Remove it there first, or use coexistence if it is on the Business app. |
| Did not receive the code | Switch to voice call, check that the number can receive international SMS, and wait a few minutes before retrying. |
| Connected but no messages arrive | Click retry registration on the number. For manual setups, check the webhook configuration. |
| Number limit reached | Upgrade your plan or add number slots from Billing. |
Related guides
- Quick start: set up CRMWA in 15 minutesThe shortest path from a new account to your first WhatsApp conversation and first campaign. Follow these steps in order.
- Settings overviewWhat every Settings tab does: numbers, business profile, plan, products, website bot, payments, lead routing, sessions and password.
- Troubleshooting and FAQFixes for the most common problems: messages not delivered, templates rejected, broadcasts failing, flows not triggering and more.
- Message templates: create and get approvedTemplates are pre-approved messages to start chats and run broadcasts. Learn categories, variables, buttons, and how to avoid Meta rejection.
Still stuck? Raise a support ticket from your dashboard or contact our team.