BotCommerce uses the Official API. It allows you to connect your account via both Cloud API and a QR Code option via Official API, allowing with this last one to keep mobile access to your phone number.

How to Connect via QR Code in BotCommerce

To connect via QR Code in BotCommerce, navigate to WhatsApp > Connect Account. Click on Connect WhatsApp > Connect with Catalog Permission to launch the WhatsApp Embedded Signup Flow in a new tab.

There, log in to your Facebook Business Manager account. Click on the Continue with Facebook button. Then, select the Business Portfolio where you wish to link the WhatsApp and click Next. Select Connect your existing WhatsApp Business Account as connection method to launch the QR process and click on Next again.

Enter the phone number associated with your business. Accept the necessary permissions and terms of service. Enter the verification code sent to your WhatsApp account. It will appear as coming from Facebook Business. Grant the app the necessary permissions. Allow it to manage your WhatsApp accounts and your conversations. Click Continue.

Complete the QR signup. You will be presented with the QR code and instructions to scan it using the WhatsApp message that Meta will send to your number.

Requirements for This Method

For this method, you will need:

• An existing WhatsApp Business Account (not a personal WhatsApp number)
• Admin access to the WhatsApp Business Account
• A phone number that:
  • Isn’t already linked to another WhatsApp API account.
  • Belongs to a supported country.
• A Meta Business Account

⚠️ Unsupported countries:
Numbers from Australia, India, Japan, Nigeria, Philippines, Russia, South Korea, South Africa, Turkey, the EEA, EU, and UK are not eligible for this onboarding method.

If You’re Using a Personal WhatsApp Number

If your number is on a personal WhatsApp account, you must migrate it to WhatsApp Business first (don’t worry — your chats and data won’t be lost). Then, use it for a few days before trying to connect it. New Business numbers are not immediately eligible for API use.

Alternative: Connect any Personal or Business WhatsApp account via QR Code using SocialPoster (Unofficial API)

💡 SocialPoster uses an unofficial API for QR code login, unlike BotCommerce. This means it emulates WhatsApp Web, allowing 100% of WhatsApp accounts—personal or business—to connect by simply scanning a QR code, without losing mobile access.

If your number isn’t eligible yet — or if you want to connect a personal WhatsApp account — you can use SocialPoster, another app in the Planify X suite.

It allows you to scan a WhatsApp Web QR Code and link your number instantly. Perfect for resellers or users who want to keep using WhatsApp normally.

👉 Start your free trial with Planify X

To connect a WhatsApp account to SocialPoster, login to Planify X, select SocialPoster. Once in the app, go to WhatsApp > Add Account and click on Scan QR Code to show it.

Then, in your cellphone, just open WhatsApp, and select devices > linked devices. Then, scan the QR Code just as you would do to open WhatsApp web in your computer. The account will be linked automatically.

Note that unlike BotCommerce, SocialPoster is not using the official Meta API. There are a few advantages and downsides for this:

✅ You can still use WhatsApp normally
You won’t lose access to your regular WhatsApp app, so you can keep using it like you always do. This is a big advantage, especially of you are a reseller or creating chatbots for your customers, as most of them do not want to lose their accounts.

✅ No extra fees for WhatsApp
You won’t have to pay anything extra for using WhatsApp with our app. The only associated costs will be your subscription to our app, and the cost of OpenAI tokens in case you wish to connect an AI to answer your chats (more on this here).

❌ It might not be as reliable
Since it’s not the preferred method by Meta, there’s a chance it could stop working with future updates.

❌ You might need to update the connection occasionally
The library we use for the WhatsApp QR Code API connects through something called sockets. These sockets keep WhatsApp Web connected to WhatsApp servers, receiving data about events like when a message is received. However, sometimes WhatsApp disconnects them without any reason. To solve this, you will need to go to admin mods from the side menu and click on “restart app.” This will restart the socket connections and reconnect them again.

❌ Some features might not work
You won’t be able to use certain features, like buttons and menus, with this method.

So, those are the main things to consider when linking your WhatsApp account with our app. If you’re unsure which option is best for you, feel free to reach out to us for help!