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

• 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