MB SuiteMB Suite

Connect or buy your WhatsApp line: the 5 ways, step by step

Updated 2026-10-07

There isn't one single button: how you connect depends on where your number lives today. There are 5 ways. First find your case in the list below, then jump to that section and follow its steps in order — each one tells you exactly what to click and what you'll see.

Which is your case?

  • My number already sends through the WhatsApp API, inside my Business Manager (it came from another provider, or you set it up yourself) → Way 1.
  • I use this number in the WhatsApp Business app on a phone and want to keep using it there too (coexistence) → Way 2.
  • It's a brand-new number that never had WhatsApp → Way 3.
  • I don't have a number: I'll buy one in MB Suite and use it on my phone too → Way 4.
  • I don't have a number: I'll buy one in MB Suite and use it only from the CRM → Way 5.
Ways 1, 2, and 3 start the same: in Settings > Integrations you connect WhatsApp Business once (this only opens the door), and then in Settings > Data Sources you use Add number. Ways 4 and 5 are different: they start from a number you buy, in CRM > Phones — you never touch Integrations or Data Sources.

Way 1 — My number is already in my Business Manager

For a number that already sends through the WhatsApp API inside one of your Business Manager's accounts.

WhatsApp Cloud API
  • Go to Settings > Integrations, find WhatsApp Business and click Connect. A Meta popup opens: sign in with your Facebook account and choose your Business Manager. This connects your Meta account to MB Suite.
  • Go to Settings > Data Sources, on the WhatsApp card use Add number, and pick the option "I want to use in MB Suite a number I already have in my Business Manager." Since you already authorized in step 1, it takes you straight to a list of all the numbers in your Business Manager. Tick the ones you want and save.
  • Go to CRM > Settings > Acquisition > Phones & WhatsApp and use Add WhatsApp. The number you ticked appears there — add it, and now it's activated as a WhatsApp Cloud API line, ready to send and receive. (Choosing in Data Sources and activating in Phones & WhatsApp are two separate steps for this way.)
Extra step, on purpose: in this way, choosing a number ≠ activating it. In Data Sources you build the list; in Lines you turn each one into a working line. It lets you pick which numbers to activate when your Business Manager has several.

Way 2 — My number is in the WhatsApp Business app on a phone (coexistence)

The most common case: you already handle this number in the app and want to keep using it on the phone AND in MB Suite at the same time.

WhatsApp Business+WhatsApp Cloud API
  • In Settings > Integrations, connect WhatsApp Business (this step is required to unlock Data Sources, even though you'll use another popup next).
  • Go to Settings > Data Sources, on the WhatsApp card use Add number, and pick the option "I use WhatsApp Business on a phone and want to use it in MB Suite too." A Meta popup opens (a different one).
  • In that popup, use the number you already have as WhatsApp Business and choose the Business Manager that holds it. Meta asks you to verify it by SMS or call and to enter a PIN — without disconnecting the app on your phone.
  • When the popup finishes, the line is created on its own: it shows up in CRM > Settings > Acquisition > Phones & WhatsApp as active, in Coexistence mode. You don't have to add anything. The number also appears in Data Sources with a coexistence badge.
Coexistence has Meta conditions: open the app at least every 14 days or the sync stops, group chats don't sync, and it needs a recent version of the WhatsApp Business app. To see exactly what the history sync brings and what stays on the phone, read WhatsApp coexistence: what the history sync brings (and what it doesn't).

Way 3 — A brand-new number that never had WhatsApp

For a clean number you want to register as WhatsApp for the first time. It ends up dedicated to the API, with no phone app.

WhatsApp Cloud API
  • In Settings > Integrations, connect WhatsApp Business (required to unlock Data Sources, same as Way 2).
  • Go to Settings > Data Sources, on the WhatsApp card use Add number, and pick "I want to register a new number as WhatsApp in my Business Manager." A Meta popup opens; choose "Create a WhatsApp Business account", enter your number and a display name, and verify it by SMS or call (for landlines, use the call option).
  • When the popup finishes, the number is in Data Sources. Go to CRM > Settings > Acquisition > Phones & WhatsApp, use Add WhatsApp, and add it — that's when the number gets registered (with a PIN) and the line is created. Ready to send and receive.
Like Way 1, this one has the extra step in Lines: choosing the number in Data Sources isn't the same as activating it. The activation (register + line) happens when you add it in Lines.
Ways 4 and 5 start by buying a number, and buying is restricted. Only the owner or an admin can do it — a member or a viewer sees the button dimmed. And in an Account whose subscription an agency pays, the line is bought from the agency's workspace, not from inside the account: if you try there, MB Suite tells you so instead of charging. The other three ways connect a number you already have and don't have this restriction. See Your agency's billing: plans and who pays for each account.

Way 4 — Buy a number in MB Suite and use it on your phone too (coexistence)

You don't have a number and want a new one, but you also want to answer it from a phone. This starts from CRM > Phones, not from Data Sources.

WhatsApp Business+WhatsApp Cloud API
  • In CRM > Phones, use Buy number: choose the country, activate it with prepaid balance. It becomes a voice + SMS line.
  • Make sure you're a receiver of that phone line: Meta's verification call only rings in the MB Suite dialer of the line's receivers who are on the CRM team. The guide that opens in the next step tells you whether it will ring for you and, if you're not a receiver, lets you add yourself in one click with Add me as a receiver — do it before you ask for the call.
  • On that line, open the menu and choose Convert to WhatsApp line (API). In the fork, pick "I want to create a WhatsApp Business account on my phone and also use it in MB Suite." A short coexistence guide opens.
  • Follow the guide: install WhatsApp Business on your phone, register the number there (when the app asks you to verify it, choose the call option — Meta calls the line, you answer in the MB Suite dialer and a voice reads you the code, which you type into the app; keep MB Suite open while you verify), and then press Connect with coexistence.
  • The Meta popup opens with an extra option, "Connect a WhatsApp Business app" — choose it and connect the number you just set up. When it finishes, the line is created on its own as active / Coexistence, and your voice keeps working (the number still receives calls and SMS through Phones).
This flow is validated for United States numbers: the verification call reaches the MB Suite dialer reliably. With numbers from other countries you can still try it — install the app, register the number and choose the call option — but we can't guarantee Meta's verification call arrives. Numbers bought in MB Suite, including United States ones, don't receive Meta's verification SMS, so always choose the call option, and make sure you're a receiver of the line (step 2) so the call reaches you.

Way 5 — Buy a number in MB Suite and use it only from the CRM (dedicated API)

Same start as Way 4 (a number you buy), but you want it dedicated to the CRM — no phone app. It's the default for a new WhatsApp operation line.

WhatsApp Cloud API
  • In CRM > Phones, use Buy number and activate it with prepaid balance (voice + SMS line).
  • Set yourself as a receiver of that phone line: in the line's menu choose Configure line, add yourself under Who answers and press Save. Meta's verification call only rings for the line's receivers, in the MB Suite dialer — keep MB Suite open while you verify.
  • On that line, open the menu and choose Convert to WhatsApp line (API). In the fork, pick "I want to use WhatsApp only in MB Suite" (marked Recommended).
  • The Meta popup opens with the number already filled in. Choose your Business Manager and then "Create a WhatsApp Business account". When Meta asks to verify, choose the call option — you answer in the MB Suite dialer and enter the code.
  • When it finishes, the line is created on its own in CRM > Settings > Acquisition > Phones & WhatsApp as WhatsApp, dedicated API, active. You don't have to add anything.
In dedicated-API mode, the number stops receiving calls and SMS through Phones — Meta takes it over for WhatsApp. That's the opposite of coexistence (Way 4), where voice keeps working. Choose this way only if you don't need to make/receive regular calls on that number.

How many numbers and Meta businesses fit in a workspace?

Every WhatsApp number belongs to a Meta business (the Business Manager that owns its WhatsApp account), and MB Suite keeps a separate connection for each business. That's why adding a number from another business doesn't disconnect the ones you already have. You see which business each number belongs to under the number in Settings > Data Sources (Meta business: …) and under the line's name in CRM > Settings > Acquisition > Phones & WhatsApp.

  • Up to 3 Meta businesses per workspace or Account. It's a fixed limit: once you reach it, you can keep adding numbers from those 3 businesses, but not from a fourth one.
  • Up to 20 WhatsApp numbers per workspace or Account, by default. It counts every number in the organization, whether it's only in Data Sources or already works as a line, in any module. If you need more, write to support: the MB Suite team can raise it.
  • The workspace and each Account count separately, and reconnecting a number that's already in the organization never counts against these limits.
You don't have to count by hand: the Add WhatsApp number dialog shows where you stand under its description —for example, 2 of 3 Meta businesses · 5 of 20 lines— and, if you hover over it, the names of the businesses. The list of numbers in Data Sources shows the same count, and when you already have 3 businesses, the numbers from any other business appear there without a box to tick.
A fourth business is a new client, and it goes in its own Account. If you try to connect a number from a fourth Meta business, MB Suite doesn't connect it or save anything: it tells you "This workspace has reached the maximum of 3 Meta businesses. Any additional client needs its own Account." and, in the We couldn't add this number window, offers Create an Account if you have access to Accounts. To swap one business for another, first remove all the numbers of the one that's leaving (the order is in Disconnect your WhatsApp line from the CRM): once its last number is gone, it stops counting.

If a line ever shows No access (for example, because its business lost its connection with MB Suite), an owner or admin reconnects only that number from the line's menu ⋮ with Reconnect this number; your other numbers aren't touched. Step by step in My WhatsApp doesn't send or receive messages.

After it's connected: two optional layers

Once the line exists (in any of the 5 ways), two things are optional and live in their own place:

  • Receivers — from the line's menu in CRM > Settings > Acquisition > Phones & WhatsApp, with Edit receivers, choose who gets the alert when a message comes into that line. A brand-new line starts with none (it shows "No receivers" until you set them). In the same panel, Sales reps who work this line decides which sales reps see it in Messages when Sales rep scope is on: Every sales rep works this line, which is how it starts, or Only selected sales reps work this line. It's edited by a Manager or a CRM Admin.
  • Lead source — if you want incoming messages to create prospects on their own, create the source in CRM > Settings > Sources with Add source > WhatsApp, picking that line. Without this, the line still works for chatting, but new inquiries don't enter the funnel automatically.
When you remove a number, the same layers apply in reverse — there's a right order so nothing is left half-connected. See Disconnect your WhatsApp line from the CRM. If you can't add or connect a number, see I can't add or connect my number.

Next step: before writing to someone outside the 24-hour window, get your WhatsApp templates: create, categories, and Meta approval ready.

Buying numbers, the prepaid balance and the use of WhatsApp from MB Suite are governed by the Terms and Conditions, which always hold the current version.

Still have questions?

Ask MIA, the MB Suite AI assistant: open it with the MB AI button (⌘J) in the top bar. MIA knows the section you're in, so you can ask it about what you see on screen — and it can also answer how-to questions about using MB Suite.