How to Connect WhatsApp Cloud API to SaleSmartly: A Complete Guide
Your CS team has grown to three people, but everyone still takes turns on one phone running WhatsApp Business. When one person is off, chats pile up and nobody knows which customers have already been answered. This is the point where many businesses look at the WhatsApp Cloud API: one official number that several reps can handle at once, with chat history kept even when reps change.
The catch is that connecting the WhatsApp Cloud API often feels complicated because it involves three places at once: Meta Business Manager, Meta for Developers and the SaleSmartly dashboard. This guide puts everything into one flow, from preparation to a number your team can actually use.
Summary: Prepare your number and documents → submit Meta business verification → create a Business app in Meta for Developers → note the App ID, App Secret and BM ID → create a system user and token → enter everything in SaleSmartly → sync numbers and set the app live.
Not sure whether you need the API or the WhatsApp Business app is enough? Start with the difference between WhatsApp Business and regular WhatsApp and the difference between WhatsApp, WhatsApp Business and WhatsApp API.
Tip: Meta and SaleSmartly display menus in your account language. Menu names in this guide follow the English interface shown in the screenshots.
1. Before You Connect the WhatsApp Cloud API
Most setup problems come from one requirement missed at the start. Check these four things first:
| Requirement | Details |
|---|---|
| Admin access | Full admin access to your company's Meta Business Manager (BM) |
| Dedicated phone number | Can receive a verification code by SMS or call, and is not currently registered on the WhatsApp or WhatsApp Business app |
| Company documents | Business registration documents, tax number, proof of business address and an active company website domain |
| Payment method | A company credit card for Meta's message fees |
Important: for a manual Cloud API connection like the one in this guide, a number that is active on the WhatsApp or WhatsApp Business app must first be deleted from the app via Settings > Account > Delete my account. App chat history is deleted too, so back it up first if you still need it.
Note: If you still want to use that number in the WhatsApp Business app, don't delete it right away. Some WhatsApp API providers support WhatsApp Coexistence, which lets the same number keep some app features after it connects to an API platform, as long as the account meets the requirements. Confirm the requirements and migration rules first.
If your company doesn't have a BM yet, create one at business.facebook.com via Create new account.
2. Meta Business Verification: Start Early
Meta business verification lifts the trial limits on unverified accounts and is required to move up to higher messaging limits. Because the review takes time, submit it early so it doesn't hold up your launch.
- Open Business Settings, then go to Security Center.
- On the Business Verification card, click Start Verification.
- Upload company documents, such as your deed or business license and tax documents.
- Match your address with an official utility bill or bank statement, then confirm domain ownership with a code sent to a company email or a DNS TXT record.
Meta's review usually takes 1 business day to 72 hours. You can continue with the next steps while you wait. Menu names may differ slightly depending on your region and account version.
3. How to Connect WhatsApp Cloud API to SaleSmartly
3.1. Create a Business app in Meta for Developers
Go to developers.facebook.com/apps/create, choose the Business type, click Next, then enter the App name and App contact email.
In the Business portfolio field, select the BM you will use, then click Create app. One app can only be linked to one BM, and only the WABAs and numbers under that BM will sync to SaleSmartly.
3.2. Add the WhatsApp product
In the app Dashboard, find the WhatsApp product and click Set up. Whether this product is available can depend on the region your Facebook account is registered in and on Meta account restrictions.
3.3. Note the App ID, App Secret and BM ID
Go to Settings > Basic and note the App ID, App Secret and BM ID. The BM ID is in the Business verification section further down the same page. You will enter all three in SaleSmartly. Treat the App Secret like a password: don't share it in group chats.
3.4. Create a system user and access token
- Open business.facebook.com/settings, select the linked BM, then go to Users > System users.
- Click Add and create a system user with the Admin role.
- Click Add Assets, select the app you just created and enable Manage app permission.
- Click Generate New Token, select the app, then tick three permissions:
business_management,whatsapp_business_messagingandwhatsapp_business_management. - Copy the access token that appears.
If your BM doesn't allow Admin system users, create an Employee system user and grant it full permissions on the WhatsApp account.
3.5. Enter the details in SaleSmartly
In SaleSmartly, go to Integration > WhatsApp API, open the Third party tab, then click Add number. Choose Cloud API, fill in AppId, Secret, Token and Bind BM number Id, then click OK to connect.
3.6. Sync numbers and set the app live
Once connected, SaleSmartly automatically pulls the first 50 numbers in that WABA. For numbers beyond 50, click Sync numbers. Enable the numbers you want to use.
Finally, go back to Meta for Developers and switch the app status to Live. If you see a warning that the privacy policy URL is invalid, enter your real Privacy Policy URL under Settings > Basic, save, then switch it live again.
The full screen-by-screen technical guide is in the Help Center: Connect Cloud API.
4. After Connecting: Make Sure Your Team Is Ready to Reply
An active number doesn't mean your team is ready. Before you announce the number to customers:
- Check that the number status is active under Integration > WhatsApp API.
- In Configure customer service, choose the team members who will handle chats from this number.
- Use Migrate contacts, Test message and Edit automation as needed.
- Send a test message from another number and confirm it lands in the chat module and reaches the assigned rep.
That way incoming chats are shared across the team straight away, nothing slips through, and conversation history stays intact even when reps change. WhatsApp API chats also land in the same multi-channel inbox as Instagram, TikTok and other channels, and can be connected straight to automation flows such as auto-replies.
Before you start broadcasting, read how to keep your WhatsApp number quality rating healthy so your sending limits don't drop.
5. Don't Want to Set It Up Manually?
If your team doesn't have time to manage apps and tokens in Meta for Developers, you can also register a WhatsApp Business API number through SaleSmartly. The steps are in Register WhatsApp Business API via SaleSmartly. To pick a plan that fits your team size, compare SaleSmartly plans.
6. Key Takeaways
- Check your number and documents before you start, because for a manual setup, a number still active on the WhatsApp app can't be registered.
- Confirm whether your number can use WhatsApp Coexistence before deleting the account from the app.
- Submit Meta business verification early and keep setting up while the review runs.
- Link the app to the right BM, because only the WABAs in that BM sync to SaleSmartly.
- Store the App Secret and access token like passwords.
- Test one real message before announcing the number to customers.
7. FAQs
Is the WhatsApp Cloud API free?
Not entirely. Since 1 July 2025, Meta charges per message based on its category, such as marketing, utility and authentication. That is why a payment method needs to be added in your BM and linked to the WABA. Fee details are in WhatsApp API Fees.
Can I use a number that's already active on the WhatsApp Business app?
For a manual Cloud API setup, yes, once the WhatsApp account on that number has been deleted from the app. App chat history is deleted too, so back it up first if you still need it. If you still want to use the number in the app, first check whether your account qualifies for WhatsApp Coexistence through a provider that supports it.
Do I have to wait for Meta business verification to finish?
No. The review usually takes 1 business day to 72 hours, and in the meantime you can still set up a payment method and connect the WhatsApp Cloud API to SaleSmartly.
Why doesn't the WhatsApp product appear in my app dashboard?
Availability of the WhatsApp product can depend on the region your Facebook account is registered in and on Meta account restrictions. Check the region settings of your Facebook account and BM, then recreate the app if needed.
How many numbers can be synced to SaleSmartly?
SaleSmartly automatically pulls the first 50 numbers in a WABA. Additional numbers can be added with the Sync numbers button.
Ready to run the WhatsApp Cloud API with your team? Sign up and try SaleSmartly.
SaleSmartly Promo 2026: Up to 30% Off and Up to 150 Bonus Days
SaleSmartly year-end promo 2026: up to 30% off plans, up to 150 bonus days and a surprise Gift Card. Valid until 10 December 2026. See the details here.
10 WhatsApp API Providers Compared: Features, Pricing and Who Each One Fits (2026)
Compare 10 WhatsApp API providers, from SaleSmartly, Wati and Respond.io to Twilio. Check features, pricing and hidden costs before you pick one for your team.