SuperAPI AI 工具集

kapso-ops

部署与运维

查看项目

更新于 10-15 21:53

技能介绍

用途:Kapso Ops 是面向 Kapso 项目的运维诊断技能,适用于 webhook 配置、消息投递排查、错误分类(triage)以及 WhatsApp 健康检查等运营场景。

主要能力:通过一组 Node 脚本完成日常运维操作。Webhook 方面支持列出、查看、创建、更新、删除和发送测试事件;消息方面支持列出消息、查看消息详情、按电话号码或会话 ID 查找会话;错误与日志方面可列出消息错误、外部 API 日志和 webhook 投递尝试;健康检查方面可查看项目概览和电话号码健康状态。

必要用法:需先设置环境变量 KAPSO_API_BASE_URL(仅主机地址,不含 /platform/v1)与 KAPSO_API_KEY。常见命令包括:创建 webhook 使用 node scripts/create.js --phone-number-id <id> --url https://... --events <csv>;测试使用 node scripts/test.js --webhook-id <id>;列出消息使用 node scripts/messages.js --phone-number-id <id>;查看消息详情使用 node scripts/message-details.js --message-id <id>;查找会话使用 node scripts/lookup-conversation.js --phone-number <e164>;错误排查使用 node scripts/errors.js、node scripts/api-logs.js、node scripts/webhook-deliveries.js;健康检查使用 node scripts/overview.js 和 node scripts/whatsapp-health.js --phone-number-id <id>。创建或更新 webhook 时可用 --kind、--payload-version、--buffer-enabled、--active 等标志。

适用场景与限制:适合 Webhook 配置与验证、消息投递问题定位、API 错误排查和 WhatsApp 健康监控。资料提示,whatsapp.message.* 事件应使用配置级 webhook;新集成建议使用 payload 版本 v2;Meta webhook 提供原始载荷,Kapso webhook 支持缓冲。具体定价、平台支持范围及更多限制暂未提供。