NEW Hermes Agent Integration Update

Hermes Agent 核心功能与 WhatsApp 集成背景

Hermes Agent 是由 Nuse Research 开发的开源 AI 智能体，它作为后台程序运行在用户的计算机上，具备记忆功能，能够学习项目细节并记住之前的解决方案。除了支持定时任务和构建自定义技能外，其核心优势在于通过单一进程连接多个 messaging 应用，包括 Telegram、Discord、Slack、Signal、电子邮件以及 WhatsApp。这意味着用户无需切换不同应用即可通过聊天界面直接获取 AI 帮助。

此次更新引入了生产级的 WhatsApp Business Cloud 集成，允许用户运行仅限个人或团队使用的私人 WhatsApp 机器人，或面向客户的客服机器人。连接过程只需通过 Meta Business Manager 获取 WhatsApp Business Cloud 号码，并运行一条命令 Hermes WhatsApp Cloud 即可完成配置。该集成并非基础版本，而是提供了引导式设置、安全 Webhooks、媒体与语音支持、已读回执、输入指示器以及交互式批准按钮。用户会看到蓝色的双勾标记表示消息已读，输入指示器显示 AI 正在思考，而交互式按钮则用于需要用户确认的场景，整体体验如同原生应用。

"It's an open-source AI agent built by Nuse Research that lives in the background on your computer. It has memory, so it learns your projects and remembers how it solved things before."

目前存在两种接入 WhatsApp 的方式。旧版方式利用 Bailey's bridge，虽然快速且适用于个人账户，但属于非官方途径，存在Meta 限制账号的风险。新版 Cloud API 路径是 Meta 官方支持的方式，无封号风险，但需要 Meta 商业账户和公共 Web 链接。对于计划长期依赖的机器人，官方 Cloud 路径是更稳定的选择。

前置条件与 Meta 应用创建流程

在开始设置之前，用户需准备以下关键要素：首先是一个Meta 商业账户（business.facebook.com），而非个人 WhatsApp 账户；其次是已启用 WhatsApp 功能的 Meta 应用；最后是需要将计算机暴露给互联网的安全链接，文档推荐使用免费的 Cloudflare Tunnel 工具，无需端口转发或域名即可实现。

创建 Meta 应用的步骤如下：访问 developers.facebook.com/apps 并点击创建应用，选择用例为“通过 WhatsApp 与客户联系”，随后选择或创建商业组合包。在快速启动页面点击“开始使用 API”进入设置页面。此时需确认已链接 WhatsApp 商业账户，若刚创建组合包，系统通常会自动创建。

"One thing worth knowing, there are two ways to put Hermes on WhatsApp. The older way uses the Bailey's bridge... The new Cloud API way is the official Meta supported path."

此外，安装 FFmpeg 是可选但推荐的步骤。若安装 FFmpeg，语音回复将以带有绿色波形的 WhatsApp 语音备忘录形式呈现；若跳过此步，消息将以普通 MP3 音频文件形式发送，功能虽正常但体验稍逊。对于希望深入掌握此类集成并规划后续使用的用户，AI Profit Boardroom 提供了屏幕级别的逐步教程、实时辅导通话以及30 天路线图，帮助用户从连接机器人过渡到实际业务应用，避免盲目操作。

关键配置参数与网络隧道设置

在 API 设置页面，用户需收集三个关键值，其中电话号码 ID 是最常见的错误来源。该 ID 并非真实的手机号码，而是位于“from”下拉菜单下方、长度为 15 到 17 位的内部 ID。许多用户因粘贴真实号码而导致配置失败，务必复制该内部 ID。

其次是访问令牌（Access Token），以 EAA 开头且超过 100 字符。快速令牌仅有效期 24 小时，仅适合测试；对于长期运行的机器人，需按照文档生成永久系统用户令牌，设置权限并将过期时间设为“永不”，然后将其放入 Hermes 设置文件并重启服务。最后是应用密钥（App Secret），这是一个位于“Settings”->“Basic”下的 32 位代码，用于验证传入消息确实来自 Meta 而非伪造，必须像密码一样保密，否则消息将被拒绝。

为了让 Meta 能够访问本地计算机，需安装 Cloudflare Tunnel 并运行一行命令，将隧道指向本地 Hermes 端口。这将生成一个以 trycloudflare.com 结尾的公共链接，需将其提供给 Meta。需要注意的是，免费快速隧道每次重启都会生成新链接，若连接中断需更新链接；若需稳定链接，可创建免费的命名隧道。