登入開始免費試用
Meta Tech Provider

WhatsApp 自動化參考:觸發條件、步驟、變數與限制

easyCoexistence 在 WhatsApp 號碼上的自動化,由收到的訊息、獲得標籤的聯絡人,或你的系統發出的呼叫啟動。訊息設有四種配對:「所有訊息」、「有關鍵字」、「首則訊息」及「非辦公時間」。之後是步驟,一條線最多 30 個、全部最多 60 個,包含分支、問題與 AI 代理。每則訊息最多只會觸發一個自動化,關鍵字規則優先。

30 steps

一條線的步驟數,全部最多 60 個,分支最多巢狀 4 層;「停止」與「返回某一步」只可作為其所在線的最後一個步驟。

30 keywords

每個自動化中,每個關鍵字最多 100 個字元;任何一個符合即可,且不分大小寫。

20,000

「以 AI 回覆」步驟的指示所容許的字元;其回覆上限為 50 至 2,000 個 token。

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。「你的系統呼叫網址」(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 天無往來後的第一則訊息。你已在手機上開啟的聊天,已視為已見過。

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 個顯示為可點選按鈕,其餘則列成清單並以編號作答;最長等待 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,且不會跟隨重新導向。

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 至 4,000 詞元(預設 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」的客戶;兩種拼寫都要加入。
  • 以為「首則訊息」會略過常客。它會為任何在 30 天內未被 easyCoexistence 見過聊天的客戶啟動,因此長期客戶在你啟用後的第一則訊息,也會收到歡迎訊息。
  • 選擇了需要標頭圖片或「複製驗證碼」按鈕的範本。自動化只會填寫內文變數,因此編輯器會列出該範本,但不允許你選取;若透過 MCP 設定,Meta 會拒絕發送,執行亦會失敗。
使用 EasyCoexistence 完成這項設定

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,而非幾個月。應用程式在手機上仍可繼續運作。

開始免費試用

驗證日期