Debug WhatsApp Message Delivery and Health

Provides operational diagnostics scripts for WhatsApp via the Kapso API - investigating message delivery, debugging webhook delivery, triaging errors, and running phone number health checks.

Use this skill for operational diagnostics: message delivery investigation, webhook delivery debugging, error triage, and WhatsApp health checks. Not a fit for initial webhook setup, signature verification, or event type configuration - that belongs to the related integrate-whatsapp skill - and not for building workflows/agents/automations, which is covered by automate-whatsapp.

Requires two environment variables: KAPSO_API_BASE_URL (host only, without the /platform/v1 path) and KAPSO_API_KEY. Provides scripts organized into four groups: message scripts (messages.js to list messages by phone number ID, message-details.js to inspect a specific message, lookup-conversation.js to find a conversation by E.164 phone number or ID), error/log scripts (errors.js to list message errors, api-logs.js to list external API logs, webhook-deliveries.js to list webhook delivery attempts), health scripts (overview.js for a project overview, whatsapp-health.js for phone number health checks), and an OpenAPI exploration script (openapi-explore.mjs) supporting search, operation lookup, and schema lookup against the platform spec.

Documents three standard workflows: investigating message delivery (list messages, inspect a specific message, find the conversation), triaging errors (check message errors, API logs, then webhook deliveries), and running health checks (project overview, then phone number health). Includes reference guides for message debugging, error triage, and health checks, plus example JSON output files for each workflow type.

Connects to the Kapso WhatsApp platform API via KAPSO_API_BASE_URL/KAPSO_API_KEY, and composes with the related integrate-whatsapp skill (onboarding, webhooks, messaging, templates, flows) and automate-whatsapp skill (workflows, agents, automations). Dependencies are installed once via npm i, and the OpenAPI explorer script can search the platform spec by keyword, look up a specific operation such as listWebhookDeliveries, or inspect a schema such as WebhookDelivery directly, which is useful when a script's exact request or response shape needs to be confirmed before writing custom diagnostic tooling on top of it.

Engineers operating a WhatsApp integration who need to diagnose message delivery failures, debug webhook delivery issues, or run health checks against the Kapso API, rather than set up the integration from scratch.

node scripts/openapi-explore.mjs --spec platform op listWebhookDeliveries