登录开始免费试用
Meta Tech Provider

WhatsApp 自动化术语表:触发器、步骤、接管、24 小时窗口等

WhatsApp 自动化有一套自己的术语。触发器决定什么会启动自动化:一条消息、一个标签或一次 Webhook 调用;步骤决定回复什么内容;当有人从手机上回复时,接管会暂停自动化;24 小时窗口则决定除模板以外的哪些回复可以发出。模板、选择加入、运行状态、跳过原因和带签名的 Webhook 构成完整的图景,本页每个术语各用一行说明。

easyCoexistence 通过 Coexistence 将您的 WhatsApp Business 号码连接到 Meta 的 Cloud API,并依托上述术语在其上运行自动化:四种匹配方式、19 种步骤类型、您从手机回复时的接管,以及附带跳过原因的 30 天运行日志。

4 matches

WhatsApp 自动化筛选收到消息的方式:所有消息、含关键词、首条消息和非营业时间。

19 steps

号码上的步骤类型,从以文本回复、发送模板,到提问、拆分为多条路径和智能体回答。

30 steps

一个自动化的一条线路最多可容纳 60 个步骤,分支最多可嵌套 4 层。

24 hours

Meta 的客户服务窗口:非模板消息只能在客户最后一条消息之后的 24 小时内发送。

3 categories

Meta 的模板类别:营销、实用和身份验证。

15 reasons

运行可能显示的跳过原因,从近期从手机上的回复到 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_echoes Webhook,用于报告您从应用或已关联设备发送的消息。
  • 接管:您在手机上或在“对话”中回复后的暂停时段,在“回复后暂停该聊天(小时)”中设置,默认 4,可设为 0 至 168。
  • AI 回复上限:“每个聊天每小时最多 AI 回复数”,默认 10,可设为 1 至 60。
  • 词元:AI 服务商计费的单位;“最长回复(词元)”限制单条回复的长度,默认 600,可设为 50 至 2,000。
  • 14 天规则:若号码对应的应用约 14 天未在手机上打开,Meta 会断开其 Coexistence 连接。

运行日志相关术语是什么意思?

每当自动化因一条消息启动,就会在“运行”标签页中留下一条运行记录,保留 30 天,并包含每个步骤的输出、耗时和词元。以下术语说明您在其中看到的内容:

  • 运行:自动化对一条收到的消息、一个标签或一次 Webhook 调用,或一次测试执行的一次执行。
  • 运行状态:排队中、运行中、等待中(停留在“等待”步骤中)、已完成、失败或已跳过。
  • 跳过原因:运行被有意停止的原因,例如“您最近已在手机上回复此聊天”。
  • 测试 / 试运行:对示例消息运行已保存的步骤;不会发送任何内容,但 AI 和 Webhook 会实际运行。
  • 已暂停:自动化的状态,表示其 AI 密钥被服务商拒绝;保存有效密钥后即会重新启动。
  • 已被取代:等待中的运行被取消,因为客户更新的一条消息再次启动了同一自动化。

常见错误

  • 把已暂停误读为已关闭。已暂停表示 AI 密钥已失效;保存有效密钥后,自动化会自行重新启动,而已关闭则需您手动切换才会重新开启。
  • 把应用的离开自动回复与非营业时间视为同一回事。前者位于手机应用中,软件无法看到;后者是 API 端的一项自动化。
  • 以为首条消息只会针对全新联系人触发。实际上,任何没有已存储历史记录的聊天都会触发,包括常客。
使用 EasyCoexistence 完成这些操作

您可以在编辑器中自行搭建,也可以让 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,而不是几个月。应用会继续在手机上运行。

开始免费试用

验证时间