登录开始免费试用
Meta Tech Provider

WhatsApp 自动化参考:触发、步骤、变量与限制

easyCoexistence 在 WhatsApp 号码上的自动化可由收到的消息、获得标签的联系人或您系统的调用启动。消息有四种匹配:“每条消息”、“含关键词”、“首条消息”和“非营业时间”。之后是步骤,一条线路最多 30 个、总共最多 60 个,包含分支、提问和 AI 智能体。每条消息最多触发一个自动化,关键词规则优先。

30 steps

一条线路中的步骤数,总共最多 60 个,分支嵌套最多 4 层;“停止”和“返回某一步”只能作为线路的最后一步。

30 keywords

每个自动化的关键词各最多 100 个字符;匹配其中任意一个即可,且大小写无关。

20,000

AI 回复步骤的“指令”中允许使用的字符,其回复上限为 50 至 2,000 个词元。

1,380 min

单个等待步骤最长为 23 小时,确保下一条文本步骤仍落在 Meta 的 24 小时窗口内。

20 seconds

Webhook 须在此时限内作出响应,否则“调用我的 Webhook”失败;响应中的 reply 字段会发送给客户。

30 days

运行记录的保存时长,包括每条触发消息及回复;消息文本在所选的保留期后删除(可选 30、90 或 365 天,默认 90 天)。

WhatsApp 自动化可以使用哪些触发条件和匹配方式?

主要触发器“收到消息”(message_received),客户向号码发来内容时即触发:文本、图片、视频、文档、音频、贴纸、位置、联系人卡片、按钮与列表回复,以及订单。语音消息会通过你的 OpenAI 或 OpenRouter 密钥转写,并存为“[voice message]”加上转写的文字,关键词可以匹配这些文字;没有此类密钥时仍只是“[voice message]”。表情回应、状态与系统通知不会启动运行;在 Coexistence 号码上,群聊不会通过 API 送达。另有两个触发器并非由消息启动。“联系人获得标签”(tag_added)会在号码上可联系的联系人每次获得你指定的标签时触发,无论标签来自流程、AI 智能体、你在“对话”中的操作,还是 update_contact。“你的系统调用某个 URL”(webhook_received)会在你自己的系统向该自动化的 URL 以 POST 发送含电话号码的 JSON 时触发,并以该自动化的密钥作为 Bearer 令牌,适用于新订单或预约;请求体最大 20 KB,可用作 {{vars.webhook.*}}。在这两种触发器中,{{message}} 为空,且过去 24 小时内没有发来消息的人只能收到 send_template。没有定时触发器。在消息触发器上,“非营业时间”会将“营业日”中勾选的日期视为在“开始”与“结束”之间营业,时区采用 America/Sao_Paulo 等 IANA 时区;“结束”早于“开始”即为跨夜班次(22:00 至 06:00),未勾选的日期全天视为休息。在 API 中,hours 包含 timezone、days(1 为周一,7 为周日,即营业的日期)以及 start 与 end。“首条消息”会在 easyCoexistence 为该聊天创建记录时触发:即自动化在号码上开启后,客户发来的第一条消息(长期客户也包括在内),或在 30 天未联系后的第一条消息。在手机上打开过的聊天已计为已读。

Every message (any)Runs on whatever the customer writes, when no more specific automation matched.
Has keyword (keyword)Runs when the message holds one of up to 30 keywords, in one of three modes.
First message (first_message)Runs on a chat easyCoexistence has not seen, or after 30 days without a message from that customer.
After hours (outside_hours)Runs while you are closed: Timezone, Open on days, and From and To in 24-hour HH:MM.

关键词模式如何匹配?

在“关键词位置”下,“包含”(“消息中任何位置”)为默认选项,“开头位置”对应以关键词开头的匹配,“完全一致”对应“整条消息”;在 API 中,keywordMode 可取 contains、starts_with 或 exact。匹配时会去除消息首尾的空格,且不区分大小写,但不忽略重音符号和标点;“包含”还会匹配较长单词的内部。关键词下方的“测试”框会针对你输入的任意示例显示结果:“运行:匹配”并附上关键词,或“不运行:没有关键词匹配”。

MatchesDoes not match
Contains "price"What is the price? · PRICES pleaseHow much is it?
Contains "oi"Oi! · Boa noite (inside noite)Olá
Starts with "menu"Menu pleaseCan I see the menu?
Is exactly "menu"Menu · menu with spaces around itmenu? · the menu
Contains "preço"Qual o preço?Qual o preco?

每个步骤做什么,需要哪些字段?

步骤从上到下依次执行,一条线最多 30 个步骤,每个自动化最多 60 个(含分支),且至少有一个步骤要执行“等待”“停止”“分路”“AI 选路”和“返回步骤”以外的操作。分支步骤为每条路径设一条步骤线,另加一条“否则”线,分支最多嵌套 4 层。在“选择步骤”菜单中,每个步骤都显示名称和一行简短说明,下文引用了六个基础步骤的名称和说明。“提问”(ask)会发送其消息,附带最多 10 个按钮,其中 3 个显示为可点按的按钮,其余的以列表形式给出并按编号回答;它最长等待 1380 分钟获取回答,并将回答保存到联系人字段,类型可为文本、电子邮件、数字、电话或其中一个按钮;回答不符时会重复提问,最多 3 次。“智能体回答”(agent)将消息交给你的某个 AI 智能体,“发送图片或文件”(send_file)从你的文件中发送图片或 PDF,“转人工”(handoff)会在该聊天上暂停机器人 1 至 168 小时(默认 24 小时),并给你发送电子邮件。“分路”(condition)和“AI 选路”(ai_decide)按规则或按语义分支。“AI 保存信息”(ai_extract)、“保存到联系人”(set_field)和“标签”(tag)会写入联系人字段和标签,“调用 API”(http_request)可调用任意 HTTPS API,并将其 JSON 返回结果保存为 {{vars.<name>...}}。“启动自动化”(start_automation)会为同一个人运行另一个自动化,最多嵌套 3 层,“返回步骤”(goto)会跳到某个步骤 id 以实现循环,“通知我”(notify_owner)会给你发送电子邮件,每个自动化每小时最多 20 封。若某步骤失败,其后的步骤将被跳过,运行结束并标记为“失败”。“调用我的 Webhook”会以 POST 方式发送 JSON 负载,其中 event 为 "automation.step",并包含 dry_run、run_id、号码、联系人(wa_id、name)、消息(id、type、text、at)以及该聊天中最近最多 10 条消息。请求会在 X-EC-Signature 中签名,格式为 t=<unix>,v1=<以“<t>.<body>”计算的 HMAC-SHA256>,密钥为该步骤的“签名密钥”。其 URL 必须为公开的 HTTPS 地址,且不跟随重定向。

Reply with text (reply_text)"Send a fixed message": a Message of up to 4,096 characters, with variables.
Send a template (send_template)"Send an approved template": Template name, Language code, up to 20 body variables by position.
Reply with AI (ai_reply)"Your AI writes the reply": Provider, Model, Instructions, Earlier messages it reads, Longest reply (tokens).
Call my webhook (call_webhook)"Hand off to n8n or your backend": a Webhook URL; {"reply": "..."} returned within 20 seconds is sent.
Wait (wait)"Pause before the next step": 1 to 1,380 Minutes; your reply from the phone skips the rest.
Stop (stop)"End the automation": allowed only as the last step of its line.

步骤可以填入哪些变量?

其中四个取自触发该运行的消息,用双花括号书写;{{contact.<field>}} 添加联系人字段(也包括 contact.name 和 contact.phone),{{vars.<path>}} 添加之前步骤保存的内容,例如“调用 API”步骤的返回结果。它们可用于“回复文本”的消息内容、消息模板的正文变量、AI 回复的“指令”,以及“提问”等其他步骤的文本;在模板的变量中,“插入:”标签可添加它们。若某个值未知(例如个人资料没有名称),则替换为空。模板发送只支持按位置传递正文变量,因此带有命名变量、页眉图片或页眉变量、或带变量按钮的模板目前无法选择,而留空的变量会导致 Meta 拒绝发送。

  • {{first_name}}:客户 WhatsApp 个人资料名称的第一个词(“名字”)。
  • {{name}}:完整的个人资料名称(“全名”)。
  • {{message}}:消息文本;若为非文本消息,则为占位符,例如“[image]”加上说明文字(“客户消息”)。
  • {{phone}}:客户号码的国际格式数字,不含加号,例如 5511999998888(“客户号码”)。
  • 在测试中,客户为“测试客户”,号码为 15550000000。

设置项及其默认值是什么?

有两项设置位于编辑器中开关旁的“高级”下,AI 步骤另有两项自有设置。未填写的字段采用默认值,在编辑器中与通过 create_automation 设置时均如此。超时时间为固定值而非可设置项:AI 回复为 45 秒,Webhook 为 20 秒。自动化的名称最多 120 个字符。AI 智能体有自己的设置:读取此前消息数 0 至 40(默认 20)、最长回复 100 至 4000 个令牌(默认 800)、每次回答最多调用 10 次工具(默认 5)以及转人工时长 1 至 168 小时(默认 24)。

Pause on a chat after I answer it (hours)takeoverHours, 0 to 168, default 4. 0 turns the pause off; a reply still ends a waiting step.
AI replies per chat per hour, at mostaiMaxPerHour, 1 to 60, default 10, counted per chat in a one-hour window.
Earlier messages it readshistory, 0 to 20, default 10, from the messages kept for that chat.
Longest reply (tokens)maxTokens, 50 to 2,000, default 600. An answer that reaches it stops there.
The On and Off switchenabled, default true: a new automation saves On, in the editor and through create_automation.
Try itSamples of up to 2,000 characters, 60 tests per hour in the dashboard.

多个自动化匹配时,由哪一个回复?

最多只有一个,按固定顺序选择:先是“含关键词”,其次“首条消息”,再次“非营业时间”,最后是“每条消息”;同一类中则是最早创建的自动化优先。只有处于“开启”且未暂停的自动化参与竞争,因此当关键词规则为“关闭”,或因 AI 密钥被拒而暂停时,兜底规则将负责回复。有两点常令人意外。第一,夜间来的新客户会触发“首条消息”自动化,而非“非营业时间”自动化,因为“首条消息”优先级更高。第二,关键词自动化已回复的消息不会再到达 AI 智能体,也不会到达“每条消息”上的“AI 回复”步骤,因此若两者都需要,请把智能体或 AI 步骤放进关键词自动化中。回答未完成的“提问”步骤的消息属于该问题,不会因它启动其他自动化。标签和 Webhook 自动化由各自的事件启动,不参与这一顺序。

内置了哪些防护措施?

运行器无需任何设置即可应用这些防护,运行记录标签页中的跳过原因会在它们停止运行时注明:

  • Meta 重复投递的消息只启动一次运行:按消息 ID 去重。
  • 表情回应、状态、自动化自身发出的消息,以及你在应用中发送的消息回显,都不会启动运行。
  • “回复文本”、“提问”、“发送图片或文件”、“AI 回复”、智能体的回答以及 Webhook 的回复,都要求客户的最后一条消息在 24 小时以内;“发送消息模板”则不受此限。
  • 你在 WhatsApp Business 应用中输入的回复会暂停该聊天上的自动化,正在等待的运行将跳过其余步骤。
  • 在同一聊天上,若有新消息再次启动同一自动化,将取代仍停留在“等待”步骤中的运行;回答未完成问题的消息则转给该问题。
  • 号码发送的间隔至少为 100 毫秒,低于 Meta 对 Coexistence 号码每秒 20 条的限制。
  • 步骤失败时,系统会向你发送邮件,每个自动化每 6 小时最多一封;AI 密钥被拒时,会暂停使用该提供商的自动化,并发送一封邮件。

create_automation 工具接受哪些参数?

MCP 连接器提供十九个用于自动化及其所用内容的工具。八个用于自动化:set_inbound_mode、list_automations、create_automation、update_automation、delete_automation、test_automation、list_automation_runs 和 get_automation_run。八个用于智能体和文件:list_agents、list_files、create_agent、update_agent、delete_agent、add_agent_knowledge、delete_agent_knowledge 和 test_agent。三个用于人员:list_conversations、get_conversation 和 update_contact。create_automation 接受 connection_id(来自 list_numbers)、name、enabled、trigger、steps 和 settings,采用 snake_case 命名,如 keyword_mode 和 max_tokens;同时也接受 camelCase。步骤对象为 reply_text {text}、send_template {name, language, params}、ai_reply {provider, model, prompt, history, max_tokens}、call_webhook {url} 和 wait {minutes},此外还有 ask {text, buttons, save_to, expect, retry_text, wait_minutes}、agent {agent_id, wait_seconds}、send_file {file_id, caption}、condition {paths, otherwise}、ai_decide {provider, model, instructions, paths, otherwise}、ai_extract {provider, model, fields}、set_field {key, value}、tag {action, tag}、http_request {method, url, headers, body, save_as}、start_automation {automation_id}、handoff {hours, note}、notify_owner {text}、goto {to} 和 stop。update_automation 会保留你未填写的字段;若提供 steps,则会整体替换整个列表。错误信息会指出相关字段,例如“trigger.keywords: Add at least one keyword”、“steps.2: Stop must be the last step of its line”或“steps.0: save your openai API key on the Automations page first”。AI 密钥从不经过 MCP。在示例中,1 分钟的等待步骤可让一次发送多行消息的客户只收到一次回复。

create_automation arguments: an after-hours AI assistant, saved Off to test first
{
  "connection_id": "<connection_id from list_numbers>",
  "name": "After-hours assistant",
  "enabled": false,
  "trigger": {
    "type": "message_received",
    "match": "outside_hours",
    "hours": {
      "timezone": "America/Sao_Paulo",
      "days": [1, 2, 3, 4, 5, 6],
      "start": "08:00",
      "end": "18:00"
    }
  },
  "steps": [
    { "type": "wait", "minutes": 1 },
    {
      "type": "ai_reply",
      "provider": "openrouter",
      "model": "google/gemini-omni-1.2-flash",
      "prompt": "You are the assistant of Ana's Bakery. We are closed and open at 8:00. Answer questions about products; a person confirms orders in the morning.",
      "history": 10,
      "max_tokens": 600
    }
  ],
  "settings": { "takeover_hours": 4, "ai_max_per_hour": 10 }
}

常见错误

  • 使用两个字母的关键词并选择“包含”。“oi”也会匹配“noite”和“boi”,于是自动化会回复本不该回复的消息。请改用“完全一致”,或更长的关键词。
  • 只列出带重音的拼写。匹配不区分大小写,但区分重音,因此“preço”无法匹配输入“preco”的客户;两种写法都要添加。
  • 以为“首条消息”会跳过老客户。它会针对任何 easyCoexistence 在 30 天内未见过其聊天的客户触发,因此长期客户在你开启后的首条消息时也会收到欢迎语。
  • 选择了需要页眉图片或复制验证码按钮的消息模板。自动化只填充正文变量,因此编辑器会列出该模板但不允许选择;若通过 MCP 设置,发送会被 Meta 拒绝,运行失败。
使用 EasyCoexistence 完成这些操作

easyCoexistence 在你于应用中继续使用的 WhatsApp Business 号码上运行这些自动化,通过 Meta 的 Cloud API 和 Coexistence 实现。你可以在编辑器的“自动化”下点击“新建自动化”来创建,也可以让 ChatGPT 或 Claude 通过 MCP 连接器调用 create_automation 和 test_automation,该连接器提供 30 多个工具。每个号码每月 US$ 9 起,最低降至 US$ 0.75,号码越多价格越低,并提供 3 天免费试用。

常见问题

自动化能否根据客户说的内容进行分支?

可以。“分路”(condition)可按消息文本、联系人字段、标签、之前的 API 返回结果或你的营业时间分支,“AI 选路”(ai_decide)则在你自己的模型上按语义选择,支持任何语言。每条路径有自己的步骤线,“否则”线接住其余情况。你也可以借助“调用我的 Webhook”将决策交给 n8n 或你的后端,由其为每种情况返回不同的 {"reply": "..."}。

自动化或运行次数有限制吗?

运行次数没有上限,也不额外收费,每个号码可拥有的自动化数量同样没有上限。实际适用的限制以聊天为单位:每小时 AI 回复数、Meta 的 24 小时文本规则,以及你在手机上回复后的暂停时间。

能否将自动化迁移或复制到另一个号码?

迁移时,可在编辑器中更改其“连接”,或使用 update_automation 并提供新的 connection_id;仍在等待旧号码上的运行会以“已被取代”结束。要复制,请让你的 AI 通过 list_automations 读取该自动化,并在另一个号码上创建相同的触发器和步骤。

编辑自动化时,等待中的运行会怎样?

它们会继续执行。停在“等待”上的运行,会在唤醒时按自动化当前保存的版本,从下一步骤编号继续,因此修改可能改变其发送内容。若要停止它们,请将自动化关闭:它们将以“已跳过”结束,并显示“自动化已关闭”。

继续阅读

准备开始了吗?

几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。

开始免费试用

验证时间