Kapso WhatsApp Integration

Connect your official WhatsApp number on Kapso to Konektor. Once connected, incoming messages are saved automatically as Leads and appear in your Inbox, and you can send outbound messages (text & template) directly from Konektor.

About Kapso

Kapso is an official WhatsApp connection provider (Cloud API). You sign up and pay Kapso directly, not through Konektor. Konektor only needs one API key from your Kapso account.

The number of WhatsApp numbers you can connect follows your Kapso plan, not your Konektor plan:

Prerequisites

Before you start, prepare:

1. An active Kapso account.
2. One WhatsApp number to connect (a new number, or a number that already has WhatsApp Business).
3. Access to Konektor as the Owner or Admin of your workspace.

Connect a Number on Kapso

1. Sign in to the Kapso dashboard.
2. Click Phone numbers, then Add phone number.
3. Choose one of the three ways below.

Way 1: US digital number (fastest)

Kapso gives you a US number that is already verified. You need no SIM card and no verification code.

1. Choose Instant setup with US digital number.
2. Tick the confirmation box, then click Get and set up phone number.
   
3. A Facebook window opens. Click Continue.
   
4. Under Phone number, pick a number labeled Verified, then click Next.
   
5. Choose your Business portfolio. Under WhatsApp Business account, choose Create a WhatsApp Business account, then click Next.
   
6. Enter your business name in Name, choose a Category, then click Next.
   
7. Review the requested access, then click Confirm.
   
8. The Meta window shows Your account is connected to Kapso. Clear the box Instruct Meta to automatically identify order and lead events, because Konektor already sends its own conversion events. Then click Finish.
   
9. Back on Kapso, choose how to pay Meta's fees. Use Kapso credits is the simplest.
   
10. Kapso shows the Build with this number page. Your number is live.
    

From 1 October 2026, Meta charges replies within 24 hours after 1,000 free messages per number per month. The Kapso Free plan gives one US digital number; a second number needs the Pro plan.

Way 2: Your own SIM card

Use your own number that is not registered in any WhatsApp app.

1. Choose Connect my own SIM card.
2. Follow the Facebook window as in Way 1, but choose Enter a new phone number.
3. Enter your number, then enter the code sent by SMS or call.

If the number is still installed in a WhatsApp app, delete that WhatsApp account from the phone first.

Way 3: An existing WhatsApp Business number (coexistence)

Use a number that is already live in the WhatsApp Business app. The phone app keeps working, and your chat history syncs.

1. Choose Connect WhatsApp Business App.
2. Follow the Facebook window, then scan the QR code from the WhatsApp Business app on your phone.

This mode is capped at about 5 messages per second, and the connection sometimes drops on its own. Kapso labels it Unstable. Choose Way 1 or Way 2 for high volume.

If you see "WhatsApp Business account is currently restricted"

Meta restricts the business portfolio you chose. Click Back, then choose another business portfolio. Check that portfolio in Business Support Home.

If you see "To use this phone number, you'll need to delete an existing one"

Your business portfolio has reached its number limit. A portfolio that is not verified can hold only a few numbers. Choose another business portfolio that is verified, or delete an old number in WhatsApp Manager.

Create an API Key on Kapso

1. In the Kapso dashboard, open Integrate > API keys.
2. Click Create API key, give it a name (for example Konektor), then click Create key.
   
3. Click the copy icon next to the key. Kapso shows it only once.
   
4. Keep this key safe. It works for every number in your Kapso account, so never share it with anyone you do not trust.

Add the API Key to Konektor

1. Sign in to Konektor as the Owner or Admin of your workspace.
2. Open WhatsApp > Connect WhatsApp, then click Connect with Kapso on the Official WhatsApp Business card.
   
3. The Add Partner Integration form opens with Kapso already selected. Another way: open Integrations > Partner Integrations, click + Add Integration, then choose Kapso.
4. Paste your Kapso API key into API Key.
   
5. Konektor looks up the numbers in your Kapso account at once. When there is only one, Konektor picks it and fills in Integration Name for you.
   
6. Click Connect. The new integration card shows Connected.
   

You do not need to create a webhook on Kapso. Konektor registers the webhook for that number automatically, with its signing key. On Kapso, open Integrate > Webhooks to see it marked Active.

Choose a Number

• Choose a number that is not already connected to another Kapso integration.
• A number already used by another active Kapso integration in this workspace is shown, but cannot be selected.
• If the number list does not appear, enter the WhatsApp Number manually using the number ID from Kapso.
• Click Connect to finish.

Messages Reach Your Inbox Automatically

Once the integration is active, WhatsApp messages sent to that number appear automatically in your Inbox, alongside your other WhatsApp channels. No extra step is needed.

When you open a conversation, the customer sees blue ticks. When you type a reply, the customer sees that you are typing.

Test Sending and Receiving

1. Send a WhatsApp message from a personal number to the newly connected Kapso number.
2. Open your Inbox and confirm the message appears as a new conversation.
3. Reply to that message from the Inbox.
4. Confirm your reply arrives on WhatsApp, and its status moves from sent to delivered, then read.
   

Add a Second Number

1. Create another Kapso integration in Konektor using the same API key (see Add the API Key to Konektor above).
2. Choose a different number that is not yet connected.

The number limit follows your Kapso plan (see the table above). Upgrade your Kapso plan first if you have reached the limit.

Common Failures

• API key rejected — check that you copied the whole key and that it has not been revoked in the Kapso dashboard. Create a new key if needed.
• No numbers appear in the list — make sure number verification finished on Kapso. Use manual entry as a fallback.
• A number cannot be selected — that number is already connected to another active Kapso integration in this workspace. Choose a different number, or remove the older integration first.
• The webhook stops receiving messages — Kapso pauses a webhook that fails too often. Open Integrate > Webhooks on Kapso and turn it back on, or remove the integration in Konektor and connect again.
• Messages fail to send — check that the number connection mode is still active in the Kapso dashboard. Coexistence mode can drop on its own; switch to dedicated if this keeps happening.
• Replies arrive slowly — a number in coexistence mode is capped at about 5 messages per second. Wait a moment, or switch to dedicated for higher volume.

Next Steps

• WhatsApp Inbox
• Konektor Partner Integrations