llms.txt
Compare with other sites' llms.txt files →# Kapso
> Kapso is the WhatsApp API for developers. It runs on the official Meta WhatsApp Business Platform and adds what Meta leaves to you: onboarding for customer-owned WhatsApp numbers, webhooks with delivery logs, an inbox with human handoff, workflows, WhatsApp Flows, and tooling for AI agents.
## When to use Kapso
Reach for Kapso when the job is one of these:
- Add official WhatsApp messaging to a product: send text, media, templates, buttons, lists, and Flows, and receive replies by webhook.
- Let each of your customers connect their own WhatsApp Business number to your product through a connection link, then message on their behalf.
- Give an AI agent a WhatsApp number so it can read and reply to conversations, with handoff to a human inbox.
- Build or debug webhooks: inspect deliveries, retries, and failed messages.
- Manage templates, phone numbers, contacts, and conversations from a terminal or an MCP client.
Do not use Kapso for:
- WhatsApp automation over a personal account.
- WhatsApp Groups. The Groups API is waitlist only: https://kapso.com/whatsapp-groups
- SMS, email, or channels other than WhatsApp.
## How to call Kapso
A human creates the Kapso project first. Browser sign-in works for any project member on MCP and the CLI. A project API key is only needed for REST and for non-interactive MCP or CLI use.
After that:
- Project MCP (no shell needed): endpoint `https://api.kapso.ai/mcp`. Auth with browser sign-in or `Authorization: Bearer <project_api_key>`.
- OAuth for MCP clients (discovery, PKCE, scopes, refresh, revocation): https://kapso.com/auth.md
- CLI (shell access): `curl -fsSL https://kapso.com/install.sh | bash`, then `kapso setup`.
- REST: host `https://api.kapso.ai`, header `X-API-Key: <project_api_key>`. OpenAPI specs are listed below.
- TypeScript: `npm install @kapso/whatsapp-cloud-api`.
- Coding agents editing a codebase: `npx skills add gokapso/agent-skills`.
- Agent instructions: https://kapso.com/AGENTS.md
## Docs
- [Docs index](https://docs.kapso.ai/llms.txt): every docs page as a link. Each page also serves markdown at its URL plus `.md`.
- [Build with AI](https://docs.kapso.ai/docs/build-with-ai.md): CLI, Project MCP, docs MCP, and agent skills in one page.
- [Project MCP](https://docs.kapso.ai/docs/whatsapp/mcp.md): tools, auth, and client setup.
- [CLI](https://docs.kapso.ai/docs/whatsapp/cli.md): command reference.
- [TypeScript SDK](https://docs.kapso.ai/docs/whatsapp/typescript-sdk/introduction.md): quickstart.
- [Send messages](https://docs.kapso.ai/docs/whatsapp/send-messages/text.md): text, media, templates, interactive.
- [Webhooks](https://docs.kapso.ai/docs/platform/webhooks/overview.md): receive messages and events.
- [Customer onboarding](https://docs.kapso.ai/docs/platform/customer-guide.md): setup links for customer-owned numbers.
- [WhatsApp Flows](https://docs.kapso.ai/docs/whatsapp/flows/overview.md): forms and data endpoints.
- [WhatsApp API OpenAPI](https://docs.kapso.ai/api/meta/whatsapp/openapi-whatsapp.yaml)
- [Platform API OpenAPI](https://docs.kapso.ai/api/platform/v1/openapi-platform.yaml)
- [Workflows API OpenAPI](https://docs.kapso.ai/api/platform/v1/openapi-workflows.yaml)
- [WhatsApp API OpenAPI (JSON)](https://kapso.com/openapi.json)
- [Platform API OpenAPI (JSON)](https://kapso.com/openapi/platform.json)
- [Workflows API OpenAPI (JSON)](https://kapso.com/openapi/workflows.json)
## Product
- [Pricing](https://kapso.com/pricing.md): Free, Pro, and Platform plans. Every plan includes a sandbox number.
- [WhatsApp API pricing calculator](https://kapso.com/whatsapp-api-pricing-calculator): estimate Meta fees by recipient market and message category.
- [Platform](https://kapso.com/platform): customer-owned onboarding, connection links, APIs, webhooks, and inbox workflows.
- [WhatsApp API sandbox](https://kapso.com/whatsapp-api-sandbox): free test number on every plan; send real WhatsApp messages from your own phone with no Meta verification, then connect agents, Flows, webhooks, or the API.
- [WhatsApp API for developers](https://kapso.com/whatsapp-api-for-developers)
- [WhatsApp Cloud API guide](https://kapso.com/whatsapp-cloud-api): setup, sending messages, webhooks, templates, and Meta pricing, with curl and Node.js examples.
- [WhatsApp Flows for developers](https://kapso.com/whatsapp-flows): interactive forms, bookings, Flow JSON, publishing, and dynamic data endpoints.
- [WhatsApp AI agent](https://kapso.com/whatsapp-ai-agent)
- [Connect customer WhatsApp](https://kapso.com/connect-customer-whatsapp)
- [WhatsApp webhooks](https://kapso.com/whatsapp-webhooks)
- [WhatsApp Slack integration](https://kapso.com/whatsapp-slack-integration): Run Kapso Agent sessions for internal project operations from Slack. Customer support replies use the Kapso inbox.
- [WhatsApp human handoff](https://kapso.com/whatsapp-human-handoff)
- [WhatsApp MCP server](https://kapso.com/whatsapp-mcp-server)
- [WhatsApp CLI](https://kapso.com/whatsapp-cli)
- [YCloud alternative for WhatsApp](https://kapso.com/ycloud-alternative-for-whatsapp)
- [Zernio alternative for WhatsApp](https://kapso.com/zernio-alternative-for-whatsapp)
- [360dialog alternative for WhatsApp](https://kapso.com/360dialog-alternative-for-whatsapp)
- [WATI alternative for WhatsApp](https://kapso.com/wati-alternative-for-whatsapp)
- [Twilio alternative for WhatsApp](https://kapso.com/twilio-alternative-for-whatsapp)
## Guides
Free written guides on how the WhatsApp Business Platform behaves. Each chapter is its own page.
- [All guides](https://kapso.com/guides)
- [WhatsApp Pricing](https://kapso.com/guides/whatsapp-pricing): What WhatsApp messaging actually costs: how Meta assigns a price to every message, how billing evidence arrives after delivery, and what changes when service messages and utility replies become billable on October 1, 2026.
- [Business-scoped user IDs](https://kapso.com/guides/business-scoped-user-ids): Meta is replacing the phone number as the identity key on the WhatsApp Business Platform. The new identifiers have been arriving in your webhooks since April 2026, and the phone number is only now starting to disappear. This guide covers the whole migration: how to read, store, match and message a business-scoped user ID.
## Canonical facts
- Kapso uses the official Meta WhatsApp Business Platform (Cloud API). It is not an unofficial WhatsApp client.
- Every plan includes a sandbox number for testing without production credentials.
- Plans: Free, Pro, and Platform. Current prices, message volumes, and number limits are on the pricing page.
- Meta's WhatsApp message pricing changes on October 1, 2026. See the WhatsApp pricing guide.
- Kapso supports messages, templates, webhooks, contacts, conversations, customers, customer connection links, phone numbers, broadcasts, workflows, serverless functions, and WhatsApp Flows.
- Treat project API keys, webhook secrets, and production WhatsApp sends as application-controlled credentials and actions. Prefer sandbox numbers and development projects for tests.
## Optional
- [About](https://kapso.com/about), [Contact](https://kapso.com/contact), [Trust & legal](https://kapso.com/trust), [Blog](https://kapso.com/blog)
- Tool pages: [Codex](https://kapso.com/whatsapp-codex), [Claude Code](https://kapso.com/whatsapp-claude-code), [OpenClaw](https://kapso.com/whatsapp-openclaw), [Hermes Agent](https://kapso.com/whatsapp-hermes-agent), [Grok Bot](https://kapso.com/whatsapp-grok-bot), [OpenAI Dots](https://kapso.com/whatsapp-dots), [Chat SDK](https://kapso.com/whatsapp-chat-sdk), [Agent skills](https://kapso.com/whatsapp-agent-skills), [Kapso Agent](https://kapso.com/kapso-agent), [API logs](https://kapso.com/whatsapp-api-logs), [Inbox](https://kapso.com/whatsapp-inbox), [Workflows](https://kapso.com/whatsapp-workflows), [Functions](https://kapso.com/whatsapp-functions), [Broadcasts](https://kapso.com/whatsapp-broadcasts)
- Tool docs: [Chat SDK](https://docs.kapso.ai/docs/whatsapp/chat-sdk.md), [OpenClaw](https://docs.kapso.ai/docs/whatsapp/openclaw.md), [Hermes Agent](https://docs.kapso.ai/docs/whatsapp/hermes-agent.md)
- Spanish: [API de WhatsApp para desarrolladores](https://kapso.com/es/api-whatsapp-para-desarrolladores), [Agentes de IA para WhatsApp](https://kapso.com/es/agentes-ia-whatsapp), [Alternativa a Twilio para WhatsApp](https://kapso.com/es/alternativa-twilio-whatsapp)
- [Full index](https://kapso.com/llms-full.txt), [Markdown sitemap](https://kapso.com/sitemap.md)