← Back to tools
View AGENTS.md for kapso
kapso
Manage WhatsApp numbers, messages, templates, and webhooks from the terminal
Description
The official Kapso CLI for managing WhatsApp integrations from the terminal. Send messages, manage phone numbers, templates, conversations, and webhooks without the browser. Supports interactive login and API key auth for CI/CD pipelines. JSON and human-readable output formats for scripting with tools like jq.
Install
npm
npm install -g @kapso/cliAI Summary
Official Kapso CLI — manage WhatsApp numbers, send messages, handle templates, conversations, and webhooks from the terminal with JSON or human-readable output.
Capabilities
- + Send WhatsApp text and media messages from the terminal
- + Manage WhatsApp phone number connections and health checks
- + Create and list message templates
- + View and filter conversations
- + Register and manage webhooks for 9 event types
- + Multi-project support with project switching
- + JSON output for scripting and CI/CD pipelines
- + Interactive login or API key authentication
Use When
- → You need to send WhatsApp messages from the terminal or scripts
- → You want to manage WhatsApp templates and webhooks without the dashboard
- → You need WhatsApp messaging in CI/CD pipelines
Avoid When
- x You don't have a Kapso account
- x You need SMS or non-WhatsApp messaging
Usage Patterns
Send a text message
kapso messages send --phone-number +1234567890 --to +0987654321 --text 'Hello!'Send a WhatsApp text message
List conversations
kapso conversations list --output jsonList recent conversations in JSON format
List templates
kapso templates listView all message templates
Register a webhook
kapso webhooks create --url https://example.com/hook --events message.receivedSet up a webhook for incoming messages
Input / Output
stdout: Messages, conversation data, template info — JSON or human-readable
Typical Pipelines
kapso messages list --output json | jq '.[] | select(.status=="delivered")'kapso conversations list --output json | jq '.[0].id'