Skip to main content
This is the main connection guide. By the end of it, your WhatsApp number will be linked to Xobito and ready to send.
Before you start, please complete the Prerequisites. If you haven’t, at least half of these steps will fail.

​
What you’re about to do

You’ll open Meta’s official embedded signup dialog from inside Xobito, log in with Facebook, pick (or create) a WABA, pick (or add) a phone number, verify it with an OTP, and let Xobito finalize the handshake. Total time: ~5 minutes if the prerequisites are in place.

​
Step 1 — Open the connect page in Xobito

1

Log into Xobito

Go to dash.xobito.com and sign in.
2

Open the sidebar

On the left, expand the Setup section.
3

Click 'Connect WhatsApp'

You land on the connection page with a big Login with Facebook button.

​
Step 2 — Click ‘Login with Facebook’

Click the blue Login with Facebook button. Meta’s embedded dialog opens in a new pop-up window.
If nothing happens when you click, your browser probably blocked the pop-up. Look for a small pop-up-blocked icon in the address bar and allow pop-ups from dash.xobito.com, then click the button again.

​
Step 3 — Log into Facebook

Inside the pop-up:
1

Enter your Facebook email and password

Use the personal Facebook account that is an Admin of your Business Manager.
2

Click 'Continue as [Your Name]'

Meta asks you to confirm it’s you.
Xobito never sees your Facebook password. The login happens inside Meta’s own dialog — we only receive a secure access token at the end.

​
Step 4 — Pick your Business Manager

Meta asks which Business Manager you want to connect. If you have only one, it’s pre-selected.
1

Select the Business Manager

Choose the one that owns (or will own) this WhatsApp number.
2

Click 'Continue'

Meta moves to the WABA selection screen.

​
Step 5 — Pick or create a WABA

1

Select the WABA from the list

Meta shows the WABAs your Business Manager owns.
2

Click 'Continue'

You’ll then pick a phone number inside this WABA.

​
Step 6 — Add the phone number

1

Click 'Add phone number'

Or select an already-added number if you have one.
2

Enter your display name

The name customers will see — follow display name rules.
3

Choose the business category

Pick the category that best fits your use case (e.g. E-commerce, Education, Financial Services).
4

Pick country and enter the phone number

Full international format, digits only. Meta pre-fills the country code.
5

Choose verification method

Text (SMS) or Call. Pick whichever works — if SMS fails, retry with Call.
6

Click 'Send Code'

Meta sends the 6-digit OTP.

​
Step 7 — Verify with the OTP

1

Enter the 6-digit code

Arrives within 1–2 minutes.
2

Click 'Verify'

If correct, the number flips to Verified.
3

Click 'Continue'

Meta moves to the final confirmation step.
Enter the code carefully. After 3 wrong attempts Meta locks OTP for ~30 minutes.

​
Step 8 — Grant permissions and finish

Meta’s final screen asks you to grant Xobito permission to send messages on behalf of your WABA.
1

Review the permissions

Xobito requests: manage WhatsApp messaging, view and manage WABA, manage business assets. All required.
2

Click 'Continue' / 'Allow'

Meta generates a secure access token for Xobito.
3

Wait for the success screen

The dialog closes automatically. You’re back on Xobito’s connect page.
If you see the success banner and your phone number listed, you’re connected.

​
Step 9 — What Xobito does in the background

In the ~10 seconds after the dialog closes, Xobito:
  1. Stores the Meta access token (encrypted).
  2. Registers your webhook URL with Meta so incoming messages reach us.
  3. Syncs any existing templates from your WABA into Xobito.
  4. Reads your phone number’s display name, quality rating, and messaging tier.
  5. Marks the account as active in Setup → Account.
You don’t have to do anything here — it’s all automatic.

​
Step 10 — Send a test message

Let’s prove it works.
1

Go to Chat in the sidebar

The Live Inbox opens.
2

Click 'New Chat'

A contact picker appears.
3

Enter your own phone number

Use the same number that’s connected only as a contact if you have a second WhatsApp — or a friend’s number with their permission.
4

Send the 'hello_world' template

Click Send Template, choose hello_world, and click Send.
5

Check the receiving phone

You should see the message appear in WhatsApp within a few seconds.
If the test message arrives, your connection is 100% healthy. If it doesn’t, jump to the troubleshooting section below.

​
Troubleshooting

Your browser is blocking the pop-up. Allow pop-ups for dash.xobito.com and try again. In Safari, also enable “Cross-site tracking” for this site or use Chrome/Firefox.
The Facebook account you logged in with is not an admin of any Business Manager. Either log in with an account that is, or create a new Business Manager at business.facebook.com.
The number is still on the WhatsApp/Business app, or Meta hasn’t released it after deletion. Delete it from the app, wait 15–30 minutes, then retry.
Your display name violates Meta’s naming rules. Common fixes: include your actual business name, drop generic words (“Support”, “Team”), remove emoji and ALL CAPS. Retry with a compliant name.
Try switching from SMS to Call in Meta’s dialog — some carriers block automated SMS from Meta. If Call also fails, the number may not be able to receive international calls; try a different number.
Refresh the page. If still nothing, go to Setup → Account and look for an error banner. Most commonly: a permission was denied in the Meta dialog. Start the connect flow again and approve all requested permissions.
Rare, but it happens if Meta is having an outage. Wait 5 minutes and click the Retry Webhook button on the Account page. See Webhook Setup for manual options.
Three likely causes: (1) the receiving number is on the WhatsApp app but with a cached block — ask them to open WhatsApp; (2) the receiving number has never opted into receiving messages from businesses — they need to reply START or message you once first; (3) your quality rating is Red and Meta throttled the send — check Setup → Account.
Go to Setup → Account, click Disconnect, then run the connect flow again from scratch. See Disconnect for details on what gets reset.
Usually a browser extension (ad blocker, tracking blocker) interfering with Meta’s dialog. Disable extensions for dash.xobito.com and facebook.com, or try an incognito/private window.

​
Where to go next

Manage phone numbers

View quality rating, messaging tier, and change display names.

Verify webhook

Confirm that incoming messages reach Xobito.

Create a template

Design your first branded message and submit for approval.

Import contacts

Get your audience into Xobito with a CSV.