SuperAPI AI 工具集

whatsapp-delivery

部署与运维

查看项目

更新于 10-16 06:09

技能介绍

WhatsApp Delivery 是一个针对 WhatsApp 渠道的专项调试工作流技能,来源于 vercel-labs/vercel-openclaw 项目。根据资料,它应在使用 channel-debug-core 之后,用于处理 WhatsApp 相关问题。

用途 该技能聚焦 WhatsApp 渠道的投递与调试,帮助定位 Meta webhook 验证、签名校验、消息投递、快速路径与工作流执行等环节中的问题。

涉及文件 资料列出了以下相关文件:

  • src/app/api/channels/whatsapp/webhook/route.ts
  • src/server/channels/whatsapp/**
  • src/server/workflows/channels/drain-channel-workflow.ts
  • src/server/admin/why-not-ready.ts
  • src/app/api/channels/summary/route.ts

运行时路径 Meta webhook 验证 GET 或消息 POST -> 应用路由 -> x-hub-signature-256 校验 -> 去重 -> 快速路径到端口 3000 的 /whatsapp-webhook 或工作流 -> WhatsApp 适配器/API 回复。

需要先消费的并行通道输入 在提出 WhatsApp 修复方案之前,需要先消费以下信息:

  • Vercel/应用日志通道:GET 验证与 POST 投递、签名结果、requestId/deliveryId/Meta 消息 ID,以及项目定位证明。
  • 沙箱运行时通道:端口 3000 监听器与 /whatsapp-webhook 行为,以及经过脱敏的配置中是否包含 channels.whatsapp。
  • 工作流通道:当快速路径被跳过或失败时,工作流的启动/运行/转发状态,并在 .vercel/project.json 与事件目标不一致时验证项目定位。
  • 既往修复对比:linkState 投影被误认为投递、仅状态跳过、启动消息发送/删除、处理器非 OK 分类。

特殊检查点

  • GET 验证与 POST 投递是不同路径。
  • linkState 与用户可见回复不是同一回事。
  • Meta 签名校验依赖原始请求体。
  • 处理器返回非 OK 仍可能证明处理器已接收,需要精确分类。
  • 启动消息的发送/删除行为会影响用户可见状态。
  • lastForward 必须同时反映快速路径的失败与成功。

适用场景与限制 该技能适用于在 vercel-openclaw 项目中排查 WhatsApp 渠道的 webhook 验证、签名、投递、快速路径与工作流问题。资料未提供安装命令、收费信息、平台支持范围或具体使用步骤,这些内容暂未提供。