Onboard customers

Kapso Platform lets your customers connect their own WhatsApp Business accounts without sharing credentials. Each customer uses their own number while you handle the automation.

Quick example

// 1. Create customer
const customer = await createCustomer({ name: 'Acme Corp' });

// 2. Setup link
const setupLink = await generateSetupLink(customer.id);
console.log(`Setup link: ${setupLink.url}`);

// 3. Send message
await sendWhatsAppMessage({
  customer_id: customer.id,
  phone_number: '+1234567890',
  content: 'Order confirmed!'
});

Use cases

Perfect when you need your customers to use their own WhatsApp:

CRM platforms - Let each client connect their WhatsApp for customer communication
Appointment booking - Clinics and salons send reminders from their own number
E-commerce tools - Stores send order updates using their WhatsApp Business
Marketing platforms - Agencies manage multiple client WhatsApp accounts
Support software - Each company provides support through their WhatsApp

Step 1: Create a customer

curl -X POST https://api.kapso.ai/platform/v1/customers \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": {
      "name": "Acme Corporation",
      "external_customer_id": "CUS-12345"
    }
  }'

Response:

{
  "data": {
    "id": "customer-abc123",
    "name": "Acme Corporation",
    "external_customer_id": "CUS-12345"
  }
}

Step 2: Generate setup link

curl -X POST https://api.kapso.ai/platform/v1/customers/customer-abc123/setup_links \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"setup_link":{"meta_billing_mode":"partner_managed"}}'

Response:

{
  "data": {
    "id": "link-xyz789",
    "url": "https://app.kapso.ai/whatsapp/setup/aBcD123...",
    "expires_at": "2024-03-15T10:00:00Z"
  }
}

Share the url with your customer. They’ll click it, log in with Facebook, and connect their WhatsApp in ~5 minutes.

Step 3: Send messages

After setup completes, use the customer’s phone_number_id to send messages:

curl -X POST https://api.kapso.ai/meta/whatsapp/v24.0/110987654321/messages \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "15551234567",
    "type": "text",
    "text": {
      "body": "Your order has been shipped!"
    }
  }'

JavaScript example

const KAPSO_API_KEY = 'YOUR_API_KEY';
const PLATFORM_API_URL = 'https://api.kapso.ai/platform/v1';
const WHATSAPP_API_URL = 'https://api.kapso.ai/meta/whatsapp';

async function onboardCustomer(customerData) {
  // 1. Create customer
  const customer = await fetch(`${PLATFORM_API_URL}/customers`, {
    method: 'POST',
    headers: {
      'X-API-Key': KAPSO_API_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ customer: customerData })
  }).then(r => r.json());

  // 2. Generate setup link
  const setupLink = await fetch(
    `${PLATFORM_API_URL}/customers/${customer.data.id}/setup_links`,
    {
      method: 'POST',
      headers: {
        'X-API-Key': KAPSO_API_KEY,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        setup_link: { meta_billing_mode: 'partner_managed' }
      })
    }
  ).then(r => r.json());

  return setupLink.data.url;
}

async function sendMessage(phoneNumberId, recipientPhone, message) {
  return fetch(`${WHATSAPP_API_URL}/v24.0/${phoneNumberId}/messages`, {
    method: 'POST',
    headers: {
      'X-API-Key': KAPSO_API_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      messaging_product: 'whatsapp',
      to: recipientPhone,
      type: 'text',
      text: { body: message }
    })
  });
}

What customers see

Click your setup link
Log in with Facebook
Connect their WhatsApp Business
Verify phone number
Done - you can now send messages

The entire process takes ~5 minutes.

Coding with AI agents

To build your platform integration faster, add Kapso skills to your AI coding assistant:

npx skills add gokapso/agent-skills

For documentation context, pass docs.kapso.ai/llms.txt or connect via MCP:

{ "mcpServers": { "kapso-docs": { "url": "https://docs.kapso.ai/mcp" } } }

claude mcp add --transport http kapso-docs https://docs.kapso.ai/mcp

codex mcp add kapso-docs --url https://docs.kapso.ai/mcp

{ "servers": { "kapso-docs": { "type": "http", "url": "https://docs.kapso.ai/mcp" } } }

Next steps

Setup links - Customize redirect URLs, branding, connection types
Connection detection - Know when customers connect
Webhooks - Handle real-time message events

Getting started

WhatsApp

For your team

Automations

Onboard customers

Quick example

Use cases

Step 1: Create a customer

Step 2: Generate setup link

Step 3: Send messages

JavaScript example

What customers see

Coding with AI agents

Next steps

​Quick example

​Use cases

​Step 1: Create a customer

​Step 2: Generate setup link

​Step 3: Send messages

​JavaScript example

​What customers see

​Coding with AI agents

​Next steps

Quick example

Use cases

Step 1: Create a customer

Step 2: Generate setup link

Step 3: Send messages

JavaScript example

What customers see

Coding with AI agents

Next steps