Skip to main content
WhatsApp

How to Create a WABA and Link Your WhatsApp Number to DeepAgent

If you want to use DeepAgent's WhatsApp agents, the first step is to set up a WhatsApp Business Account (WABA) on Meta, with a verified phone number linked to it. This guide walks you through the process step by step, starting from scratch, using only official Meta tools and links.

Written By Product

Last updated 4 months ago

What Is a WABA

WABA is Meta’s official “container” that manages your phone number for use on the WhatsApp Business Platform. It’s different from the regular WhatsApp Business app you download to your phone: here we’re talking about the professional platform (API), which allows tools like DeepAgent to send and receive messages automatically. Without an active WABA and a verified number, DeepAgent cannot connect agents to WhatsApp.

What You Need Before You Start

  • A personal Meta account with access to a business portfolio (or the ability to create one)

  • A phone number that isn’t already active on another personal or Business WhatsApp app; otherwise, you’ll need to remove it from there first

  • The ability to receive a code via text message or phone call on that number

  • If you also want the official green badge in the future, note that this is a separate step and not required to get started

Official links to use

  • Meta Business Suite (where you create your WABA): https://business.facebook.com/

  • Meta for Developers – WhatsApp Business Platform (complete technical documentation): https://developers.facebook.com/docs/whatsapp/

  • WhatsApp Business Developer Hub (to start building and integrating): https://business.whatsapp.com/developers/developer-hub

  • WhatsApp’s official “Getting Started” guide: https://faq.whatsapp.com/5773272372736965

  • Phone number verification: https://www.facebook.com/business/help/908314225274315/

  • Add WABA to your business portfolio: https://www.facebook.com/business/help/713785646327651

  • Request an Official Business Account badge (optional, not required at the start): https://www.facebook.com/business/help/604726921052590

Step 1 — Log in to Meta Business Suite

  1. Go to https://business.facebook.com/

  2. Log in with your personal Meta account

  3. If you don’t have a business portfolio yet, Meta will guide you through the setup process when you log in for the first time

  4. Once inside, open Settings (bottom left)

If you can’t see some of the sections described in the following steps, the most common reason is that your user doesn’t yet have full administrator permissions for the business portfolio.

Step 2 — Create your WhatsApp Business Account (WABA)

  1. In Settings, look for the Accounts section and then WhatsApp Accounts

  2. Click Add and select Create a new WhatsApp Business account

  3. Fill in the required information:

    • WhatsApp Business account name

    • Business category

    • Website (if available)

    • Company time zone

  4. Confirm and accept Meta's Terms of Service

At this point, your WhatsApp Business account exists, but it’s still “empty”: it doesn’t have a phone number linked to it.

Step 3 — Link and verify your phone number

This is the most delicate step, because the number must not be in use by anyone else on WhatsApp.

  1. On your WABA page, click Add Phone Number

  2. Enter the international country code (e.g., +39 for Italy) and the full phone number

  3. Choose how you want to receive the code: SMS or voice call

  4. Enter the verification code you receive

  5. Once finished, you’ll be asked to set up a two-factor PIN to protect the number: write it down, because you’ll need it in the future for maintenance operations

  6. Confirm to complete the number registration

Note: If the number is already registered on regular WhatsApp or WhatsApp Business (the app on your phone), you must first delete that WhatsApp account from your phone (Settings → Account → Delete Account—uninstalling the app is not enough) and wait a few minutes before registering it on WABA.

Step 4 — Check the WABA status

After verification:

  • The number should appear as “Connected” or “Verified” in the WhatsApp Account section

  • In some cases, Meta performs additional security checks that may take up to 24 hours

  • If everything is in order, the WABA is ready to be connected to external tools such as DeepAgent

If something doesn’t seem right, the first place to check is always the WhatsApp Accounts section in Meta Business Suite.

Step 5 — Connect the WABA to DeepAgent

  1. Open DeepAgent and go to the Integrations menu

  2. Look for the WhatsApp card among the available integrations

  3. Click “Add Connection”

  4. The official Meta authentication window, called Embedded Signup, will open: this is a secure pop-up provided directly by Meta, not by DeepAgent

  5. Log in with the Meta profile you used to create your business portfolio and WABA in the previous steps

  6. Meta will show you two options: link an existing business or create a new one. Select your existing business—the one where you’ve already created the WABA

  7. Choose the WABA you’ve already created (or, if you prefer, let Meta automatically create a new one during this same process)

  8. Select your already verified phone number, or complete the verification process directly from this workflow if you haven’t already done so

  9. Meta will ask you to authorize the permissions requested by DeepAgent (message management, template management, access to the phone number)

  10. Confirm the permissions: at this point, Meta will close the pop-up and grant DeepAgent access to your WABA

  11. In DeepAgent, you’ll see the connection appear as Active in the Integrations → WhatsApp section

Important note on authentication

When logging in, Meta uses the same account you used to create your business portfolio in Meta Business Suite: if you have multiple Meta profiles, make sure to authenticate with the correct one; otherwise, the flow won’t find your WABA among the available options.

Frequently Asked Questions

Can I use a landline number instead of a cell phone number? Yes, many landline numbers work if they can receive verification via voice call instead of SMS.

Do I need a Facebook Page to create a WABA? No, but you must have an active Meta Business Portfolio, which you can create for free when you first log in to Business Suite.

How long does verification take? Usually just a few minutes, but in some cases Meta may take up to 24 hours to complete security checks.

Do I need the official green badge to get started? No, the badge (Official Business Account) is a separate, subsequent request and isn’t required for the initial setup.

Common Errors

I don’t see my WABA in the list when connecting to DeepAgent Make sure you’re logged in with the same Meta account you used to create it, and check that you have administrator permissions on the business portfolio.

The pop-up closes before completing the process. This is often caused by your browser’s pop-up blocker; disable it for the DeepAgent domain and try again.

Permissions aren’t requested. Try repeating the connection from scratch by clicking “Add Link” again; the Embedded Signup flow always restarts from the beginning.

I don’t see the WhatsApp section in Meta Business Suite. You likely don’t have the correct admin permissions in the business portfolio.

The number is already in use elsewhere. If the number is linked to another WhatsApp account, you may need to remove it or use a different number.

Quick summary with links

StepWhat to DoLink

1

Log in to Meta Business Suite

https://business.facebook.com/

2

Create the WABA

"WhatsApp Account" section within Business Suite

3

Link and verify the number

https://www.facebook.com/business/help/908314225274315/

4

Review the technical documentation (optional)

https://developers.facebook.com/docs/whatsapp/

5

Connect WABA to DeepAgent

Integrations → WhatsApp → Add Connection (within DeepAgent)

Final Checklist

  • [ ] You have an active Meta account

  • [ ] You have admin access to the business portfolio

  • [ ] You’ve created the WABA

  • [ ] You’ve linked the number

  • [ ] You have completed verification via SMS or phone call

  • [ ] You clicked on Integrations → WhatsApp → Add Link at DeepAgent

  • [ ] You have completed Meta authentication and granted permissions