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
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
You Might Also Like
Related Skills
fix
Use when you have lint errors, formatting issues, or before committing code to ensure it passes CI.
facebook
frontend-testing
Generate Vitest + React Testing Library tests for Dify frontend components, hooks, and utilities. Triggers on testing, spec files, coverage, Vitest, RTL, unit tests, integration tests, or write/review test requests.
langgeniusfrontend-code-review
Trigger when the user requests a review of frontend files (e.g., `.tsx`, `.ts`, `.js`). Support both pending-change reviews and focused file reviews while applying the checklist rules.
langgenius
code-reviewer
Use this skill to review code. It supports both local changes (staged or working tree) and remote Pull Requests (by ID or URL). It focuses on correctness, maintainability, and adherence to project standards.
google-gemini
session-logs
Search and analyze your own session logs (older/parent conversations) using jq.
moltbot