概述
hermes whatsapp-cloud 用于配置 Meta 官方 WhatsApp Business Cloud API 适配器。与 hermes whatsapp（面向个人账号的 Baileys 桥接）不同，它使用 Meta 托管的 Cloud API，需要 Business 账号和公网 webhook URL。它是一个交互式向导：没有子命令。
hermes whatsapp-cloud需要 TTY：向导会交互式地提示输入。
向导引导内容
- Meta 凭据 —— 电话号码 ID（Phone Number ID）、访问令牌（Access Token）和应用密钥（App Secret），以及可选的 App 和 WABA（WhatsApp Business Account）ID。
- Webhook 配置 —— 设置 Meta 用于投递入站消息的端点。
- 校验 —— 字段格式校验器会拦截常见配置错误，例如把电话号码粘贴到 Phone Number ID 字段中。
前置条件
- 拥有 WhatsApp Business 电话号码的 Meta Business 账号
- 可从互联网访问的公网 webhook URL
- 已启用 WhatsApp 产品的 Meta 应用
示例
hermes whatsapp-cloud
# 交互式向导依次提示输入：
# - Phone Number ID
# - Access Token
# - App Secret
# - 可选的 App / WABA ID
# - Webhook 配置# 设置完成后验证连通性
hermes status提示
- 两个 WhatsApp 适配器是互补关系，而非替代关系：
hermes whatsapp通过二维码配对个人账号；hermes whatsapp-cloud使用官方 Meta Business Cloud API 承载生产负载。 - 必须提供可从公网访问的 webhook URL——本地测试时，可以用隧道将服务器暴露出去。
- 凭据在输入时即被校验，像电话号码放错字段这类笔误会立即被发现。