Troubleshoot WhatsApp in Kapso: debug message delivery, inspect webhook deliveries/retries, triage API errors, run health checks using CLI and Node scripts. Use for production issues, failures, webhook problems.
npx claudepluginhub joshuarweaver/cascade-communication --plugin gokapso-agent-skills-1This skill uses the workspace's default tool permissions.
Use this skill for operational diagnostics: message delivery investigation, webhook delivery debugging, error triage, and WhatsApp health checks.
assets/health-example.jsonassets/message-debugging-example.jsonassets/triage-example.jsonpackage.jsonreferences/health-reference.mdreferences/message-debugging-reference.mdreferences/triage-reference.mdscripts/api-logs.jsscripts/errors.jsscripts/lib/messages/args.jsscripts/lib/messages/kapso-api.jsscripts/lib/status/args.jsscripts/lib/status/kapso-api.jsscripts/lib/triage/args.jsscripts/lib/triage/kapso-api.jsscripts/lookup-conversation.jsscripts/message-details.jsscripts/messages.jsscripts/openapi-explore.mjsscripts/overview.jsCreates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.
Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Use this skill for operational diagnostics: message delivery investigation, webhook delivery debugging, error triage, and WhatsApp health checks.
Preferred path:
kapso login)kapso status to confirm project access and available WhatsApp numbersFallback path: Env vars:
KAPSO_API_BASE_URL (host only, no /platform/v1)KAPSO_API_KEYPreferred path:
kapso whatsapp numbers resolve --phone-number "<display-number>" --output jsonkapso whatsapp messages list --phone-number "<display-number>" --limit 50 --output jsonkapso whatsapp messages get <message-id> --phone-number-id <id> --output jsonkapso whatsapp conversations list --phone-number "<display-number>" --output jsonFallback path:
node scripts/messages.js --phone-number-id <id>node scripts/message-details.js --message-id <id>node scripts/lookup-conversation.js --phone-number <e164>Preferred path:
kapso statuskapso whatsapp numbers health --phone-number "<display-number>" --output humankapso whatsapp templates list --phone-number "<display-number>" --output jsonFallback path:
node scripts/errors.jsnode scripts/api-logs.jsnode scripts/webhook-deliveries.jsPreferred path:
kapso statuskapso whatsapp numbers health --phone-number "<display-number>" --output humanFallback path:
node scripts/overview.jsnode scripts/whatsapp-health.js --phone-number-id <id>| Script | Purpose |
|---|---|
messages.js | List messages |
message-details.js | Get message details |
lookup-conversation.js | Find conversation by phone or ID |
| Script | Purpose |
|---|---|
errors.js | List message errors |
api-logs.js | List external API logs |
webhook-deliveries.js | List webhook delivery attempts |
| Script | Purpose |
|---|---|
overview.js | Project overview |
whatsapp-health.js | Phone number health check |
| Script | Purpose |
|---|---|
openapi-explore.mjs | Explore OpenAPI (search/op/schema/where) |
Install deps (once):
npm i
Examples:
node scripts/openapi-explore.mjs --spec platform search "webhook deliveries"
node scripts/openapi-explore.mjs --spec platform op listWebhookDeliveries
node scripts/openapi-explore.mjs --spec platform schema WebhookDelivery
integrate-whatsapp.phone_number_id before deep debugging.integrate-whatsapp - Onboarding, webhooks, messaging, templates, flowsautomate-whatsapp - Workflows, agents, and automations[observe-whatsapp file map]|root: .
|.:{package.json,SKILL.md}
|assets:{health-example.json,message-debugging-example.json,triage-example.json}
|references:{health-reference.md,message-debugging-reference.md,triage-reference.md}
|scripts:{api-logs.js,errors.js,lookup-conversation.js,message-details.js,messages.js,openapi-explore.mjs,overview.js,webhook-deliveries.js,whatsapp-health.js}
|scripts/lib/messages:{args.js,kapso-api.js}
|scripts/lib/status:{args.js,kapso-api.js}
|scripts/lib/triage:{args.js,kapso-api.js}