保护您的 WhatsApp 自动化:密钥、Webhook 与签名
保护一个 WhatsApp 自动化需要四个环节:AI 密钥以加密方式存储,且仅用于 AI 回复;自动化调用的 Webhook 应在信任请求前校验 HMAC 签名;转发的入站消息使用可轮换的密钥签名;以及有权访问的人员和助手,其权限仅限于工作所需。
easyCoexistence 以加密方式存储您的 AI 密钥且不再显示;每个 Call my webhook 请求和每条转发的消息,都使用只有您掌握的密钥附 X-EC-Signature 签名;并拒绝非公开 HTTPS 的 Webhook 地址。
已保存的 AI 密钥、签名密钥以及号码的 Meta 访问令牌均采用静态加密存储。
再次查看已保存的 AI 密钥时,只显示 “ending in” 加其末尾四位字符。
每个签名密钥的随机性:whsec_ 加 24 个随机字节,每个自动化和每个转发号码各一个。
Webhook 和转发 URL 必须为公开 HTTPS;私有及内部地址在保存时以及每次发送前都会被拒绝。
建议限制签名中 t 值的时效,以拒绝重放的请求。
WhatsApp 自动化设置中需要保护哪些内容?
共有五项凭据,各自有其存放位置,泄露时也有各自的应对方式。其中两项属于自动化本身:AI 密钥和 “Call my webhook” 的签名密钥;转发密钥属于号码;访问令牌和您助手的登录凭据属于账户。了解每项归属,出现问题时就知道该轮换哪一个。
AI 密钥如何存储和使用?
仅可通过控制台操作:在自动化页面点击 “AI keys” 按钮,然后点击 “Test and save”。系统会先通过服务商提供的免费端点检查密钥,该端点不消耗任何额度;服务商拒绝的密钥会被丢弃,不予保存。有效密钥以 AES-256-GCM 加密存储,仅在为您的 AI 步骤和 agent 调用该服务商时,以及在 OpenAI 或 OpenRouter 密钥上转写语音消息时解密,之后只显示为 “ending in 1234”。没有任何 MCP 工具可以接收或返回密钥,因此密钥绝不会经过您与助手的对话。
一个账户对每个服务商只保留一个密钥,保存新密钥会替换旧密钥。请在服务商处为自动化单独创建一个密钥,并在服务商支持时设置消费上限,这样撤销它时不会影响您的其他应用。如果服务商拒绝该密钥,使用它的自动化会显示为 “Paused”,您会收到一封邮件;保存一个有效的密钥后,自动化会自动恢复。
如何验证 Call my webhook 请求确为真实请求?
先校验签名,再读取任何其他内容。每个请求都带有 X-EC-Signature: t=<unix 秒数>,v1=<以该自动化的 Signing secret 为密钥、对 “<t>.<原始请求体>” 计算的十六进制 HMAC-SHA256>。请使用该签名密钥(保存后可从编辑器中的步骤复制)对原始字节重新计算 HMAC,以恒定时间比较,并拒绝与本地时钟相差超过 5 分钟的 t。请求体还有两点值得注意:dry_run 为 true 时,表示请求来自 “Try it”,此时应跳过任何不可逆的操作,例如创建订单;run_id 对每次运行都是唯一的,因此请记录您已处理过的 run_id,并拒绝重放的请求。请在 20 秒内响应;{"reply": "..."} 会原样发送给客户,因此切勿在未经检查的情况下直接传递客户文本。
POST /hooks/whatsapp HTTP/1.1
Content-Type: application/json
User-Agent: easyCoexistence-automations/1
X-EC-Event: automation.step
X-EC-Signature: t=1794405732,v1=<64 hex characters>
{
"event": "automation.step",
"dry_run": false,
"automation": { "id": "a7d0c3e2-5b1f-4c8e-9a6d-2f4e8b1c7d90", "name": "Order status" },
"run_id": "e41b9f07-3c2a-4d6e-8f15-7a9c0b2d4e68",
"channel": { "type": "whatsapp", "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
"message": { "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==", "type": "text", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.000Z" },
"history": [
{ "direction": "in", "text": "Hi!", "at": "2026-11-11T14:01:40.120Z" },
{ "direction": "in", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.310Z" }
]
}
// Your answer, within 20 seconds (or {} to send nothing):
{ "reply": "Your order #1042 left the shop at 2:20 p.m." }转发密钥如何运作,如何轮换?
当号码设置为 “Through easyCoexistence” 时,可以将收到的消息转发到您自己的系统。首次保存转发 URL 时,系统会生成一个密钥,并在 “Your signing secret, shown once. Copy it now:” 下仅显示一次;每个转发的 POST 都使用相同的 X-EC-Signature 方案签名。在号码页面点击 “New secret”,或调用 set_inbound_mode 并将 rotate_secret 设为 true,即可生成新的替代密钥,同样仅显示一次。此后所有请求(包括旧投递的重试)都将使用新密钥签名。您也可以自行输入一个至少 24 个字符的密钥,该密钥会被存储,之后不再显示。停止转发会删除该密钥,因此之后再次保存 URL 时会生成全新的密钥。
以下情况应轮换密钥:团队成员离职后;密钥被意外写入代码仓库、工单或日志后;更换托管环境时。“Call my webhook” 的密钥属于该自动化,只有账户所有者可以看到。在 “Your system calls a URL” 触发器下,若编辑器显示 “New secret”,该按钮会替换密钥,旧密钥立即失效;若自动化没有该按钮,请重新创建该自动化,将接收端指向新密钥,然后删除旧的自动化。
自动化可以调用哪些地址?
仅限公开的 HTTPS 地址。以 http:// 开头、指向 localhost、私有网段、.internal 或 .local 域名,或云元数据地址的 “Call my webhook” URL 或转发 URL,在保存时会被拒绝;并且每次请求前都会在 DNS 解析后再次检查,因此公开域名之后无法被指向私有网络。系统不会跟随重定向:301 或 302 会导致该步骤失败,因此请保存最终地址。
请勿将密钥放入 URL 本身。list_automations 会将每个自动化的步骤(包括 Webhook URL)返回给连接到您账户的任何助手,因此查询字符串中的令牌在那里是可读的。请改由签名来证明请求的真实性。
如何将访问权限降到最低?
为每个人和每个工具只授予其工作所需的访问权限,并移除不再使用的权限。连接器一侧的登录、确认和屏蔽工具等内容,已在有关安全地将 WhatsApp 连接至 AI 的页面中说明;就自动化而言,以下习惯最为重要:
- 仅在私密对话中请求
get_api_credentials:否则号码的访问令牌会留在该对话记录中。 - 优先使用 Call my webhook 或转发 URL,而不是把令牌交给第三方工具。
- 删除已停用的自动化;这同时会使其签名密钥失效。
- 请记住,运行日志会保留客户消息和回复 30 天,Conversations 会在您的保留期限(30、90 或 365 天)内保留聊天,二者都可在控制台中查看,也可通过您连接的助手读取。
- 对于设置为 “Straight to your system” 的号码,请在回调 URL 路径中加入一段较长的随机密钥,因为 Meta 的签名在此处无法校验。
常见错误
- 在框架重新序列化后的 JSON 上校验签名。许多解析器会改变空格、转义或键的顺序;只要技术栈允许,请对原始请求字节计算 HMAC。
- 在测试调用中产生副作用。“Try it” 会以 dry_run 设为 true 调用您的 Webhook;此时产生的订单、退款或 CRM 写入都是真实的。
- 为省事而把 AI 密钥粘贴到与助手的对话中。没有任何工具会接收它,而且它会留在对话记录中;请在控制台中使用 AI 密钥。
- 用 Call my webhook 的密钥校验转发,或者反过来。两者是分开的密钥:转发每个号码一个,Webhook 调用每个自动化一个。
您的号码通过 Coexistence 继续使用 Meta 官方的 Cloud API,并全天候监控。每个已连接号码每月 US$ 9 起,号码越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。
常见问题
easyCoexistence 的员工或支持人员能看到我的 AI 密钥吗?
密钥保存后将不再显示:不会出现在控制台、MCP 结果中,也不会出现在支持助手读取的信息里。只有系统本身在为 AI 回复调用您的服务商时才会解密。
谁可以查看我的自动化运行日志?
任何登录 easyCoexistence 账户的人(包括您邀请的人)都可以在 “Runs” 标签页中查看,连接到该账户的任何助手也可以通过 list_automation_runs 和 get_automation_run 查看。日志包含客户的消息和回复,并会在 30 天后删除。
如何安全地删除 AI 密钥?
先将使用该密钥的自动化以及所有基于该密钥运行的智能体设为 “Switch Off”,然后在 “AI keys” 下选择 “Remove”,并在服务商处撤销该密钥。若自动化仍在使用该密钥时将其删除,它们会在下一次 AI 回复时暂停,并向您发送一封邮件。
Try it 会将客户数据发送到我的 Webhook 吗?
只会发送您输入的示例文本,dry_run 设为 true,且历史记录为空。真实运行则会发送收到的消息以及该聊天的最近消息(最多 10 条),因此请将您的端点视为处理客户数据的系统。
继续阅读
准备开始了吗?
几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间