kapso-ops

Name: kapso-ops
Author: gokapso

github.com/gokapsoCloud & DevOps19287 installsUpdated 3w ago

About kapso-ops

A Kapso operations skill for diagnosing webhook, WhatsApp message delivery, and API issues. It provides scripts for setup, investigation, error triage, and phone-number health checks.

Key features

01Webhook setup and testing
02Message and conversation lookup
03Error and API log inspection
04Webhook delivery tracking
05Project and number health checks

Use cases

01Configure and test a webhook
02Investigate a message that was not delivered
03Review API errors and webhook attempts
04Check WhatsApp phone-number health

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gokapso/agent-skills --skill kapso-ops

After installing, type/kapso-opsin Claude Code to confirm it loaded.

Details

From the project README

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

Comments

Markdown supported

Details

Author: gokapso
Repository: gokapso/agent-skills
Category: Cloud & DevOps
Installs: 87
GitHub stars: 192

Report

More skills

All skills

lark-apps

open.feishu.cn

732.0k

Develop and host Miaoda (Spark/Miaoda) apps: app creation, local full-stack development, cloud generation and iteration, creative design (UI mockups / interactive prototypes / wireframes / landing pages / dashboards / slide decks / visual exploration), integration of AI-related capabilities, Feishu platform capabilities, or other external capabilities; log/Trace/monitoring metric/PV/UV queries; environment variable management; app collaborators and collaboration permissions; app roles and members; and automation triggers (scheduled / record changes / Webhook / Feishu approvals). Use when users want to develop or create a system, tool, platform, or app; develop locally or in the cloud, modify, deploy, publish, launch, or get a shareable link; create a page or website with HTML and deploy it to Miaoda; design, create a mockup, prototype, wireframe, PPT, deck, or visual exploration; or mention Miaoda/Spark/Miaoda apps (links like `/app/app_xxx` or `/page/<token>`, runtime domains like *.aiforce.cloud), app databases, app file storage, open API Keys, visibility, app collaborators/developer permissions, app roles/role members, production logs, API request volume, error volume, latency, traffic, environment variables, or setting up automation tasks, scheduled triggers, or approval-triggered automation for Miaoda apps. Not for regular cloud drive file uploads (lark-drive), Feishu document editing (lark-doc), or native slide creation (lark-slides).

azure-prepare

github.com/microsoft

571.7k

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

wizard

github.com/mattpocock

571.5k

Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.

azure-ai

github.com/microsoft

571.2k

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.