# kapso
> Manage WhatsApp numbers, messages, templates, and webhooks from the terminal

## 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

## When to Use
- 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

## When NOT to Use
- You don't have a Kapso account
- You need SMS or non-WhatsApp messaging

## Key Flags
- `--output json`: Output in JSON format for scripting
- `--output human`: Human-readable output
- `--phone-number`: Specify phone number for operations

## 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 json
```
List recent conversations in JSON format

### List templates
```
kapso templates list
```
View all message templates

### Register a webhook
```
kapso webhooks create --url https://example.com/hook --events message.received
```
Set up a webhook for incoming messages

## Input / Output
- **stdout**: Messages, conversation data, template info — JSON or human-readable

## Installation
- **npm**: `npm install -g @kapso/cli`

## Related Tools
- [resend-cli](/tools/resend-cli) (complementary): Email sending CLI — different channel, similar workflow

---
Source: https://littlescripts.sh/tools/kapso-cli