MCP is live.Set upAsk on Discord
OmniDimension

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

  1. Go to business.facebook.com and sign in with your Facebook account.
  2. 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.

Meta Business settings showing the business portfolio, with WhatsApp accounts and System users in the sidebar

Business verification isn't needed to start. You'll need it later to raise your messaging limit.

Create a Meta app with WhatsApp

  1. Open the Meta App Dashboard and click Create app.
  2. Enter the app name and your email.
  3. Choose the Connect with customers through WhatsApp use case and click Next.
  4. 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

  1. In the App Dashboard, open WhatsApp → API Setup.
  2. Under Send and receive messages, click Add phone number.
  3. 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.

  1. Open WhatsApp Manager and go to Settings → Payment methods.
  2. 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

  1. Open Business settings, click System users, then Add.
  2. Enter a name (for example sys_wa), set System user role to Admin, and click Create system user.

The Create system user dialog with a name and the Admin role

Give it your app and WhatsApp account

  1. Select the new system user, open the ⋯ menu, and click Assign assets.

A system user with Generate token, Revoke tokens, and the menu open on Assign assets

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

Select assets and assign permissions, with the app ticked and Manage app turned on

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

Select assets and assign permissions, with the WhatsApp accounts ticked and Everything turned on

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

The Assets assigned confirmation

Generate the token

  1. 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.

Generate token, step Select app, with the app chosen

  1. Under Set expiry, choose Never.
  2. Under Assign permissions, tick whatsapp_business_management and whatsapp_business_messaging.

Generate token, step Assign permissions, with the WhatsApp permissions ticked

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

The Token created dialog with the token and a Copy button

Find your WhatsApp Business account ID

  1. Open Business settings.
  2. Under Accounts, click WhatsApp accounts.
  3. 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:

MessageFix
Meta didn't accept this tokenCopy it again in full, or generate a new one.
This token is missing the WhatsApp … permissionGenerate 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 tokenCheck 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

On this page