Kapso Ops
When to use
Use this skill for operational diagnostics: webhook setup, message delivery investigation, error triage, and WhatsApp health checks.
Setup
Env vars:
- •
KAPSO_API_BASE_URL(host only, no/platform/v1) - •
KAPSO_API_KEY
How to
Set up a webhook
- •Create:
node scripts/create.js --phone-number-id <id> --url <https://...> --events <csv> - •Verify signature handling (see
references/webhooks-overview.md) - •Test:
node scripts/test.js --webhook-id <id>
Investigate message delivery
- •List messages:
node scripts/messages.js --phone-number-id <id> - •Inspect message:
node scripts/message-details.js --message-id <id> - •Find conversation:
node scripts/lookup-conversation.js --phone-number <e164>
Triage errors
- •Message errors:
node scripts/errors.js - •API logs:
node scripts/api-logs.js - •Webhook deliveries:
node scripts/webhook-deliveries.js
Run health checks
- •Project overview:
node scripts/overview.js - •Phone number health:
node scripts/whatsapp-health.js --phone-number-id <id>
Scripts
Webhooks
| Script | Purpose |
|---|---|
list.js | List webhooks for a phone number |
get.js | Get webhook details |
create.js | Create a webhook |
update.js | Update a webhook |
delete.js | Delete a webhook |
test.js | Send a test event to a webhook |
Common flags for create/update:
- •
--url <https://...>- Webhook URL - •
--events <csv>- Event types (comma-separated) - •
--kind <kapso|meta>- Webhook type - •
--payload-version <v1|v2>- Payload format (v2 recommended) - •
--buffer-enabled <true|false>- Enable buffering - •
--active <true|false>- Enable/disable
Messages
| Script | Purpose |
|---|---|
messages.js | List messages |
message-details.js | Get message details |
lookup-conversation.js | Find conversation by phone or ID |
Errors and logs
| Script | Purpose |
|---|---|
errors.js | List message errors |
api-logs.js | List external API logs |
webhook-deliveries.js | List webhook delivery attempts |
Health
| Script | Purpose |
|---|---|
overview.js | Project overview |
whatsapp-health.js | Phone number health check |
Notes
- •Use config-level webhooks for
whatsapp.message.*events - •Payload version
v2is recommended for new integrations - •Meta webhooks provide raw payloads; Kapso webhooks support buffering
References
- •references/webhooks-reference.md - Webhook API reference
- •references/webhooks-overview.md - Webhook concepts and setup
- •references/webhooks-event-types.md - Available event types
- •references/message-debugging-reference.md - Message debugging guide
- •references/triage-reference.md - Error triage guide
- •references/health-reference.md - Health check guide
Related skills
- •
kapso-automation- Automation and functions - •
whatsapp-messaging- WhatsApp messaging - •
kapso-api- Platform API and customers