SuperAPI AI 工具集

whatsapp-flows

办公与效率

查看项目

更新于 10-16 05:49

技能介绍

用途:本技能用于端到端管理 WhatsApp Flows,包括发现流程、通过版本编辑 Flow JSON、发布与测试、附加数据端点,以及查看响应和日志。

配置:需设置环境变量 KAPSO_API_BASE_URL(仅主机,不含 /platform/v1)、KAPSO_API_KEY,META_GRAPH_VERSION 可选,默认 v24.0。脚本可用 Node 或 Bun 运行,例如 node scripts/list-flows.js。

创建与发布:使用 node scripts/create-flow.js --phone-number-id <id> --name <name> 创建流程;编辑前先阅读 references/whatsapp-flows-spec.md 了解 Flow JSON 规则。用 node scripts/update-flow-json.js --flow-id <id> --json-file <path> 更新 JSON,用 node scripts/publish-flow.js --flow-id <id> 发布,用 node scripts/send-test-flow.js --phone-number-id <id> --flow-id <id> --to <phone> 测试。

附加数据端点(动态流程):依次执行 setup-encryption.js 配置加密、set-data-endpoint.js 创建端点、deploy-data-endpoint.js 部署、register-data-endpoint.js 向 Meta 注册,均需 --flow-id 参数。

调试:可通过 list-flow-responses.js、list-function-logs.js、list-function-invocations.js 查看响应、函数日志与调用记录。

Flow JSON 规则:静态流程使用 version "7.3",routing_model 与 data_api_version 可选;动态流程使用 version "7.3" 并带 data_api_version "3.0",routing_model 为必填,用于定义屏幕跳转。

数据端点规则:处理函数签名为 async function handler(request, env),从 body.data_exchange 读取 action(INIT | data_exchange | BACK)、screen 和 data,返回包含 version、screen、data 的 JSON。不要使用 export 或 module.exports;完成时使用 screen: "SUCCESS" 配合 extension_message_response.params;不要包含 endpoint_uri 或 data_channel_uri,由 Kapso 注入。

常见问题:预览提示 flow_token is missing 表示动态流程缺少数据端点,需附加后刷新;加密设置错误需在 phone number/WABA 的 Settings 中启用加密;OAuthException 139000(Integrity)要求 WABA 在 Meta 安全中心完成验证。相关技能包括 whatsapp-messaging、kapso-automation、kapso-api。