observe-whatsapp

Observe WhatsApp - WhatsApp Monitoring and Debugging Tool

Skills Overview

Observe WhatsApp is a WhatsApp-specific diagnostic tool provided by the Kapso platform. It helps developers quickly identify message delivery issues, check webhook status, analyze API errors, and perform system health checks.

Use Cases

Urgent production issue troubleshooting: When WhatsApp messages fail to send or delivery is delayed, quickly trace the message chain, pinpoint the failure point, and reduce the time impact on the business.

Webhook integration debugging: After configuring or modifying a webhook, verify delivery status, check retry records, and troubleshoot issues such as signature verification failures.

Daily operations monitoring: Run health checks regularly to monitor WhatsApp API call status, error trends, and system performance metrics to detect potential issues early.

Core Features

Message Delivery Tracing

- List all message records for a specified phone number ID
- View detailed status and delivery path for a single message
- Quickly locate related conversations by phone number or session ID

Error Diagnosis and Analysis

- Aggregate and analyze message sending errors
- View external call logs for the WhatsApp API
- Check webhook delivery records and retry history

System Health Checks

- Get an overall operational overview of the project
- Check the health status of a specific phone number
- Explore platform capabilities in depth via the OpenAPI interface

Common Questions

How do I troubleshoot why WhatsApp message sending fails?

Use Observe WhatsApp to quickly pinpoint the problem. First run errors.js to view the list of message errors, then use message-details.js to get detailed information about failed messages, including error codes, error descriptions, and the time of failure. For further analysis, you can run api-logs.js to view API call logs and determine whether the issue is related to network problems, API rate limiting, or parameter errors.

How can I check whether the WhatsApp webhook is delivering properly?

Use the webhook-deliveries.js script to view all webhook delivery records, including delivery status, response codes, retry counts, and delivery times. If deliveries fail, combine with api-logs.js to analyze the specific cause. Note: webhook creation, updates, and signature verification configuration require the integrate-whatsapp skill.

What’s the difference between Observe WhatsApp and other WhatsApp monitoring tools?

Observe WhatsApp is designed specifically for the Kapso platform and deeply integrates capabilities such as message tracing, error classification, and health checks. Compared with the official WhatsApp Business API backend, it provides more granular diagnostic information and scripted operations, making it ideal for integrating into automated operations workflows. It also forms a complete WhatsApp toolchain with Kapso’s integrate-whatsapp (integration) and automate-whatsapp (automation) skills.