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. Open the WhatsApp menu, then add a new number.
3. Complete the number verification steps.
4. When asked to choose a connection mode, pick one of the options below.

Coexistence or Dedicated?

• Coexistence — your WhatsApp Business app keeps working side by side. Good for trying things out first. Sending is capped at about 5 messages per second, and the connection can drop on its own sometimes.
• Dedicated — a more stable connection, without the coexistence cap. The number can no longer open in the WhatsApp Business app after this.

Start with coexistence while you are still testing with a spare number. Move to dedicated once you are ready to run it for your business.

Create an API Key on Kapso

1. In the Kapso dashboard, open Integrations > API keys.
2. Create a new key, then copy its value.
3. 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 Integrations > Partner Integrations.
3. Click + Add Integration, then choose Kapso.
4. Paste your Kapso API key.
5. Konektor looks up the numbers available in your Kapso account and lists them for you to choose from.

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 Save 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.

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.
• 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