Observe Whatsapp

1---
2name: observe-whatsapp
3description: "Observe and troubleshoot WhatsApp in Kapso: debug message delivery, inspect webhook deliveries/retries, triage API errors, and run health checks. Use when investigating production issues, message failures, or webhook delivery problems."
4---
5 
6# Observe WhatsApp
7 
8## When to use
9 
10Use this skill for operational diagnostics: message delivery investigation, webhook delivery debugging, error triage, and WhatsApp health checks.
11 
12## Setup
13 
14Env vars:
15- `KAPSO_API_BASE_URL` (host only, no `/platform/v1`)
16- `KAPSO_API_KEY`
17 
18## How to
19 
20### Investigate message delivery
21 
221. List messages: `node scripts/messages.js --phone-number-id <id>`
232. Inspect message: `node scripts/message-details.js --message-id <id>`
243. Find conversation: `node scripts/lookup-conversation.js --phone-number <e164>`
25 
26### Triage errors
27 
281. Message errors: `node scripts/errors.js`
292. API logs: `node scripts/api-logs.js`
303. Webhook deliveries: `node scripts/webhook-deliveries.js`
31 
32### Run health checks
33 
341. Project overview: `node scripts/overview.js`
352. Phone number health: `node scripts/whatsapp-health.js --phone-number-id <id>`
36 
37## Scripts
38 
39### Messages
40 
41| Script | Purpose |
42|--------|---------|
43| `messages.js` | List messages |
44| `message-details.js` | Get message details |
45| `lookup-conversation.js` | Find conversation by phone or ID |
46 
47### Errors and logs
48 
49| Script | Purpose |
50|--------|---------|
51| `errors.js` | List message errors |
52| `api-logs.js` | List external API logs |
53| `webhook-deliveries.js` | List webhook delivery attempts |
54 
55### Health
56 
57| Script | Purpose |
58|--------|---------|
59| `overview.js` | Project overview |
60| `whatsapp-health.js` | Phone number health check |
61 
62### OpenAPI
63 
64| Script | Purpose |
65|--------|---------|
66| `openapi-explore.mjs` | Explore OpenAPI (search/op/schema/where) |
67 
68Install deps (once):
69```bash
70npm i
71```
72 
73Examples:
74```bash
75node scripts/openapi-explore.mjs --spec platform search "webhook deliveries"
76node scripts/openapi-explore.mjs --spec platform op listWebhookDeliveries
77node scripts/openapi-explore.mjs --spec platform schema WebhookDelivery
78```
79 
80## Notes
81 
82- For webhook setup (create/update/delete, signature verification, event types), use `integrate-whatsapp`.
83 
84## References
85 
86- [references/message-debugging-reference.md](references/message-debugging-reference.md) - Message debugging guide
87- [references/triage-reference.md](references/triage-reference.md) - Error triage guide
88- [references/health-reference.md](references/health-reference.md) - Health check guide
89 
90## Related skills
91 
92- `integrate-whatsapp` - Onboarding, webhooks, messaging, templates, flows
93- `automate-whatsapp` - Workflows, agents, and automations
94 
95<!-- FILEMAP:BEGIN -->
96```text
97[observe-whatsapp file map]|root: .
98|.:{package.json,SKILL.md}
99|assets:{health-example.json,message-debugging-example.json,triage-example.json}
100|references:{health-reference.md,message-debugging-reference.md,triage-reference.md}
101|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}
102|scripts/lib/messages:{args.js,kapso-api.js}
103|scripts/lib/status:{args.js,kapso-api.js}
104|scripts/lib/triage:{args.js,kapso-api.js}
105```
106<!-- FILEMAP:END -->
107 
108