kapso-ops
80
总安装量
80
周安装量
#2804
全站排名
安装命令
npx skills add https://github.com/gokapso/agent-skills --skill kapso-ops
Agent 安装分布
claude-code
70
cursor
51
antigravity
47
gemini-cli
47
opencode
43
codex
41
Skill 文档
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
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