GetMyBot 通过 WhatsApp Cloud API（Meta Graph API）连接 WhatsApp。连接后，机器人接收来自 WhatsApp 的入站消息并对其应用你的反应，客服可以在对话中继续沟通。多渠道概览见 渠道 页面。
连接 WhatsApp 渠道
连接需要来自你的 Meta 应用（WhatsApp Cloud API）的五项凭据。它们全部 必填：
- Phone number ID — WhatsApp Business 号码的标识符。
- WABA ID — WhatsApp Business Account 的标识符。
- Access token — Meta 应用的访问令牌。
- Verify token — 由你自行设定的任意字符串。用于在 Meta 中验证 Webhook（见下文）。
- App secret — Meta 应用的密钥。用于校验入站 Webhook 的 HMAC 签名（请求头
X-Hub-Signature-256）。
界面中的步骤：
- 打开 机器人 → 「添加渠道」 → WhatsApp。
- 填写以上五个字段，如需要可填写渠道名称（可选）。
- 点击 「验证」 ——GetMyBot 会通过 Meta 校验凭据。
- 点击 「连接」。
在 Meta 中设置 Webhook
连接后，渠道会出现一个形如 {地址}/ch/{channelID} 的 Callback URL（界面中为 Webhook 图标 🔗）。需要将它连同你的 Verify token 一起填入 Meta 应用：WhatsApp → Configuration → Webhook。
工作原理：
- Meta 向 Callback URL 发送 验证请求，并将传入的
verify_token与你的 Verify token 比对。匹配则视为 Webhook 已确认。 - 之后 Meta 会向该地址发送事件（入站消息、投递状态、模板审核结果）。
- 每个入站请求都带有
X-Hub-Signature-256签名；GetMyBot 使用 App secret 校验签名——因此连接时需要这项凭据。
24 小时会话窗口
WhatsApp 限制主动发起的沟通：自由消息 只能在用户最后一条入站消息之后的 24 小时 内发送给用户。用户每发送一条新的入站消息，窗口就会刷新。
超出 24 小时窗口后无法发送自由消息——再次联系用户（re-engage）的唯一方式是 已批准的消息模板。因此模板是 WhatsApp 中群发和提醒的关键工具。
消息模板
模板（message template）是与 Meta 事先约定好的消息，可以在会话窗口之外发送。模板管理在 GetMyBot 界面中进行。
在哪里管理模板
机器人 → 在 WhatsApp 渠道上点击 「消息模板」 图标（📄）→ 对话框 「WhatsApp 渠道模板」。对话框中有以下按钮：
- 「创建模板」 — 构建一个新模板。
- 「同步」 — 从 Meta 拉取模板目录（更新状态和列表）。
模板类别
- MARKETING（营销） — 活动、公告、群发。
- UTILITY（服务） — 关于用户操作的通知（订单状态、提醒）。
- AUTHENTICATION（身份验证） — 验证码。
模板字段
- 名称 — 小写拉丁字母、数字和
_，最多 512 个字符。 - 语言 — Meta 语言区域。
- 类别 — 以上三者之一。
对于 营销 和 服务 类别，另外还有：
- 头部 — 无 / 文本 / 图片 / 视频 / 文档。媒体头部需上传示例文件。
- 正文 — 必填，最多 1024 个字符。变量用
{{1}}、{{2}}…… 表示，从 1 到 N 严格按顺序，不得跳号。 - 底部 — 最多 60 个字符。
- 按钮 — 最多 10 个：快速回复、链接（最多 2）、电话（1）、复制代码（1）。
- 每个变量
{{n}}都需要设置一个 示例值 ——这是 Meta 审核的要求。
对于 身份验证 类别，正文由 Meta 固定；可配置项为：验证码有效期（1–90 分钟）、安全建议和复制验证码按钮的文本。
审核
点击 「创建」 按钮会立即将模板提交给 Meta 审核——没有单独的「提交审核」步骤。审核结果异步返回（通过 Webhook），模板列表自动刷新。状态：
- PENDING（审核中）
- APPROVED（已批准）
- REJECTED（已拒绝） — 附带原因
- 以及 PAUSED、DISABLED、IN_APPEAL、PENDING_DELETION。
可以编辑处于 APPROVED、REJECTED、PAUSED 状态的模板。名称和语言不可更改；已批准模板的类别也会被锁定。
在反应中使用模板
发送模板是反应的一个动作：
- 在反应构建器中打开 「动作」 → 「添加动作」 → 「发送 WhatsApp 模板」。
- 仅当机器人连接了支持模板的 WhatsApp 渠道时，该动作才可用。
- 只能选择 已批准（APPROVED） 的模板。
- 填写参数：正文中变量
{{n}}的值、文本头部、通过链接指定的媒体头部、URL 按钮参数。参数中可以使用替换变量。
实际的发送渠道由事件所在渠道决定：如果事件来自 WhatsApp，模板就会发往 WhatsApp。
对话与附件
客服可以在 WhatsApp 对话中回复并发送附件——图片、视频或文档——但受 24 小时窗口约束（窗口之外无法自由沟通）。来自订阅者的入站媒体通过代理拉取并在对话中显示。
计费
GetMyBot 按类别 — marketing / utility / authentication / service — 统计 WhatsApp 会话（conversations）。在当前版本中，这 仅用于可观测性的记录（record-only）：不会因会话扣减余额。