Set Up BotSailor Whitelabel: WhatsApp Embedded Signup Guide
TL;DR:BotSailor’s Embedded Sign-Up for WhatsApp allows White Label Reseller customers and their users to easily connect WhatsApp Business accounts directly through a branded interface. By creating a Facebook Business app, enabling Facebook Login for Business, configuring Embedded Signup, setting up webhooks, generating an access token, and connecting the API inside BotSailor, resellers can provide a seamless WhatsApp onboarding experience. Once configured and verified by Meta, users can sign up for WhatsApp Business effortlessly, and their bot account is automatically added.

Configuring theEmbedded Sign-Up for WhatsApp Connectionis super easy for ourWhite Label Resellercustomers and their users. This guide is designed specifically to help you streamline the process, ensuring your end-users can effortlessly connect their WhatsApp accounts through yourwhite label solution. Follow these steps, and use the accompanying video and screenshots to make the setup process seamless and efficient.


Here is the video guideline:

### Create an App

1. **Visit Facebook Developer Site**:

- Go tohttps://developers.facebook.com

2. **Create App**:

- Click "My Apps" > "Create App".

- Select "Business" as the app type.

- Fill out the form with the necessary information and create the app.

### Configure App for Embedded Signup

1. **Add Product**:

- Go to 'Add Product' and set up 'Facebook Login for Business'.

2. **Get Advanced Access**:

- Click 'Get Advanced Access' for `public_profile` and `email`.

- Complete the questions and submit.

3. **Privacy Policy URL**:

- You may need the privacy policy URL.You will get it from System Settings -> WhatsApp.

4. **Enable Embedded Signup**:

- Select 'Embedded Signup' and save changes.

5. **Configuration**:

- Go to 'Configurations' under 'Facebook Login for Business'.

- Click 'Create Configuration' and name it.

- Select 'WhatsApp Embedded Signup' and proceed.

- Select 'WhatsApp Accounts'.

6. **Permissions**:

- Choose 'Catalog Management', 'WhatsApp Business Management', 'WhatsApp Business Messaging'.

- Save and copy the Configuration ID.

### Configure Webhooks

1. **Webhooks Setup**:

- In the WhatsApp section of your app, click 'Configure Webhooks'.

- Get the Callback URL and Verify Token from System Settings -> WhatsApp.

- Enter these in the Facebook Developer console.

2. **Webhook Fields**:

- Click 'Manage Webhook Fields', choose 'messages', 'smb_app_state_sync ','smb_message_echoes ','history' and save.

### Generate Access Token

1. **Access Token**:

- Visit https://business.facebook.com

- Go to 'System Users' and create a system user.

- Click on the system username, then 'Assets'.

- Add your Facebook app, give full control, and save.

- Select 'Generate Token', choose your app, and proceed.

- Select the permissions: `Business_management`, `Catalog_management`, `WhatsApp_business_management`, `WhatsApp_business_messaging`.

- Generate and copy the token.

### Connect API with BotSailor

1. **Login**:

- Log in to the system.

- Go to Settings -> WhatsApp.

2. **App Details**:

- Enter the app name.

- Enter the App ID and Secret from your Facebook app's basic settings.

- Enter the Configuration ID and Token.

- Save your changes.

Embed Sign Up App needs to be reviewed and verified by Meta. Please follow the below blog to learn how to Submit to verfiy the App.

How to Submit the app for verification

For Detailed instructions please follow the steps below:

Create an App

To create an app, go to the Facebook Developer page, click on the "My Apps" tab, then click "Create App." Select "Other" and click "Next." On the next screen, select "Business" as the type and click "Next."

Image

And a form will appear, and you have to fill out the form by providing the basic information.

In theApp Namefield, put an app name for your app. In theApp Contact Emailfield, provide an Email address.

In theBusiness Accountfield, select a business account. Click on the field, and a list of predefined Business accounts will appear. From the list, you can select a business account. However, the field is optional. Later, when we add WhatsApp to this app, Meta will ask to add a business account. If you don't have one, you can create it later and add it there.

Now click on theCreate Appbutton.

Image

App creation is done! Now Embedded Signup configure step :

Go to "Add Products" and set up "Facebook Login for Business".

Image

Now take the advanced access to public_profile and email. Click on the Get Advance access.

Image

Now Click on 'Request advance access'

Image

As soon as we click on the request for advance access, it will ask to provide a valid Privacy policy URL. Click on the Basic Settings from there. And put the privacy policy URL there. You will get the privacy policy from the BotsailorSettings -> WhatsApp.

Image

Image

Now enable "Embedded Browser OAuth Login"&"Login with the JavaScript SDK"and then click on the"Save Changes"button.

Image

Then go to "Configurations"under"Facebook Login for Business", and click on"Create Configuration"and name it. Select"WhatsApp Embedded Signup"and proceed, then select"WhatsApp Accounts".

Image

Choose Permissions"Catalog Management","WhatsApp Business Management","WhatsApp Business Messaging", then save and copy theConfiguration ID.

Image

Image

Now time to configure webhook:

In the WhatsApp section of your app, click"Configure Webhooks", get theCallback URLandVerify Tokenfrom SystemSettings -> WhatsApp, then enter these in the Facebook Developer console.

Image

Image

You will get the Callback URL and Verify Token fromSystem Settings -> WhatsApp

Image

Image

Webhook Fields:

Click on"Manage Webhook Fields", choose"messages", "smb_app_state_sync","smb_message_echoes","history"and then click on theSavebutton.

Webhook

Generate Access Token

  1. Access Token: Visithttps://business.facebook.comgo to 'System Users' and create a system user, click on the system username, then 'Assets', add your Facebook app, give full control, and save, select 'Generate Token', choose your app, and proceed, select the permissions:Business_management,Catalog_management,WhatsApp_business_management,WhatsApp_business_messaging, generate and copy the token.

Image

Create users, assign assets, and grant full control to your WhatsApp app.

Image

Choose the apps to grant full control and assign assets.

Image

Select"Generate Token", choose your app, and proceed.

Image

Image

Select the permissions:"Business_management", "Catalog_management", "WhatsApp_business_management", "WhatsApp_business_messaging".

Image

Image

Then, click on the"Generate Token"and then copy the token to use into the Botsailor.

Image

Connect API with BotSailor

1. **Login**:
- Log in to the system.
- Go to Settings -> WhatsApp.

- Enter the app name.
- Enter the App ID and Secret from your Facebook app's basic settings.
- Enter the Configuration ID and Token.
- Save your changes.

Image

That's all. Now your users can signup to WhatsApp business by using the embed sign up and the bot account will be added automatically.

Image

Next the Embed sign up App needs to be reviewd and verified by Meta. To Learn how to Verifiy please follow the below blog.

How to Submit the app for verification

Frequently Asked Questions

Find answers to common questions about this topic

What is Embedded Sign-Up for WhatsApp?

Embedded Sign-Up is available for White Label Reseller customers and their end-users who want to connect WhatsApp Business accounts through a fully branded experience.

Yes. You must create a Facebook Business App and configure it with Facebook Login for Business and WhatsApp Embedded Signup to enable this feature.

The required permissions include:

Catalog Management

WhatsApp Business Management

WhatsApp Business Messaging

These permissions allow BotSailor to manage WhatsApp accounts and messaging on behalf of users.

Yes. Meta requires a valid Privacy Policy URL to request advanced access and enable Embedded Sign-Up. You can obtain this URL from BotSailor → System Settings → WhatsApp.

Why do I need to configure webhooks?

You should enable the following webhook fields:

messages

smb_app_state_sync

smb_message_echoes

history

These ensure full message and account synchronization.

You must create a System User in Facebook Business Manager, assign your app with full control, and generate a token with the required WhatsApp and business permissions.

Share this article:

(0) Comments

Leave a Comment