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#

MethodBest forButton
Embedded SignupMost 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 EntryYou already have a WhatsApp Cloud API setup in Meta and an access token.Manual Entry

Connect with Embedded Signup (recommended)#

  1. Step 1: Open Settings → Phone Numbers (open it).
  2. Step 2: Click Connect WhatsApp No. A Facebook window opens. Allow popups in your browser if nothing appears.
  3. Step 3: Log in with the Facebook account that manages your business.
  4. 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.
  5. Step 5: Select or create a WhatsApp Business Account.
  6. 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.
  7. Step 7: Review the permissions and click Finish. The window closes and CRMWA saves the token and registers the number for you.
  8. 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.

  1. Step 1: Update the WhatsApp Business app on your phone to the latest version.
  2. Step 2: In CRMWA, click Connect WhatsApp No. and continue in the Facebook window.
  3. Step 3: When asked, choose to connect your existing WhatsApp Business app number.
  4. Step 4: Open the WhatsApp Business app on your phone and scan the QR code / approve the request shown in the popup.
  5. 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.

  1. Step 1: In Meta for Developers, open your app → WhatsApp → API Setup. Copy the Phone number ID and WhatsApp Business Account ID.
  2. Step 2: Create a permanent access token from a System User in Meta Business Settings, with whatsapp_business_messaging and whatsapp_business_management permissions. (Temporary tokens expire in 24 hours.)
  3. 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.
  4. 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#

ProblemFix
Facebook window does not openAllow popups for this site, disable ad blockers for a moment, and try again.
Number already registeredThe 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 codeSwitch to voice call, check that the number can receive international SMS, and wait a few minutes before retrying.
Connected but no messages arriveClick retry registration on the number. For manual setups, check the webhook configuration.
Number limit reachedUpgrade your plan or add number slots from Billing.

Still stuck? Raise a support ticket from your dashboard or contact our team.

Browse all guides