WhatsApp 自动化术语表:触发器、步骤、接管、24 小时窗口等
WhatsApp 自动化有一套自己的术语。触发器决定什么会启动自动化:一条消息、一个标签或一次 Webhook 调用;步骤决定回复什么内容;当有人从手机上回复时,接管会暂停自动化;24 小时窗口则决定除模板以外的哪些回复可以发出。模板、选择加入、运行状态、跳过原因和带签名的 Webhook 构成完整的图景,本页每个术语各用一行说明。
easyCoexistence 通过 Coexistence 将您的 WhatsApp Business 号码连接到 Meta 的 Cloud API,并依托上述术语在其上运行自动化:四种匹配方式、19 种步骤类型、您从手机回复时的接管,以及附带跳过原因的 30 天运行日志。
WhatsApp 自动化筛选收到消息的方式:所有消息、含关键词、首条消息和非营业时间。
号码上的步骤类型,从以文本回复、发送模板,到提问、拆分为多条路径和智能体回答。
一个自动化的一条线路最多可容纳 60 个步骤,分支最多可嵌套 4 层。
Meta 的客户服务窗口:非模板消息只能在客户最后一条消息之后的 24 小时内发送。
Meta 的模板类别:营销、实用和身份验证。
运行可能显示的跳过原因,从近期从手机上的回复到 AI 密钥失效不等。
哪些术语描述自动化背后的连接?
自动化在一个号码上运行,该号码在留在 WhatsApp Business 应用中的同时,连接到 Meta 的 API。以下六个术语描述该连接,以及号码收到的消息去向:
- Coexistence:Meta 的接入流程,将已在 WhatsApp Business 应用中的号码连接到 Cloud API,使应用与软件共用同一号码及其聊天。
- Cloud API:Meta 提供的托管 API,用于收发 WhatsApp Business 消息,是软件接入的官方途径。
- 入站模式:号码收到的消息去向,在其页面的“收到的消息去向”下显示为“通过 easyCoexistence”或“直接发送至您的系统”。
- 通过 easyCoexistence(托管):Meta 将消息投递至 easyCoexistence,自动化和“对话”可以使用这些消息,并可选择设置转发 URL,以接收带签名的副本。
- 直接发送至您的系统(直连):Meta 将号码的消息直接推送至您自己的 Webhook 接收地址,自动化处于关闭状态。
- 转发 URL:您的 HTTPS 端点,用于接收托管号码的每项入站变更,并以 X-EC-Signature 签名。
自动化由哪些基本组成部分构成?
自动化由一个触发器和一个步骤流程构成,作用于同一个号码。触发器指定事件,匹配条件进一步收窄范围;按优先级,同一条消息只会由一个自动化响应。以下是编辑器在“收到消息时”下使用的名称:
- 自动化:一个触发器加一个步骤流程,每条线最多 30 个步骤,共计最多 60 个,作用于一个号码,作为整体开启或关闭。
- 触发器:启动自动化的事件;在 WhatsApp 号码上,即“收到消息”、“联系人被打标签”或“您的系统调用某个 URL”。
- 所有消息:兜底匹配,适用于客户发送的任何内容。
- 含关键词:当消息匹配最多 30 个关键词中的任一个时运行;不区分大小写。
- 关键词模式:包含(位于消息中的任意位置)、以该词开头(位于开头)或完全等于(整条消息)。
- 首条消息:在没有历史记录的聊天中运行,包括自动化开启后常客的首条消息,或约 30 天没有互动后的首条消息。
- 非营业时间:在您打烊期间运行,由时区、营业日以及开始 / 结束时间(24 小时制)设定。
- 优先级:决定选用哪个自动化的顺序:先关键词,再首条消息,然后非营业时间,最后兜底匹配;同一级别中,较早创建的优先。
每种步骤类型是什么意思?
步骤在触发器模块之后自上而下依次执行,其中两个步骤可以分支:“按规则分路”(按文本、字段、标签或时段的规则)和“AI 选择路径”(按含义)各自为每条路径设一条步骤线,外加一条“其他情况”线。每条线最多 30 个步骤,共计最多 60 个,分支最多嵌套 4 层。一个号码可用 19 种步骤类型;除下列之外,编辑器还提供“提问”(最多 3 个可点按的按钮,等待回答并保存到联系人字段)、“智能体回答”、“转交真人”(暂停该聊天上的机器人并给您发邮件)、“通知我”、“发送图片或文件”、“保存到联系人”、“打标签”、“AI 保存详情”、“调用 API”、“启动自动化”和“返回某一步骤”。以下是核心步骤类型及其名称:
- 以文本回复:一条固定消息,最多 4,096 个字符,按原文发送。
- 变量:{{
first_name}}、{{name}}、{{message}} 和 {{phone}},另有表示已保存联系人字段的 {{contact.field}} 和表示前一步骤回答的 {{vars.name}},步骤运行时进行替换。 - 发送模板:发送该号码上已获批准的模板,可带按位置排列的正文变量;可用于 24 小时窗口之外。
- 以 AI 回复:由您自己的模型撰写回复,使用您的 Anthropic、OpenAI 或 OpenRouter 密钥。
- 指令:AI 步骤或智能体的提示词,最多 20,000 个字符;智能体还可以使用知识文件、链接和文本。
- 调用我的 Webhook:将消息及该聊天中最近最多 10 条消息发送至您的 URL,并接收 20 秒内返回的回复。
- 等待:在进入下一步骤前暂停运行 1 至 1,380 分钟,即 23 小时。
- 停止:结束运行;仅允许作为所在线路的最后一个步骤使用。
哪些规则与限制有各自的名称?
有些词源自 Meta,适用于 WhatsApp 上的任何企业;其他则是自动化编辑器中“高级”下的设置。两者都决定回复是否会发出,因此值得记住其名称:
- 24 小时窗口:Meta 的客户服务窗口;除模板外的消息仅允许在客户最后一条消息之后的 24 小时内发送。
- 模板:Meta 事先审核的消息格式,属于营销、实用或身份验证类别;在主动先发消息或超过 24 小时后发送时必须使用。
- 选择加入:对方已向您提供号码,并同意接收您的消息,Meta 要求您在主动发消息前获得此项同意。
- 回显:Meta 的
smb_message_echoesWebhook,用于报告您从应用或已关联设备发送的消息。 - 接管:您在手机上或在“对话”中回复后的暂停时段,在“回复后暂停该聊天(小时)”中设置,默认 4,可设为 0 至 168。
- AI 回复上限:“每个聊天每小时最多 AI 回复数”,默认 10,可设为 1 至 60。
- 词元:AI 服务商计费的单位;“最长回复(词元)”限制单条回复的长度,默认 600,可设为 50 至 2,000。
- 14 天规则:若号码对应的应用约 14 天未在手机上打开,Meta 会断开其 Coexistence 连接。
运行日志相关术语是什么意思?
每当自动化因一条消息启动,就会在“运行”标签页中留下一条运行记录,保留 30 天,并包含每个步骤的输出、耗时和词元。以下术语说明您在其中看到的内容:
- 运行:自动化对一条收到的消息、一个标签或一次 Webhook 调用,或一次测试执行的一次执行。
- 运行状态:排队中、运行中、等待中(停留在“等待”步骤中)、已完成、失败或已跳过。
- 跳过原因:运行被有意停止的原因,例如“您最近已在手机上回复此聊天”。
- 测试 / 试运行:对示例消息运行已保存的步骤;不会发送任何内容,但 AI 和 Webhook 会实际运行。
- 已暂停:自动化的状态,表示其 AI 密钥被服务商拒绝;保存有效密钥后即会重新启动。
- 已被取代:等待中的运行被取消,因为客户更新的一条消息再次启动了同一自动化。
常见错误
- 把已暂停误读为已关闭。已暂停表示 AI 密钥已失效;保存有效密钥后,自动化会自行重新启动,而已关闭则需您手动切换才会重新开启。
- 把应用的离开自动回复与非营业时间视为同一回事。前者位于手机应用中,软件无法看到;后者是 API 端的一项自动化。
- 以为首条消息只会针对全新联系人触发。实际上,任何没有已存储历史记录的聊天都会触发,包括常客。
您可以在编辑器中自行搭建,也可以让 AI 基于您自己的密钥代为搭建。每个已连接号码每月 US$ 9 起,号码越多越便宜,最低降至 US$ 0.75,并含 3 天免费试用。
常见问题
自动化和 AI 智能体有什么区别?
自动化是触发器加步骤,即使带有分支也是如此:每条路径都由您自己绘制。AI 智能体自行决定下一步动作。“智能体回答”步骤将您的一个智能体放入自动化中,连同其指令、知识以及保存联系人字段或将聊天转交真人等工具,而“以 AI 回复”步骤只负责撰写回复。您自己完整的智能体也可以部署在“调用我的 Webhook”或转发 URL 之后。
这些术语在控制台的哪里出现?
匹配条件和关键词模式位于自动化编辑器的触发器模块中,步骤则在模块之间的 + 菜单中。接管和 AI 回复上限位于“高级”下,运行与跳过原因位于“运行”标签页,入站模式则位于号码页面。
这些术语中哪些来自 Meta?
Coexistence、Cloud API、24 小时窗口、模板及其类别、选择加入、回显和 14 天规则均来自 Meta。匹配条件、步骤、接管、运行状态、跳过原因和 X-EC-Signature 则是 easyCoexistence 控制台与 API 中使用的名称。
X-EC-Signature 是什么意思?
这是证明 Webhook 调用或转发来自 easyCoexistence 的标头,格式为 t=<unix seconds>,v1=<HMAC-SHA256 of "<t>.<body>">,使用只有您持有的密钥生成。您的服务器在信任该请求之前,会重新计算并比对。
继续阅读
准备开始了吗?
几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间