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
v2 is recommended for new integrations - Meta webhooks provide raw payloads; Kapso webhooks support buffering
References
Related skills
kapso-automation - Automation and functionswhatsapp-messaging - WhatsApp messagingkapso-api - Platform API and customers