automate-whatsapp

automate-whatsapp 技能概览

automate-whatsapp 的作用

automate-whatsapp 技能帮助你在 Kapso 中用 workflows、triggers、functions、app integrations 和 databases 搭建 WhatsApp 自动化。它面向的不是只靠聊天提示词就能解决的场景：你需要的是一个可重复执行的自动化流程，能够响应 WhatsApp 事件、路由逻辑、保存状态，并且可以更少试错地编辑和部署。

最适合的工作流自动化场景

如果你的工作是把 WhatsApp 消息或事件转成结构化动作，比如支持请求收集、线索资格判断、基于按钮的路由，或者通过 API 进行后续跟进，那么就适合用这个 automate-whatsapp 技能。尤其是在你需要 automate-whatsapp 技能同时处理对话流和底层 workflow graph，而不只是生成文案时，它会更有价值。

它为什么不一样

它的核心价值在于可落地的操作性：它覆盖安装、本地 workflow 编辑、执行上下文、function 合约，以及带真实仓库支持文件的集成配置。也就是说，automate-whatsapp 比通用提示词更有决策参考价值，因为它提供了那些通常会卡住首次成功的关键信息，比如 payload 结构、node 预期，以及示例应该去哪里看。

如何使用 automate-whatsapp 技能

安装 automate-whatsapp

如果是基于 Kapso 的环境，把 automate-whatsapp 技能安装到你的 skills 目录里，并确认你能访问 Kapso CLI 和项目链接。一个常见的起步命令是：
npx skills add gokapso/agent-skills --skill automate-whatsapp
如果你是在未关联项目的环境中工作，先确认是否还能使用 API 路径；如果不能，没有项目上下文时，这个技能的效果会明显变弱。

它需要什么输入

automate-whatsapp 的使用方式，最好一开始就提供四类信息：WhatsApp 目标、trigger 类型、预期的分支逻辑，以及你需要读写的外部状态。好的输入示例可以是：“创建一个 WhatsApp intake workflow，从 inbound_message 开始，提两个资格问题，把 lead status 存到 D1，并且对符合条件和不符合条件的用户发送不同回复。” 像“做一个 WhatsApp bot”这种输入太弱，会让技能不得不猜太多。

先读哪些文件

先看 SKILL.md，然后再检查 references/workflow-overview.md、references/triggers.md、references/execution-context.md 和 references/function-contracts.md。如果要看实现模式，先预览 assets/workflow-customer-support-intake-agent.json、assets/workflow-interactive-buttons-decide-function.json 和 assets/functions-example.json。如果你要接外部系统，也应该尽早阅读 references/app-integrations.md 和 references/databases-reference.md。

实用工作流

使用 automate-whatsapp 技能时，建议按这个顺序来：先确认 workflow 形态，再映射 trigger 和变量，然后决定逻辑应该放在 function node 还是 decide node，最后在修改前验证 runtime contract。如果你是在改已有项目，优先用 kapso link、kapso pull，本地编辑后再执行 kapso build 和 kapso push，这样可以在部署前先审查 graph。

automate-whatsapp 技能常见问题

automate-whatsapp 只适合 WhatsApp 聊天机器人吗？

不是。automate-whatsapp 技能面向的是 WhatsApp 驱动的工作流自动化，范围可以包括支持流程、按钮路由、函数调用、数据库更新和 app integrations。 如果你只需要一次性的聊天回复，普通提示词可能就够了；如果你需要稳定可靠的 workflow 行为，这个技能会更合适。

使用 automate-whatsapp 一定要有 Kapso 吗？

是的，Kapso 是它预期中的生态环境。这个技能默认你会使用 Kapso 的概念，比如 workflows、executions、triggers、functions，以及可选的 D1-backed 状态。如果你的技术栈不使用 Kapso，安装时也许仍有参考价值，但实现时不会有很好的对应关系。

它适合新手吗？

对 workflow 构建者来说是友好的，但对想要“完全零配置”的用户来说不是。automate-whatsapp 技能最容易上手的前提，是你能跟着仓库看示例，并提供一份明确的自动化规格。新手通常会卡在没有写清 trigger 细节、变量名，或者下一步分支行为。

什么时候不该用它？

如果你需要的是通用的 WhatsApp 营销群发工具、纯 no-code CRM，或者一个简单的 prompt wrapper，就不该用 automate-whatsapp。它最有价值的场景，是结果取决于结构化自动化逻辑、执行上下文和可编辑 workflow 产物的时候。

如何改进 automate-whatsapp 技能

给技能更精确的 workflow 规格

想让 automate-whatsapp 的结果更好，最有效的方法是在要求实现之前，先把 trigger、边界情况和成功标准说清楚。要包含消息示例、预期分支、必须保存的字段，以及你想执行的精确外部动作。这样能减少路由时的猜测，也会让输出更容易部署。

让输入和 runtime contract 对齐

很多失败都来自变量名含糊，或者对 payload 的假设不成立。请使用文档里定义的 execution context 和 function contracts，并且把变量命名成你希望它们在 nodes 里被消费的方式，比如 lead_score、handoff_needed 或 phone_number_id。在 automate-whatsapp 的使用场景里，这往往就是一个能跑通的 graph 和一次重写之间的区别。

参考具体仓库示例迭代

如果第一版输出已经接近目标但还不完整，不要从头重写，先对照仓库示例和参考文档来改。最有用的改进循环是：选一个 sample workflow JSON，照着它的 node 结构来写，然后只针对你的场景调整 trigger、变量和 edge labels。