kapso-ops

by @gokapso in AI & LLM

# Install this skill:

npx skills add gokapso/agent-skills --skill "kapso-ops"

Install specific skill from multi-skill repository

# 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.

# SKILL.md

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_KEY
- PROJECT_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

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

kapso-automation - Automation and functions
whatsapp-messaging - WhatsApp messaging
kapso-api - Platform API and customers

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.