Get your Meta credentials
Find the WhatsApp Business account ID and the permanent access token you need to connect a WhatsApp Business number, and set up your Meta account from scratch.
To connect a number you paste two values from Meta: your WhatsApp Business account ID and a Meta access token. This page shows how to set up Meta and where to find both. It takes about 20 minutes the first time.
Before you start: check your phone number
- A new number, or one not on WhatsApp: ready to use. You'll verify it with one SMS or call.
- A number used in the WhatsApp app on a phone: delete the WhatsApp account on that phone first (Settings → Account → Delete account), wait a few minutes, then add the number in Meta. The app's chat history is lost.
Set up Meta from scratch
Do these in order. Already have a Meta app with WhatsApp and a number? Skip to step 5.
Create a business portfolio
- Go to business.facebook.com and sign in with your Facebook account.
- If you don't have a portfolio yet, click Create a business portfolio and enter your business name, your name, and a work email.
Once it exists, Settings shows your portfolio, with WhatsApp accounts and System users under Frequently used. You'll come back here in later steps.

Business verification isn't needed to start. You'll need it later to raise your messaging limit.
Create a Meta app with WhatsApp
- Open the Meta App Dashboard and click Create app.
- Enter the app name and your email.
- Choose the Connect with customers through WhatsApp use case and click Next.
- Pick the business portfolio from step 1, review the publishing requirements, and click Create app.
Meta creates a WhatsApp Business account with a free test number. The test number only reaches 5 people you add by hand, so add your own number next.
Add your own phone number
- In the App Dashboard, open WhatsApp → API Setup.
- Under Send and receive messages, click Add phone number.
- Enter your business display name and details, then the number, and verify it with the code Meta sends by SMS or voice call.
Meta reviews your display name. Until it's approved, customers may see your number instead of your name.
Add a payment method
Meta charges your WhatsApp Business account for templates, so it needs its own card.
- Open WhatsApp Manager and go to Settings → Payment methods.
- Add a card for this WhatsApp Business account.
Without it, templates fail with 141006. A card on the business portfolio doesn't count.
Create a system user and a permanent token
The token on Meta's API Setup page expires in a day, so create a system user and generate a permanent one.
Create the system user
- Open Business settings, click System users, then Add.
- Enter a name (for example
sys_wa), set System user role to Admin, and click Create system user.

Give it your app and WhatsApp account
- Select the new system user, open the ⋯ menu, and click Assign assets.

- Under Apps, tick your Meta app and turn on Manage app under Full access.

- Under WhatsApp accounts, tick your WhatsApp Business account and turn on Everything under Full access.

- Click Assign assets. You see Assets assigned; click Done.

Generate the token
- Back on the system user's page, click Generate token next to its name. Under Select app, choose the app you assigned in step 4, then click Next.

- Under Set expiry, choose Never.
- Under Assign permissions, tick
whatsapp_business_managementandwhatsapp_business_messaging.

- Click Generate token. Meta may ask you to confirm with a code sent to your registered phone number.
- Click Copy and store the token somewhere safe. Meta shows it only once.

Find your WhatsApp Business account ID
- Open Business settings.
- Under Accounts, click WhatsApp accounts.
- Click your WhatsApp Business account. Its ID is shown under the name.
Checklist
You're ready when you have:
- A phone number added to your WhatsApp Business account in Meta, not on the WhatsApp app on a phone
- A payment method on the WhatsApp Business account
- The WhatsApp Business account ID, from Business settings → WhatsApp accounts
- A system user token with Never expiration and both WhatsApp permissions
- Your Meta app published (Publish in the App Dashboard sidebar), or customer messages won't reach you later
Stuck? See the FAQ.
If your token is refused
OmniDimension checks the token with Meta before saving anything:
| Message | Fix |
|---|---|
| Meta didn't accept this token | Copy it again in full, or generate a new one. |
| This token is missing the WhatsApp … permission | Generate a new token with both WhatsApp permissions ticked. |
| This token expires on … | Generate a new token with expiry set to Never. |
| This WhatsApp Business Account is not accessible by your token | Check you pasted the WhatsApp Business account ID, and that the account is assigned to your system user. |
Other errors: WhatsApp error codes.
Official Meta references
How it works
The WhatsApp rules every business works within, including the 24-hour window, template categories, who charges what, quality rating, messaging limits, and opt-outs.
Connect a number
Connect a WhatsApp Business number to OmniDimension with your WhatsApp Business account ID and a permanent Meta access token, then register it and pick the numbers to import.
