observe-whatsapp
Debug and monitor WhatsApp API integrations within the Kapso platform.
Install
mkdir -p .claude/skills/observe-whatsapp-engryamato && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/14252" && unzip -o skill.zip -d .claude/skills/observe-whatsapp-engryamato && rm skill.zipInstalls to .claude/skills/observe-whatsapp-engryamato
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
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.Key capabilities
- →Investigate message delivery status
- →Inspect message details by ID
- →Find conversations by phone number
- →Triage message errors
- →List external API logs
- →Run health checks on WhatsApp phone numbers
How it works
The skill uses various scripts to interact with the Kapso platform API, allowing for investigation of message delivery, error triage, and health checks for WhatsApp operations. It provides specific commands for different diagnostic tasks.
Inputs & outputs
When to use observe-whatsapp
- →Debug failed message deliveries
- →Inspect webhook retry logs
- →Triage WhatsApp API errors
- →Run health checks on phone numbers
About this skill
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, flowsautomate-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}
When not to use it
- →When setting up webhooks (create/update/delete, signature verification, event types)
- →When onboarding new WhatsApp accounts
- →When managing message templates or flows
Prerequisites
Limitations
- →Requires `KAPSO_API_BASE_URL` and `KAPSO_API_KEY` environment variables
- →Does not handle WhatsApp onboarding, webhook setup, or message template management
- →Focuses on operational diagnostics rather than configuration or automation
How it compares
This skill offers targeted diagnostic and troubleshooting capabilities for WhatsApp within the Kapso platform, providing specific scripts to inspect message flows and API interactions, unlike general messaging tools.
Compared to similar skills
observe-whatsapp side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| observe-whatsapp (this skill) | 0 | 6mo | Review | Intermediate |
| test-rest-health | 0 | 4mo | Review | Beginner |
| n8n-expression-syntax | 6 | 4mo | No flags | Beginner |
| optimizing-performance | 1 | 2mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by engryamato
View all by engryamato →You might also like
test-rest-health
deadl1f7
Test REST endpoint health. Use when: verifying REST API availability, debugging REST connection issues, checking gRPC client status via REST, validating proto catalogue via REST API.
n8n-expression-syntax
czlonkowski
Validate n8n expression syntax and fix common errors. Use when writing n8n expressions, using {{}} syntax, accessing $json/$node variables, troubleshooting expression errors, or working with webhook data in workflows.
optimizing-performance
CloudAI-X
Analyzes and optimizes application performance across frontend, backend, and database layers. Use when diagnosing slowness, improving load times, optimizing queries, reducing bundle size, or when asked about performance issues.
error-tracking
diet103
Add Sentry v8 error tracking and performance monitoring to your project services. Use this skill when adding error handling, creating new controllers, instrumenting cron jobs, or tracking database performance. ALL ERRORS MUST BE CAPTURED TO SENTRY - no exceptions.
sentry-install-auth
jeremylongshore
Install and configure Sentry SDK authentication. Use when setting up a new Sentry integration, configuring DSN, or initializing Sentry in your project. Trigger with phrases like "install sentry", "setup sentry", "sentry auth", "configure sentry DSN".
fireflies-debug-bundle
jeremylongshore
Collect Fireflies.ai debug evidence for support tickets and troubleshooting. Use when encountering persistent issues, preparing support tickets, or collecting diagnostic information for Fireflies.ai problems. Trigger with phrases like "fireflies debug", "fireflies support bundle", "collect fireflies logs", "fireflies diagnostic".