# observe-whatsapp

Investigate WhatsApp issues in Kapso, from failed message delivery to API and webhook errors. Useful for tracing events and checking phone number health.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3600 installs · ★ 190
- Author: gokapso
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gokapso/agent-skills/tree/HEAD/skills/observe-whatsapp/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/observe-whatsapp

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add gokapso/agent-skills --skill observe-whatsapp -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/observe-whatsapp/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/observe-whatsapp/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gokapso/agent-skills --skill observe-whatsapp -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/observe-whatsapp/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gokapso/agent-skills --skill observe-whatsapp -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/observe-whatsapp/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gokapso/agent-skills observe-whatsapp
```

2. **Manually: put the files in place**
- File: `.github/skills/observe-whatsapp/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gokapso/agent-skills --skill observe-whatsapp -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gokapso/agent-skills --path skills/observe-whatsapp
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/observe-whatsapp/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add gokapso/agent-skills --skill observe-whatsapp -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gokapso/agent-skills/tree/HEAD/skills/observe-whatsapp/SKILL.md

## When to use it
- trace log events related to a message
- inspect webhook delivery attempts
- triage API and message errors
- check project and WhatsApp number health

## Example prompts
- 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.

## Similar
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [claude-api](https://affpapa.org/en/nevibecode/skills/claude-api.md) — skill · 74198 installs
- [lark-im](https://affpapa.org/en/nevibecode/skills/lark-im.md) — skill · 472900 installs
- [lark-event](https://affpapa.org/en/nevibecode/skills/lark-event.md) — skill · 466800 installs
- [caveman-discover](https://affpapa.org/en/nevibecode/skills/caveman-discover.md) — skill · 104400 installs
- [migration](https://affpapa.org/en/nevibecode/skills/migration.md) — skill · 103900 installs

From the same set: [gokapso/agent-skills](https://affpapa.org/en/nevibecode/by/gokapso/agent-skills.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md