Open Skills Logo
Open Skills

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.

View Source
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."source:"https://github.com/gokapso/agent-skills/tree/master/skills/observe-whatsapp"risk:safe

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

  • Inspect message: node scripts/message-details.js --message-id

  • Find conversation: node scripts/lookup-conversation.js --phone-number

    • 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

    • Scripts

    Messages

    ScriptPurpose
    messages.jsList messages
    message-details.jsGet message details
    lookup-conversation.jsFind conversation by phone or ID

    Errors and logs

    ScriptPurpose
    errors.jsList message errors
    api-logs.jsList external API logs
    webhook-deliveries.jsList webhook delivery attempts

    Health

    ScriptPurpose
    overview.jsProject overview
    whatsapp-health.jsPhone number health check

    OpenAPI

    ScriptPurpose
    openapi-explore.mjsExplore 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}