This guide walks you through connecting your WhatsApp Business account to Kapso using the embedded signup flow, which is the recommended method for most users.

​

Prerequisites

Before you begin, make sure you have:

• A Kapso account with an active project
• Access to your WhatsApp Business app or a phone number to set up
• Administrator access to your Facebook Business account

​

Step 1: Navigate to WhatsApp configurations

1. Log in to your Kapso dashboard
2. Select your project from the project list
3. Navigate to the WhatsApp section in the left sidebar

​

Step 2: Start the connection process

Click the Connect WhatsApp Business button at the top right of the WhatsApp configurations page.

​

Step 3: Select your customer

If your project has multiple customers, you’ll need to select which customer to connect WhatsApp for.

​

Step 4: Choose connection type

You’ll see two options for connecting WhatsApp:

​

Option 1: Connect with WhatsApp Business app

Choose this option if you:

• Already use the WhatsApp Business app
• Want to keep using the app alongside Kapso
• Have an established WhatsApp Business account with active messaging

Benefits:

• Keep using the Business app alongside Kapso
• Messages sync between app and API
• Preserve up to 6 months of chat history

Limitations:

• 5 messages per second throughput
• Some app features become unavailable

​

Option 2: Connect dedicated number

Choose this option if you:

• Want maximum messaging throughput (up to 1000 msg/sec)
• Need full API capabilities
• Don’t need to use the WhatsApp Business app

Benefits:

• High throughput messaging
• Full WhatsApp Business Platform features
• No app limitations

Limitations:

• Cannot use WhatsApp Business app with this number

​

Step 5: Complete the embedded signup

After selecting your connection type, you’ll see the embedded signup interface:

​

For WhatsApp Business app connection:

1. Make sure you have:

   • WhatsApp Business app version 2.24.17 or higher
   • Your phone with the app nearby
   • Active internet connection

2. Click Connect WhatsApp

3. A popup window will open with Meta’s embedded signup flow

4. Follow the prompts to:

   • Enter your WhatsApp Business phone number
   • Scan the QR code with your WhatsApp Business app
   • Choose whether to sync existing message history
   • Review and accept permissions

​

For dedicated number connection:

1. Make sure you have:

   • A Facebook Business account
   • A phone number not currently used with WhatsApp
   • Access to receive SMS for verification

2. Click Connect WhatsApp

3. Follow the Meta setup flow to:

   • Select or create a Meta Business account
   • Add your phone number
   • Verify via SMS
   • Configure your business profile

​

Step 6: Connection successful

Once the setup is complete, you’ll see a success message and be redirected to your WhatsApp configurations page.

Your new WhatsApp configuration will appear in the list with:

• Configuration name
• Connection status
• Phone number details
• Webhook status

​

Next steps

Now that your WhatsApp is connected, you can:

​

Troubleshooting

​

Facebook SDK not loading

If you see an error about the Facebook SDK not loading:

• Disable any ad blockers or privacy extensions
• Try using a different browser
• Ensure JavaScript is enabled

​

Connection fails after authorization

This can happen if:

• The phone number is already connected to another WhatsApp Business API account
• Your Facebook account doesn’t have the required permissions
• The WhatsApp Business app is outdated (for app connections)

​

Can’t see my WhatsApp configuration after setup

Try:

• Refreshing the page
• Checking if you’re in the correct project
• Verifying the connection completed successfully in Meta Business Manager