majiayu000 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
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 functionswhatsapp-messaging- WhatsApp messagingkapso-api- Platform API and customers