- name
- kapso-ops
- description
- Operate and troubleshoot Kapso projects. Manage webhooks, debug message delivery, inspect API errors, and run health checks. Use when diagnosing issues, setting up webhooks, or investigating message failures.
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_KEYPROJECT_ID
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