Observe WhatsApp

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

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

Errors and logs

Health

OpenAPI

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

<!-- FILEMAP:BEGIN -->

[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 -->

---

<!-- AGI-INTEGRATION-START -->

AGI Framework Integration

Adapted for @techwavedev/​agi-agent-kit Original source: antigravity-awesome-skills

Memory-First Protocol

Cache workflow configurations and automation patterns. Retrieve prior pipeline designs to avoid re-building similar flows from scratch.

# Check for prior workflow/​automation context before starting
python3 execution/​memory_manager.py auto --query "automation patterns and workflow configurations for Observe Whatsapp"

Storing Results

After completing work, store workflow/​automation decisions for future sessions:

python3 execution/​memory_manager.py store \
  --content "Workflow: automated data pipeline with retry logic, dead-letter queue, and Slack alerts on failure" \
  --type technical --project <project> \
  --tags observe-whatsapp workflow

Multi-Agent Collaboration

Share workflow state with other agents so they can trigger, monitor, or extend the automation.

python3 execution/​cross_agent_context.py store \
  --agent "<your-agent>" \
  --action "Workflow automation deployed — pipeline processing 1000+ events/​day with 99.9% success rate" \
  --project <project>

Playbook Engine

Combine this skill with others using the Playbook Engine (execution/​workflow_engine.py) for guided multi-step automation with progress tracking.

<!-- AGI-INTEGRATION-END -->