Get a WhatsApp number for your ordering bot
Prepare the business number your customers will write to.
Your WhatsApp ordering bot answers from a phone number registered on Meta's WhatsApp Business Platform. Getting that number ready is usually the slowest part of the setup, mainly because of Meta's business verification, so start early.
In Connect → WhatsApp bots you can connect with WhatsApp Business Login or Manual credentials. With WhatsApp Business Login, Meta adds and verifies the number inside its own window, so you only need the items below. Follow Option B only for manual credentials.
Before you start
- A Facebook account that will manage the business in Meta.
- A Meta business portfolio (formerly Business Manager). You can create one during setup.
- A phone number for WhatsApp that belongs to your business, includes the country code, can receive an SMS or a call for the verification code, and is not a short code.
- A display name: the business name customers see in WhatsApp. Use your real brand name.
- Business documents for Meta's business verification, such as your business registration and proof of address.
A number active in the WhatsApp or WhatsApp Business app must be removed from that app before Meta registers it, and it can't go back to the app afterwards. To keep your current WhatsApp number on your phone, use a different number for the bot.
Option A: Connect with WhatsApp Business Login (recommended)
- In the Dashboard, open Connect → WhatsApp bots and create or open your bot.
- Choose WhatsApp Business Login.
- In the Meta window, sign in with your Facebook account, then:
- select or create your business portfolio;
- select or create a WhatsApp Business account;
- add your phone number and display name;
- enter the code Meta sends by SMS or call.
- When the window closes, check that the number appears on the bot.
- Complete business verification and add a payment method in Meta before you go live.
Option B: Set up the number yourself in Meta
Use this path to get the details for Manual credentials.
1. Create a Meta app with the WhatsApp use case
- Go to developers.facebook.com/apps and select Create App.
- Enter an app name, for example "[Your brand] Ordering Bot", and your contact email.
- Select the use case Connect with customers through WhatsApp.
- Select your business portfolio, or create one.
- Select Create app. Under Choose your integration type, keep Integrate with API.
2. Try it with Meta's test number (optional)
Meta gives every new app a free test number. You can connect it to your bot to try the full ordering flow before your own number is ready.
The test number has strict limits: it can only message the phone numbers you add as recipients in Meta, and it has a low message allowance. While you test, the menu opens in the phone's browser instead of inside WhatsApp. Never share a test number with customers.
3. Add your business phone number
In Production setup:
- Select or create the WhatsApp Business account for your business.
- Select Add phone number, then enter the display name and business details.
- Enter the number in international format, for example
+52 33 1234 5678. - Choose Text message or Phone call and enter the verification code.
You can also add numbers later in WhatsApp Manager → Account tools → Phone numbers.
4. Verify your business
Follow Business verification and upload the documents Meta asks for. Meta reviews them and approves your display name. Until then, your number can only message a limited number of customers a day.
5. Add a payment method
In WhatsApp Manager, open the payment settings and add a payment method. Meta bills some conversation types directly to you; check Meta's current pricing for your country.
6. Publish the app
In the Meta app dashboard, switch the app from Development to Live (publish it). An app left in development mode only works with test recipients.
7. Create a permanent access token
The token shown during testing expires within a day. Your bot needs a long-lived one:
- Open business.facebook.com/settings and select System users.
- Select Add, name the system user, and give it the Admin role.
- Select Assign assets and give it full control of your app and your WhatsApp Business account.
- Select Generate token, choose your app, and add these permissions:
business_managementwhatsapp_business_messagingwhatsapp_business_management
- Copy the token and store it safely. Meta shows it only once.
8. Copy the details and connect them
In your Meta app, open WhatsApp → API Setup and copy the Phone number ID, the WhatsApp Business Account ID, and the phone number.
Then, in Connect → WhatsApp bots, open your bot, choose Manual credentials, and enter the Phone number ID, the phone number, and the access token.
Messaging limits and the in-chat menu
Meta assigns every number a messaging limit. New numbers start at a low limit (250 conversations a day) that Meta raises after business verification and steady, good-quality use.
Once your number is above that starting limit, the bot's menu opens inside WhatsApp. Before that, including on the test number, it opens in the phone's browser. Ordering works the same way in both cases.
Verify the result
- In WhatsApp Manager → Phone numbers, the number shows Connected and the display name is approved.
- In Connect → WhatsApp bots, the number appears on your bot.
- A message sent from a phone that isn't a test recipient gets the bot's welcome message.
Troubleshooting
Meta doesn't send the verification code
Make sure the number can receive SMS or calls from international senders, then try the other method. If the number has a phone menu, it must be able to route Meta's call to a person.
Meta says the number is already registered
The number is still active in the WhatsApp or WhatsApp Business app, or registered with another provider. Delete that WhatsApp account, or ask the provider to release the number. Turn off two-step verification for that number first.
Only my test phones get answers
The Meta app is still in development mode, or you are still on the test number. Publish the app and connect your verified business number.
The bot stopped answering
With manual credentials, the access token may have expired or been revoked. Create a new system user token and update the bot. Also check that the number still shows Connected in WhatsApp Manager.
My display name was rejected
Edit the display name in WhatsApp Manager so it matches your business name, then submit it again.
Related guides: Set up a WhatsApp ordering bot · WhatsApp bot go-live checklist