evogo

核心用法

evoGo 是一个基于 Evolution API Go v3 的纯文档型 Skill，提供完整的 WhatsApp 自动化指南。它通过详细的 API 文档和 60 余个 curl 命令示例，指导用户完成从实例创建、QR 码扫码连接，到发送文本/媒体/投票/轮播消息、管理群组与社区、处理联系人等全流程操作。用户需自行部署 Evolution API 服务，通过配置环境变量（EVOGO_API_URL、EVOGO_API_KEY 等）连接自有实例，即可实现消息群发、自动回复、Webhook 实时事件处理等高级功能。

显著优点

功能覆盖极广，支持 10 余种消息类型（包括文本、图片、视频、音频、文档、投票、轮播卡片、位置、联系人名片等），满足多样化商务场景；文档结构清晰，提供 Quick Start 指南、完整的功能参考、常见工作流示例和详细的错误处理方案，大幅降低开发门槛；采用双层级认证机制（Global Key 管理实例，Instance Token 处理消息），权限分离明确；支持实时 Webhook 接收消息回执、群组更新等事件，便于构建自动化工作流；纯文档属性使其具备零依赖、零执行风险的特点，可在任何支持 Markdown 的环境安全查阅。

潜在缺点

该 Skill 仅为接口文档，实际运行完全依赖用户自行部署的 Evolution API 后端服务，部署和维护成本较高；部分高级交互功能（如交互式按钮和列表）因 WhatsApp 官方 API 调整已无法使用（v3.0 已知限制）；作为 T3 来源（个人/社区项目），缺乏官方商业支持，长期维护稳定性存疑；需要一定的技术背景（熟悉 curl、JSON、环境变量配置），非技术用户难以直接使用；WhatsApp 对自动化行为监控严格，不当使用（如缺乏延迟设置）可能导致账号受限。

适合群体

主要面向具备后端开发能力的软件工程师、DevOps 运维人员，以及需要集成 WhatsApp 能力的技术团队；适用于构建客户服务系统、营销自动化平台、内部通知机器人、社群运营管理工具等场景；适合已有服务器资源、能够自行托管 API 服务的中小企业；对于需要官方 WhatsApp Business API 保障的大型企业，或缺乏技术团队支持的个人用户，则不太适用。

使用风险

首要风险是 API 服务的自托管安全，若 Evolution API 服务部署不当（如暴露公网且无 IP 白名单），可能导致 API 密钥泄露和 WhatsApp 账号被恶意利用；其次是 WhatsApp 平台政策风险，批量发送消息时若未按文档建议添加 1-2 秒延迟，极易触发官方风控导致账号封禁；API 凭证（EVOGO_GLOBAL_KEY 和 EVOGO_API_KEY）的管理风险，硬编码或泄露可能导致未授权访问；Webhook 接收端若未做来源验证，可能遭受伪造请求攻击；最后，由于依赖第三方开源项目，存在接口变更或项目停止维护导致的兼容性风险。