observe-whatsapp — Claude Code skill for WhatsApp diagnostics
Investigate WhatsApp issues in Kapso, from failed message delivery to API and webhook errors. Useful for tracing events and checking phone number health.
npx skills add gokapso/agent-skills --skill observe-whatsapp -a claude-codeWhat observe-whatsapp does
This skill guides an agent through WhatsApp troubleshooting in Kapso. It searches logs from API calls, Meta webhooks, workflows, and webhook delivery, helping connect events to messages and errors. For a message investigation, it can resolve a display number to a phone_number_id, list messages, and inspect a message or conversation.
The main route uses the Kapso CLI. After kapso login, run kapso status to check project access and available numbers. Node.js scripts provide a fallback for log searches, message details, errors, and health checks; install their dependencies with npm i. The Platform API log fallback depends on Logs and Elasticsearch being enabled, so that route will fail without them.
Webhook creation and configuration belong to integrate-whatsapp; event and workflow setup belong to automate-whatsapp. This skill focuses on operational investigation rather than setup.
What it helps with
- trace log events related to a message
- inspect webhook delivery attempts
- triage API and message errors
- check project and WhatsApp number health
Example prompts for the agent
- Find the Kapso log events related to message
wamid.... - Inspect delivery attempts for webhook
<webhook-id>. - Check this WhatsApp number's health and look for recent errors.
How to install observe-whatsapp
1Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill observe-whatsapp -a claude-code2Manually: put the files in place
~/.claude/skills/observe-whatsapp/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/observe-whatsapp/
1Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill observe-whatsapp -a codex2Manually: put the files in place
.agents/skills/observe-whatsapp/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill observe-whatsapp -a cursor2Manually: put the files in place
.cursor/skills/observe-whatsapp/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gokapso/agent-skills observe-whatsapp2Manually: put the files in place
.github/skills/observe-whatsapp/SKILL.md1Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill observe-whatsapp -a gemini-cli2Platform CLI
gemini skills install https://github.com/gokapso/agent-skills --path skills/observe-whatsappManually: put the files in place
.devin/skills/observe-whatsapp/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add gokapso/agent-skills --skill observe-whatsapp -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about observe-whatsapp
How do I install observe-whatsapp in Claude Code?
Run npx skills add gokapso/agent-skills --skill observe-whatsapp -a claude-code. The skill file is placed at ~/.claude/skills/observe-whatsapp/SKILL.md.
What does observe-whatsapp do?
It helps investigate Kapso logs, message and API errors, webhook delivery, and WhatsApp number health.
What does the skill need to run?
For the primary workflow, install and authenticate the Kapso CLI with kapso login. The Platform API log fallback requires Logs and Elasticsearch to be enabled.
