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
PROJECT_ID
How to
Set up a webhook
Create: node scripts/create.js --phone-number-id --url https://... --events
Verify signature handling (see references/webhooks-overview.md)
Test: node scripts/test.js --webhook-id
Investigate message delivery
List messages: node scripts/messages.js --phone-number-id
Inspect message: node scripts/message-details.js --message-id
Find conversation: node scripts/lookup-conversation.js --phone-number
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
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 - Event types (comma-separated)
--kind - Webhook type
--payload-version - Payload format (v2 recommended)
--buffer-enabled - Enable buffering
--active - 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
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