登录开始免费试用
Meta Tech Provider

保护您的 WhatsApp 自动化:密钥、Webhook 与签名

保护一个 WhatsApp 自动化需要四个环节:AI 密钥以加密方式存储,且仅用于 AI 回复;自动化调用的 Webhook 应在信任请求前校验 HMAC 签名;转发的入站消息使用可轮换的密钥签名;以及有权访问的人员和助手,其权限仅限于工作所需。

easyCoexistence 以加密方式存储您的 AI 密钥且不再显示;每个 Call my webhook 请求和每条转发的消息,都使用只有您掌握的密钥附 X-EC-Signature 签名;并拒绝非公开 HTTPS 的 Webhook 地址。

AES-256-GCM

已保存的 AI 密钥、签名密钥以及号码的 Meta 访问令牌均采用静态加密存储。

Last 4

再次查看已保存的 AI 密钥时,只显示 “ending in” 加其末尾四位字符。

192 bits

每个签名密钥的随机性:whsec_ 加 24 个随机字节,每个自动化和每个转发号码各一个。

HTTPS only

Webhook 和转发 URL 必须为公开 HTTPS;私有及内部地址在保存时以及每次发送前都会被拒绝。

5 minutes

建议限制签名中 t 值的时效,以拒绝重放的请求。

WhatsApp 自动化设置中需要保护哪些内容?

共有五项凭据,各自有其存放位置,泄露时也有各自的应对方式。其中两项属于自动化本身:AI 密钥和 “Call my webhook” 的签名密钥;转发密钥属于号码;访问令牌和您助手的登录凭据属于账户。了解每项归属,出现问题时就知道该轮换哪一个。

AI keyYour Anthropic, OpenAI or OpenRouter key. Saved under AI keys, encrypted, shown only as its last 4 characters.
Webhook signing secretOne per automation, for Call my webhook. Shown as Signing secret in the editor once the automation is saved.
Forward secretOne per number, for the Forward URL. Shown once; New secret replaces it.
Number access tokenReturned by get_api_credentials for sending through Meta's API. Treat it like a password.
Assistant sign-inThe OAuth session of ChatGPT, Claude or another MCP client. Removed from the client's settings.

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": "..."} 会原样发送给客户,因此切勿在未经检查的情况下直接传递客户文本。

A Call my webhook request: headers and body
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 调用每个自动化一个。
使用 EasyCoexistence 完成这些操作

您的号码通过 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,而不是几个月。应用会继续在手机上运行。

开始免费试用

验证时间