Observe WhatsApp
When to use
Use this skill for operational diagnostics: message delivery investigation, webhook delivery debugging, error triage, and WhatsApp health checks.
Setup
Env vars:
KAPSO_API_BASE_URL (host only, no /platform/v1)
KAPSO_API_KEY
How to
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
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 |
OpenAPI
| Script |
Purpose |
openapi-explore.mjs |
Explore OpenAPI (search/op/schema/where) |
Install deps (once):
npm i
Examples:
node scripts/openapi-explore.mjs --spec platform search "webhook deliveries"
node scripts/openapi-explore.mjs --spec platform op listWebhookDeliveries
node scripts/openapi-explore.mjs --spec platform schema WebhookDelivery
Notes
- For webhook setup (create/update/delete, signature verification, event types), use
integrate-whatsapp.
References
- references/message-debugging-reference.md - Message debugging guide
- references/triage-reference.md - Error triage guide
- references/health-reference.md - Health check guide
Related skills
integrate-whatsapp - Onboarding, webhooks, messaging, templates, flows
automate-whatsapp - Workflows, agents, and automations
[observe-whatsapp file map]|root: .
|.:{package.json,SKILL.md}
|assets:{health-example.json,message-debugging-example.json,triage-example.json}
|references:{health-reference.md,message-debugging-reference.md,triage-reference.md}
|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}
|scripts/lib/messages:{args.js,kapso-api.js}
|scripts/lib/status:{args.js,kapso-api.js}
|scripts/lib/triage:{args.js,kapso-api.js}
1---2name: observe-whatsapp3description: "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 f..."4source: "https://github.com/gokapso/agent-skills/tree/master/skills/observe-whatsapp"5risk: safe6metadata:7 source: https://skillmd.com/skills/mayurrathi/observe-whatsapp8---910# Observe WhatsApp1112## When to use1314Use this skill for operational diagnostics: message delivery investigation, webhook delivery debugging, error triage, and WhatsApp health checks.1516## Setup1718Env vars:19- `KAPSO_API_BASE_URL` (host only, no `/platform/v1`)20- `KAPSO_API_KEY`2122## How to2324### Investigate message delivery25261. List messages: `node scripts/messages.js --phone-number-id <id>`272. Inspect message: `node scripts/message-details.js --message-id <id>`283. Find conversation: `node scripts/lookup-conversation.js --phone-number <e164>`2930### Triage errors31321. Message errors: `node scripts/errors.js`332. API logs: `node scripts/api-logs.js`343. Webhook deliveries: `node scripts/webhook-deliveries.js`3536### Run health checks37381. Project overview: `node scripts/overview.js`392. Phone number health: `node scripts/whatsapp-health.js --phone-number-id <id>`4041## Scripts4243### Messages4445| Script | Purpose |46|--------|---------|47| `messages.js` | List messages |48| `message-details.js` | Get message details |49| `lookup-conversation.js` | Find conversation by phone or ID |5051### Errors and logs5253| Script | Purpose |54|--------|---------|55| `errors.js` | List message errors |56| `api-logs.js` | List external API logs |57| `webhook-deliveries.js` | List webhook delivery attempts |5859### Health6061| Script | Purpose |62|--------|---------|63| `overview.js` | Project overview |64| `whatsapp-health.js` | Phone number health check |6566### OpenAPI6768| Script | Purpose |69|--------|---------|70| `openapi-explore.mjs` | Explore OpenAPI (search/op/schema/where) |7172Install deps (once):73```bash74npm i75```7677Examples:78```bash79node scripts/openapi-explore.mjs --spec platform search "webhook deliveries"80node scripts/openapi-explore.mjs --spec platform op listWebhookDeliveries81node scripts/openapi-explore.mjs --spec platform schema WebhookDelivery82```8384## Notes8586- For webhook setup (create/update/delete, signature verification, event types), use `integrate-whatsapp`.8788## References8990- references/message-debugging-reference.md - Message debugging guide91- references/triage-reference.md - Error triage guide92- references/health-reference.md - Health check guide9394## Related skills9596- `integrate-whatsapp` - Onboarding, webhooks, messaging, templates, flows97- `automate-whatsapp` - Workflows, agents, and automations9899<!-- FILEMAP:BEGIN -->100```text101[observe-whatsapp file map]|root: .102|.:{package.json,SKILL.md}103|assets:{health-example.json,message-debugging-example.json,triage-example.json}104|references:{health-reference.md,message-debugging-reference.md,triage-reference.md}105|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}106|scripts/lib/messages:{args.js,kapso-api.js}107|scripts/lib/status:{args.js,kapso-api.js}108|scripts/lib/triage:{args.js,kapso-api.js}109```110<!-- FILEMAP:END -->111