Back to Details

observe-whatsapp

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Observe WhatsApp

WhatsApp观察与故障排查

When to use

使用场景

Use this skill for operational diagnostics: message delivery investigation, webhook delivery debugging, error triage, and WhatsApp health checks.
本Skill用于运维诊断：消息投递问题排查、Webhook投递调试、错误分类处理，以及WhatsApp健康检查。

Setup

配置

Env vars:
  • KAPSO_API_BASE_URL
    (host only, no 
    /platform/v1
    )
  • KAPSO_API_KEY
环境变量：
  • KAPSO_API_BASE_URL
    （仅主机地址，不要包含
    /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>
  1. 列出消息：
    node scripts/messages.js --phone-number-id <id>
  2. 查看消息详情：
    node scripts/message-details.js --message-id <id>
  3. 查找对话：
    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
  1. 消息错误：
    node scripts/errors.js
  2. API日志：
    node scripts/api-logs.js
  3. Webhook投递记录：
    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>
  1. 项目概览：
    node scripts/overview.js
  2. 电话号码健康状态：
    node scripts/whatsapp-health.js --phone-number-id <id>

Scripts

脚本说明

Messages

消息相关

ScriptPurpose
messages.js
List messages
message-details.js
Get message details
lookup-conversation.js
Find conversation by phone or ID
脚本用途
messages.js
列出消息
message-details.js
获取消息详情
lookup-conversation.js
通过电话号码或ID查找对话

Errors and logs

错误与日志

ScriptPurpose
errors.js
List message errors
api-logs.js
List external API logs
webhook-deliveries.js
List webhook delivery attempts
脚本用途
errors.js
列出消息错误
api-logs.js
列出外部API日志
webhook-deliveries.js
列出Webhook投递尝试记录

Health

健康检查

ScriptPurpose
overview.js
Project overview
whatsapp-health.js
Phone number health check
脚本用途
overview.js
项目概览
whatsapp-health.js
电话号码健康检查

OpenAPI

OpenAPI

ScriptPurpose
openapi-explore.mjs
Explore OpenAPI (search/op/schema/where)
Install deps (once):
bash
npm i
Examples:
bash
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
脚本用途
openapi-explore.mjs
探索OpenAPI（搜索/操作/模式/查询）
安装依赖（仅需一次）：
bash
npm i
示例：
bash
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
    .
  • 若需进行Webhook配置（创建/更新/删除、签名验证、事件类型设置），请使用
    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
  • references/message-debugging-reference.md - 消息调试指南
  • references/triage-reference.md - 错误分类处理指南
  • references/health-reference.md - 健康检查指南

Related skills

相关Skill

  • 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 -->
  • integrate-whatsapp
    - 初始化配置、Webhook、消息发送、模板、流程
  • automate-whatsapp
    - 工作流、Agent、自动化
<!-- 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 -->