mcpField
K
kapso-api

kapso-api

github.com/gokapsoDevelopment19294 installsUpdated 3w ago
Repository

About kapso-api

A skill for Kapso Platform API operations, including customer onboarding, setup-link generation, phone-number provisioning, and WhatsApp connection detection. It is intended for developers integrating customer setup and phone provisioning into their workflows.

Key features

  1. 01Create customers and setup links
  2. 02Configure phone-number provisioning
  3. 03Detect WhatsApp connections through webhooks or redirects
  4. 04Use phone_number_id as the WhatsApp identifier

Use cases

  1. 01Onboard a customer to WhatsApp
  2. 02Generate a customer setup link
  3. 03Provision a phone number during signup
  4. 04Detect when a WhatsApp connection is established

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gokapso/agent-skills --skill kapso-api

After installing, type/kapso-apiin Claude Code to confirm it loaded.

Details

From the project README

Kapso Platform API

When to use

Use this skill for Platform API operations: creating customers, generating setup links, provisioning phone numbers, or detecting WhatsApp connections.

Setup

Base host: https://api.kapso.ai (scripts append /platform/v1)

Auth header:

X-API-Key: <api_key>

How to

Onboard a customer
  1. Create customer: POST /customers
  2. Generate setup link: POST /customers/:id/setup_links
  3. Customer completes embedded signup
  4. Use phone_number_id to send messages
Detect connection

Option A: Project webhook whatsapp.phone_number.created

Option B: Success redirect URL query params

Use both for best UX and backend reliability.

Provision phone numbers

When creating a setup link, set:

{
  "setup_link": {
    "provision_phone_number": true,
    "phone_number_country_isos": ["US"]
  }
}

Notes

  • Platform API base: /platform/v1
  • Meta proxy base: /meta/whatsapp/v24.0 (use for messaging and templates)
  • Use phone_number_id as the primary WhatsApp identifier

References

Related skills

  • kapso-automation - Workflow automation
  • whatsapp-messaging - WhatsApp messaging and templates
  • whatsapp-flows - WhatsApp Flows
  • kapso-ops - Operations and webhooks

Comments

Markdown supported