Connect your WhatsApp number through Meta Embedded Signup

Open Workspace settings and the "Channels" tab. Only an owner or admin can connect a number; other roles are sent back to the dashboard.

In the "WhatsApp Connection" card choose "WhatsApp Cloud API", then press "Connect with WhatsApp". A Meta window opens and the button reads "Waiting for Meta…" until it closes.

What Meta asks for

1. Log in with Meta, using the Facebook account that manages the business.
2. Choose your business: pick a Meta business portfolio, or create one with a name and category.
3. Pick your number: the number already in the WhatsApp Business app, or register a new one.
4. Verify it. For an existing number, scan the QR code with the WhatsApp Business app. For a new number, enter the code Meta sends by SMS or call.
5. Finish. Close the Meta window; the card now reads "Connected number". If you kept the existing number, the phone app keeps working and the card shows "Phone app active".

After the connection

• The card shows the number, the "Phone Number ID" and the "WABA ID", each with a copy button, plus a status pill and the account health line.
• "Switch number" runs the Meta flow again for a different number. A workspace has one WhatsApp number at a time.
• "Disconnect" asks you to confirm; the workspace then stops sending and receiving WhatsApp messages until a number is connected again.
• Add a payment method in Meta’s Billing Hub. Without one, Meta stops delivering your replies after the first 1,000 of the month.

If something goes wrong

• "Facebook could not be reached. Disable your ad-blocker or try another browser, then retry." The Meta script was blocked. Turn the ad-blocker off for this site or use another browser.
• "Meta onboarding was cancelled or closed." The Meta window was closed before the last step. Press "Connect with WhatsApp" again.
• "No verified phone numbers found on this WhatsApp Business Account." Finish the phone number registration inside Meta, then connect again.
• "This WhatsApp Phone Number is already connected to another workspace." A number can live in one workspace only. Disconnect it there first.