WhatsApp 自動化參考:觸發條件、步驟、變數與限制
easyCoexistence 在 WhatsApp 號碼上的自動化,由收到的訊息、獲得標籤的聯絡人,或你的系統發出的呼叫啟動。訊息設有四種配對:「所有訊息」、「有關鍵字」、「首則訊息」及「非辦公時間」。之後是步驟,一條線最多 30 個、全部最多 60 個,包含分支、問題與 AI 代理。每則訊息最多只會觸發一個自動化,關鍵字規則優先。
一條線的步驟數,全部最多 60 個,分支最多巢狀 4 層;「停止」與「返回某一步」只可作為其所在線的最後一個步驟。
每個自動化中,每個關鍵字最多 100 個字元;任何一個符合即可,且不分大小寫。
「以 AI 回覆」步驟的指示所容許的字元;其回覆上限為 50 至 2,000 個 token。
最長的單一「等待」步驟為 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。「你的系統呼叫網址」(webhook_received)會在你自己的系統以 POST 方式把含電話號碼的 JSON 傳送至該自動化的網址時啟動,並以該自動化的密鑰作為 Bearer 權杖,適用於新訂單或預約;內容最多 20 KB,可用 {{vars.webhook.*}} 取得。兩者中,{{message}} 皆為空,而過去 24 小時內沒有發訊的人,只能收到 send_template。不設排程觸發條件。在訊息觸發條件上,「非辦公時間」會把在「開放日」下勾選的日子,視為在「由」與「至」之間開放,時區採用 IANA 時區,例如 America/Sao_Paulo;「至」早於「由」即為跨夜班次(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 個顯示為可點選按鈕,其餘則列成清單並以編號作答;最長等待 1,380 分鐘以取得答案,並把答案以文字、電子郵件、數字、電話或其中一個按鈕的形式儲存至聯絡人欄位;答錯時會重新詢問,最多 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=<HMAC-SHA256 of "<t>.<body>"> 簽署,使用該步驟的「簽署密鑰」。其網址必須為公開的 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 至 4,000 詞元(預設 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」的客戶;兩種拼寫都要加入。
- 以為「首則訊息」會略過常客。它會為任何在 30 天內未被 easyCoexistence 見過聊天的客戶啟動,因此長期客戶在你啟用後的第一則訊息,也會收到歡迎訊息。
- 選擇了需要標頭圖片或「複製驗證碼」按鈕的範本。自動化只會填寫內文變數,因此編輯器會列出該範本,但不允許你選取;若透過 MCP 設定,Meta 會拒絕發送,執行亦會失敗。
easyCoexistence 透過 Meta 的 Cloud API 及 Coexistence,在你於應用程式中繼續使用的 WhatsApp Business 號碼上執行這些自動化。你可在編輯器的「自動化」下按「新增自動化」來建立,或讓 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 讀取它,並在另一號碼上建立相同的觸發條件及步驟。
編輯自動化時,等待中的執行會怎樣?
它們會繼續執行。停在「等待」步驟的執行,於喚醒時會以儲存後的自動化的下一個步驟編號續行,因此編輯可能會改變其發送的內容。若要停止它們,請將自動化「關閉」:它們會以「已略過」結束,並顯示「Automation is off」。
繼續閱讀
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期