Agent skill · operations · gokapso
observe-whatsapp
Observe and troubleshoot WhatsApp in Kapso: search Logs across API, Meta webhook, workflow, and webhook-delivery events; debug message delivery; inspect webhook retries; triage API errors; and run health checks. Use when investigating production issues, message failures, workflow behavior, or webhook delivery problems.
Why this skill is useful
Provides specific commands and workflows for troubleshooting WhatsApp issues that the AI wouldn't reliably generate on its own.
What it needs
Requires kapso installed locally. About 3k tokens when loaded. Last updated 2026-08-02. 146 stars on the source repository.
What this skill does
Observe WhatsApp When to use Use this skill for operational diagnostics: Logs search, message delivery investigation, webhook delivery debugging, error triage, workflow event correlation, and WhatsApp health checks. Setup Preferred path: Kapso CLI installed and authenticated (kapso login) Start with kapso status to confirm project access and available WhatsApp numbers Fallback path: Env vars: KAPSOAPIBASEURL (host only, no /platform/v1) KAPSOAPIKEY How to Search logs Use Logs search first when the user gives an identifier, endpoint, message ID, workflow execution ID, webhook delivery ID, request ID, or a vague "what happened?" debugging prompt. Preferred path: 1. Search the current project: kapso logs search --query "<id-or-text>" --period 24h --source all --limit 20 --output json 2. If the exact search is empty, retry with --period 7d before concluding there are no logs. 3. Add --problems-only for broad error scans; leave it off when reconstructing an exact timeline. 4. Add explicit filters only when they intentionally narrow the search: Workflow execution: kapso logs search --query "<execution-id>" --source flowevent --filter flowexecutionid=<execution-id> --period 7d --output json API endpoint/status: kapso logs search --source externalapilog --filter endpointcontains=/messages --filter responsestatus=500 --period 24h --output json WhatsApp message ID: kapso logs search --query "wamid..." --source whatsappwebhookevent --filter whatsappmessageid=wamid... --period 7d --output json Webhook delivery: kapso logs search --source webhookdelivery --filter webhookid=<webhook-id> --period 24h --output json Fallback path: 1. Search via Platform API: node scripts/log-search.js --query "<id-or-text>" --period 24h --source all --limit 20 2. Use filters with repeated flags: node scripts/log-search.js --source flowevent --filter flowexecutionid=<execution-id> --period 7d 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills gokapso/observe-whatsapp