WhatsApp 自动化参考:触发、步骤、变量与限制
easyCoexistence 在 WhatsApp 号码上的自动化可由收到的消息、获得标签的联系人或您系统的调用启动。消息有四种匹配:“每条消息”、“含关键词”、“首条消息”和“非营业时间”。之后是步骤,一条线路最多 30 个、总共最多 60 个,包含分支、提问和 AI 智能体。每条消息最多触发一个自动化,关键词规则优先。
一条线路中的步骤数,总共最多 60 个,分支嵌套最多 4 层;“停止”和“返回某一步”只能作为线路的最后一步。
每个自动化的关键词各最多 100 个字符;匹配其中任意一个即可,且大小写无关。
AI 回复步骤的“指令”中允许使用的字符,其回复上限为 50 至 2,000 个词元。
单个等待步骤最长为 23 小时,确保下一条文本步骤仍落在 Meta 的 24 小时窗口内。
Webhook 须在此时限内作出响应,否则“调用我的 Webhook”失败;响应中的 reply 字段会发送给客户。
运行记录的保存时长,包括每条触发消息及回复;消息文本在所选的保留期后删除(可选 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 天未联系后的第一条消息。在手机上打开过的聊天已计为已读。
关键词模式如何匹配?
在“关键词位置”下,“包含”(“消息中任何位置”)为默认选项,“开头位置”对应以关键词开头的匹配,“完全一致”对应“整条消息”;在 API 中,keywordMode 可取 contains、starts_with 或 exact。匹配时会去除消息首尾的空格,且不区分大小写,但不忽略重音符号和标点;“包含”还会匹配较长单词的内部。关键词下方的“测试”框会针对你输入的任意示例显示结果:“运行:匹配”并附上关键词,或“不运行:没有关键词匹配”。
| Matches | Does not match | |
|---|---|---|
| Contains "price" | What is the price? · PRICES please | How much is it? |
| Contains "oi" | Oi! · Boa noite (inside noite) | Olá |
| Starts with "menu" | Menu please | Can I see the menu? |
| Is exactly "menu" | Menu · menu with spaces around it | menu? · 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 地址,且不跟随重定向。
步骤可以填入哪些变量?
其中四个取自触发该运行的消息,用双花括号书写;{{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)。
多个自动化匹配时,由哪一个回复?
最多只有一个,按固定顺序选择:先是“含关键词”,其次“首条消息”,再次“非营业时间”,最后是“每条消息”;同一类中则是最早创建的自动化优先。只有处于“开启”且未暂停的自动化参与竞争,因此当关键词规则为“关闭”,或因 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 分钟的等待步骤可让一次发送多行消息的客户只收到一次回复。
{
"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 在你于应用中继续使用的 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,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间