Agent skill · operations · aiskillstore
observe-whatsapp
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.
Why this skill is useful
Adds 8 executable scripts for WhatsApp message delivery diagnostics and health checks that provide capabilities not covered in public documentation.
What it needs
Requires npm installed locally. About 1k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
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: KAPSOAPIBASEURL (host only, no /platform/v1) KAPSOAPIKEY How to Investigate message delivery 1. List messages: node scripts/messages.js --phone-number-id <id> 2. Inspect message: node scripts/message-details.js --message-id <id> 3. Find conversation: node scripts/lookup-conversation.js --phone-number <e164> Triage errors 1. Message errors: node scripts/errors.js 2. API logs: node scripts/api-logs.js 3. Webhook deliveries: node scripts/webhook-deliveries.js Run health checks 1. Project overview: node scripts/overview.js 2. 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): Examples: 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 <!-- FILEMAP:BEGIN --> <!-- FILEMAP:END -->
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/observe-whatsapp