Connect your WhatsApp number

Nybero connects to WhatsApp through Meta’s official Embedded Signup: you press one button, a secure Meta popup opens, you pick (or add) your business number, and Nybero handles the technical setup. No tokens to copy, no code, no third-party phone. The whole flow takes a few minutes — if your number meets the prerequisites below, so read those first.

What you need before you start

1. A Facebook account with access to your business. In the popup you log in to Facebook and choose (or create) your business’s Meta Business account (also called a business portfolio). If your business doesn’t have one yet, the popup lets you create it on the spot — you’ll need your business name and website/email.
2. A phone number for WhatsApp. This becomes your sending number. It must be able to receive an SMS or a voice call for verification, and — this is the big one — it must not be actively registered in the WhatsApp consumer or WhatsApp Business app on a phone.
3. A display name. The name customers see in the chat, set during the popup. It should match your business or brand name — Meta reviews it against their naming rules.

The number rule, in plain words

A phone number can only be on one WhatsApp at a time. If the number you want to use currently runs the normal WhatsApp (or WhatsApp Business) app on someone’s phone, you have two options:

• Use a different number — a fresh SIM, a second business line, or a landline (landlines work: choose voice-call verification).
• Migrate the number — first deregister it from the phone app: in WhatsApp go to Settings → Account → Delete account. This deletes that app account (chat history included — back it up first if you care), after which the number is free to be connected to the WhatsApp Business Platform. The number keeps working normally as a phone/SMS line.

What you can’t have is both: once a number is connected to Nybero, it no longer works in the phone app. All conversations happen in Nybero’s Inbox instead.

Note

One workspace = one WhatsApp number. Everything in your workspace (contacts, inbox, automations) belongs to that number. Need a second number for another brand? On Settings → WhatsApp use + Add channel — it creates a separate workspace for the new number (your plan determines how many channels you can add).

Connecting, step by step

You can connect from the guided onboarding right after signup, or anytime under Settings → WhatsApp. Both use the same flow.

Step 1 — Launch the Meta popup

1. Press Connect WhatsApp. A secure popup window from Meta opens (if nothing appears, check your browser’s popup blocker).
2. Log in to Facebook with the account that manages your business.
3. Choose or create your business portfolio (Meta Business account) and confirm your business details.
4. Choose or create a WhatsApp Business account and add your phone number. Verify ownership with the code Meta sends by SMS or voice call to that number.
5. Set the display name customers will see, review the permissions, and approve access.

The popup closes and Nybero finishes the connection automatically in the background. Your number now appears as a channel card on Settings → WhatsApp.

Step 2 — Activate & name your number

A freshly connected number still needs to be registered for sending (in the onboarding this is step 2 · Activate & name your number):

1. On Settings → WhatsApp, your channel card shows a Pending notice: “This number isn’t registered on the WhatsApp Cloud API yet.”
2. Press Register number. Nybero registers the number and sets a 6-digit two-step verification PIN for it.
3. The card confirms: “Registered. Your 6-digit PIN: ······” — save this PIN somewhere safe. It’s WhatsApp’s two-step verification for your number, and you’ll need it if the number is ever registered again (e.g. after a disconnect or when moving providers).

If registration asks you for a PIN or a verification code instead of completing, your number has some history with WhatsApp — jump to Common pitfalls below; the app walks you through every case.

Step 3 — Check the status

Your channel card shows a status badge:

• Connected — you’re live. Done.
• Pending — registration or display-name review is still in progress; the card tells you what to do next.
• Action needed — something failed; the card shows the error detail.

What happens after connecting

The moment your channel is Connected:

• Incoming messages arrive in Nybero. Meta forwards every message and delivery status to Nybero automatically — your Inbox is live, replies to campaigns show up there, and automations can react to inbound messages. Nothing to configure.
• Your templates sync with Meta. If your WhatsApp Business account already had approved templates, they appear under Marketing → Templates. New templates you create in Nybero are submitted to Meta and their approval status syncs back automatically. See Templates.
• You can edit your WhatsApp profile — profile photo, description, address, website — right on the Settings → WhatsApp page, so your business looks complete when customers open the chat.
• Quality rating and messaging limits apply. Meta rates every number based on how recipients react (blocks and spam reports hurt). New numbers start with a limit of about 1,000 business-initiated conversations per 24 hours; that limit raises automatically (10,000 → 100,000 → unlimited) as you send consistently to people who want your messages. Your current quality rating is shown on the channel card. Clean opt-in practice is what keeps this healthy.

Display name vs. verified business

Your display name being approved is not the same as your business being verified. Until you complete Meta’s Business Verification (a document review in the Meta Business Manager, outside of Nybero), many recipients will see your phone number instead of your name in the chat list. The channel card points this out when it applies. Business verification is also what unlocks the higher messaging limits — worth doing early if you plan to send at volume.

Worked example: a restaurant migrates its number

Trattoria Lucia has used the WhatsApp Business app on the owner’s phone for years — customers know the number, so they want to keep it:

1. The owner backs up the chat history on the phone, then deregisters: WhatsApp Business app → Settings → Account → Delete account.
2. In Nybero, she presses Connect WhatsApp, logs into the restaurant’s Facebook account, creates a WhatsApp Business account in the popup, and adds the restaurant’s number. Verification code arrives by SMS to the restaurant phone — the number still receives SMS normally.
3. Display name: “Trattoria Lucia”. Popup done.
4. On Settings → WhatsApp she presses Register number — but the app answers that the number already has a two-step PIN (set years ago in the app). She remembers it, enters the 6 digits, presses Register, and the channel flips to Connected.
5. From now on, customer messages land in the Nybero Inbox where the whole team can answer — and Thursday’s specials go out as a campaign.

Common pitfalls and how to fix them

The popup doesn’t open or closes immediately

Your browser is probably blocking popups for app.nybero.com. Allow popups and press Connect WhatsApp again. Also make sure you’re not in a private/incognito window where you can’t log in to Facebook.

”Signup was cancelled” / connection fails after the popup

You closed the popup before the final approval step, or didn’t finish choosing a number. Just press Connect WhatsApp and run through the popup again — nothing is half-saved; each attempt starts clean.

The number is still registered in the WhatsApp app

Meta won’t verify a number that’s actively used in the consumer or Business app. Deregister it first (Settings → Account → Delete account in the app — back up chats before), wait a few minutes, then retry. See the number rule above.

Registration says the number already has a two-step PIN

The number was registered on WhatsApp before, and two-step verification is still set from back then — deregistering from the app does not clear it. The channel card asks you to enter this number’s existing 6-digit two-step PIN:

1. If you know the PIN — type it and press Register. Done.
2. If you’ve forgotten it — press Forgot it? Reset via SMS. Enter the verification code that arrives on the number and press Verify & register (or use Send by voice call instead — the right choice for landlines).
3. If no code can be sent — this happens when the number counts as already verified with Meta. In that case, open the Meta WhatsApp Manager, turn off two-step verification for this number there, then come back and press Register number again.

Customers see the phone number instead of the business name

Expected until your business passes Meta’s Business Verification (document review in the Meta Business Manager). The display name itself may already be approved — the channel card shows both states. See What happens after connecting.

Display name rejected

Meta requires the display name to match your actual business/brand and follow their naming rules (no ALL CAPS, no emoji-stuffing, no generic terms like “Offers”). Adjust the name and resubmit via the profile section on Settings → WhatsApp.

You want to disconnect or change the number

On Settings → WhatsApp, press Disconnect on the channel card. Contacts and conversation history in the workspace are kept; you can connect a different number afterwards. Keep the 6-digit PIN from registration — re-registering the same number later will ask for it.

Tip

Stuck on something not listed here? Check Troubleshooting or write to support@nybero.com — connection issues are almost always one of the cases above.

Next steps

Your number is connected — now make it do something:

1. Add or import contacts and share your opt-in link.
2. Create your first template and submit it for approval.
3. Send your first campaign — or follow the whole path in the Quickstart.