Install
Terminal · npx$
npx skills add https://github.com/vercel-labs/agent-skills --skill vercel-react-best-practicesWorks with Paperclip
How Observe Whatsapp fits into a Paperclip company.
Observe Whatsapp drops into any Paperclip agent that handles this kind of work. Assign it to a specialist inside a pre-configured PaperclipOrg company and the skill becomes available on every heartbeat — no prompt engineering, no tool wiring.
S
SaaS FactoryPaired
Pre-configured AI company — 18 agents, 18 skills, one-time purchase.
$27$59
Explore packSource file
SKILL.md131 linesExpandCollapse
---name: observe-whatsappdescription: "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."--- # Observe WhatsApp ## When to use Use this skill for operational diagnostics: message delivery investigation, webhook delivery debugging, error triage, and WhatsApp health checks. ## Setup Preferred path:- Kapso CLI installed and authenticated (`kapso login`)- Start with `kapso status` to confirm project access and available WhatsApp numbers Fallback path:Env vars:- `KAPSO_API_BASE_URL` (host only, no `/platform/v1`)- `KAPSO_API_KEY` ## How to ### Investigate message delivery Preferred path:1. Resolve the number: `kapso whatsapp numbers resolve --phone-number "<display-number>" --output json`2. List recent messages: `kapso whatsapp messages list --phone-number "<display-number>" --limit 50 --output json`3. Inspect a specific message: `kapso whatsapp messages get <message-id> --phone-number-id <id> --output json`4. Inspect the conversation: `kapso whatsapp conversations list --phone-number "<display-number>" --output json` Fallback path: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 Preferred path:1. Confirm project and number state: `kapso status`2. Run number health: `kapso whatsapp numbers health --phone-number "<display-number>" --output human`3. Inspect related templates when relevant: `kapso whatsapp templates list --phone-number "<display-number>" --output json` Fallback path: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 Preferred path:1. Project overview: `kapso status`2. Phone number health: `kapso whatsapp numbers health --phone-number "<display-number>" --output human` Fallback path: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):```bashnpm i``` Examples:```bashnode scripts/openapi-explore.mjs --spec platform search "webhook deliveries"node scripts/openapi-explore.mjs --spec platform op listWebhookDeliveriesnode scripts/openapi-explore.mjs --spec platform schema WebhookDelivery``` ## Notes - For webhook setup (create/update/delete, signature verification, event types), use `integrate-whatsapp`.- Prefer resolving a display phone number to the canonical `phone_number_id` before deep debugging.- Keep the scripts as the fallback path when the CLI is unavailable or when you need API-log or webhook-delivery inspection. ## References - [references/message-debugging-reference.md](references/message-debugging-reference.md) - Message debugging guide- [references/triage-reference.md](references/triage-reference.md) - Error triage guide- [references/health-reference.md](references/health-reference.md) - Health check guide ## Related skills - `integrate-whatsapp` - Onboarding, webhooks, messaging, templates, flows- `automate-whatsapp` - Workflows, agents, and automations <!-- FILEMAP:BEGIN -->```text[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}```<!-- FILEMAP:END -->