WhatsApp 自動化リファレンス:トリガー、ステップ、変数、上限
easyCoexistence の WhatsApp 番号の自動化は、届いたメッセージ、タグが付いた連絡先、またはシステムからの呼び出しから始まります。メッセージのマッチ条件は 4 つです:Every message、Has keyword、First message、After hours。続いて、1 つのラインで最大 30、全体で最大 60 のステップを、分岐、質問、AI エージェントを含めて並べられます。1 件のメッセージに適用される自動化は最大 1 つで、キーワードのルールが先に評価されます。
1 つのラインのステップ数で、全体では 60、分岐は 4 階層までです。Stop と「Go back to a step」は、そのラインの最後のステップにのみ置けます。
キーワードは 1 件あたり最大 100 文字で、自動化ごとに登録できます。どれか 1 つに一致すれば十分で、大文字と小文字は区別しません。
Reply with AI ステップの Instructions で使える文字と、回答の上限(50 から 2,000 トークン)。
Wait ステップの 1 回の最長は 23 時間です。そのため、次のテキストのステップも Meta の 24 時間ウィンドウ内に収まります。
Call my webhook が失敗するまでに Webhook が応答しなければならない時間。応答に含まれる reply フィールドは、お客様に送信されます。
実行履歴の保存期間。各実行を開始したメッセージと返信も含まれます。メッセージテキストは、選択した保存期間(30 日、90 日、365 日、既定は 90 日)が過ぎると削除されます。
WhatsApp 自動化ではどのトリガーとマッチ条件を使えますか?
主なトリガーは「A message arrives」(message_received)です。お客様が番号にメッセージを送ると起動します。テキスト、写真、動画、ドキュメント、音声、スタンプ、位置情報、連絡先カード、ボタンとリストへの返信、注文が対象です。音声メッセージは、お客様の OpenAI または OpenRouter のキーで文字に起こされ、「[voice message]」に続けてその内容が保存されます。キーワードはこの内容に一致させることができます。このようなキーがない場合は「[voice message]」のままです。リアクション、ステータス、システム通知では実行は始まらず、Coexistence 番号ではグループチャットは API に届きません。メッセージから始まらないトリガーがさらに 2 つあります。「A contact gets a tag」(tag_added)は、番号で連絡可能な連絡先に、指定したタグが付くたびに起動します。タグは、フロー、AI エージェント、Conversations での手動操作、または update_contact で付けられます。「Your system calls a URL」(webhook_received)は、お客様のシステムが電話番号を含む JSON を自動化の URL に POST したときに起動し、新規注文や予約の際に使います。このとき自動化のシークレットを Bearer トークンとして使います。本文は最大 20 KB で、{{vars.webhook.*}} として使えます。どちらも {{message}} は空で、直近 24 時間以内にメッセージを送っていない相手には send_template しか送れません。スケジュールトリガーはありません。メッセージのトリガーの「After hours」では、「Open on」で選択した曜日の「From」から「To」までを営業時間として扱います。タイムゾーンは America/Sao_Paulo などの IANA タイムゾーンです。「To」が「From」より前の場合は日をまたぐ夜間シフトとなり(22:00 から 06:00 など)、チェックされていない曜日は終日休業として扱われます。API では hours に timezone、days(1 = 月曜日から 7 = 日曜日、営業する曜日)、start と end を指定します。「First message」は、easyCoexistence がそのチャットの記録を作成したときに起動します。具体的には、番号で自動化が有効になってから届いた最初のメッセージ(長年の顧客も含む)、または 30 日間の無音期間の後の最初のメッセージです。スマートフォンから開いたチャットは、すでに確認済みとして扱われます。
キーワードのマッチ方法はどのように決まりますか?
「Where the word has to be」で、Contains(「Anywhere in the message」)がデフォルトです。Starts with は「At the start」、Is exactly は「The whole message」に対応します。API では keywordMode が contains、starts_with、exact のいずれかです。マッチングではメッセージの前後の空白を取り除き、大文字と小文字は区別しません。ただし、アクセントや句読点は区別されます。Contains はより長い単語の内部にも一致します。キーワードの下にある「Test it」欄に任意のサンプルを入力すると、一致した場合は「Runs: it matches」、一致するキーワードがない場合は「Does not run: no keyword matches」と表示されます。
| 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? |
各ステップは何をするもので、どの項目を受け取りますか?
ステップは上から下へ実行され、1 つのラインに最大 30 個、分岐を含めて自動化 1 件あたり最大 60 個です。少なくとも 1 つは Wait、Stop、Split into paths、AI picks the path、Go back to a step 以外の処理を行う必要があります。分岐するステップには、パスごとのステップのラインと Otherwise のラインがあり、分岐は 4 階層までネストできます。「Choose a step」メニューでは、各ステップに名前と短い説明が表示されます(基本の 6 つのステップについて以下に引用します)。Ask a question(ask)は、最大 10 個のボタン付きで「Message」を送信します。そのうち 3 つはタップできるボタンとして表示され、それ以上はリストで示されて番号で回答します。回答を最大 1,380 分待ち、テキスト、メールアドレス、数値、電話番号、またはボタンのいずれかとして連絡先の項目に保存します。誤った回答には、最大 3 回まで同じ質問が再送されます。Agent answers(agent)はメッセージをいずれかの AI エージェントに渡し、Send a picture or file(send_file)はファイルから画像または PDF を送信し、Hand to a person(handoff)はそのチャットでボットを 1 から 168 時間(既定は 24 時間)一時停止して、メールで通知します。Split into paths(condition)と AI picks the path(ai_decide)は、ルールまたは意味によって分岐します。AI saves details(ai_extract)、Save to contact(set_field)、Tag(tag)は連絡先の項目とタグを書き込み、Call an API(http_request)は任意の HTTPS API を呼び出して、その JSON の応答を {{vars.<name>...}} として保持します。Start automation(start_automation)は同じ相手に対して別の自動化を最大 3 階層まで実行し、Go back to a step(goto)はステップ ID へジャンプしてループさせ、Notify me(notify_owner)はメールで通知します。通知は自動化ごとに 1 時間あたり最大 20 通です。ステップが失敗すると、後続のステップはスキップされ、実行は Failed で終了します。Call my webhook は、event が「automation.step」、dry_run、run_id、番号、連絡先(wa_id、name)、メッセージ(id、type、text、at)、そのチャットの最近のメッセージ最大 10 件を含む JSON を POST します。リクエストは X-EC-Signature ヘッダーで署名されます。値は t=<unix>,v1=<HMAC-SHA256 of "<t>.<body>"> で、署名に使うのはステップの「Signing secret」です。URL は公開の HTTPS である必要があり、リダイレクトは追跡されません。
ステップでどの変数を使えますか?
4 つは実行を開始したメッセージから値が入り、二重の波括弧で書きます。{{contact.<field>}} は連絡先の項目を追加し(contact.name と contact.phone も使えます)、{{vars.<path>}} は前のステップが保存した内容、たとえば Call an API ステップの応答を追加します。Reply with text の「Message」、テンプレートの本文変数、Reply with AI の「Instructions」、そして Ask a question などほかのステップのテキストで使えます。テンプレートの変数では、「Insert:」のチップで追加します。不明な値(名前のないプロフィールなど)は空になります。テンプレートの送信では本文変数だけを位置で渡せるため、名前付き変数、ヘッダーの画像やヘッダー変数、変数を含むボタンのあるテンプレートは、まだ選択できません。空の変数があると、Meta が送信を拒否します。
- {{
first_name}}:WhatsApp プロフィール名の最初の単語(「First name」)。 - {{name}}:プロフィール名のフルネーム(「Full name」)。
- {{message}}:メッセージのテキスト、またはその代替表示(「[image]」など)とキャプション(「Their message」)。
- {{phone}}:お客様の番号を、プラス記号なしの国際形式の数字で表したもの(例:5511999998888)(「Their phone」)。
- テストでは、お客様は「テスト顧客」、電話番号は 15550000000 になります。
設定と既定値は何ですか?
設定は 2 つあり、エディターの On スイッチの横にある「Advanced」ボタンの下にあります。AI ステップにはさらに 2 つの設定があります。省略された項目には既定値が適用されます。これはエディターでも create_automation でも同じです。タイムアウトは設定可能ではなく固定です。AI の返信には 45 秒、Webhook には 20 秒が与えられます。自動化の名前は最大 120 文字です。AI エージェントには独自の設定があります。読み込む過去のメッセージは 0 から 40 件(既定は 20)、返信の最大長は 100 から 4,000 トークン(既定は 800)、1 回の回答あたりのツール呼び出しは最大 10 回(既定は 5)、引き継ぎ時間は 1 から 168 時間(既定は 24)です。
複数の自動化が一致したとき、どれが応答しますか?
一度に応答するのは最大 1 つで、固定の順序で選ばれます。まず Has keyword、次に First message、次に After hours、最後に Every message です。同じ種類の中では、最も古い自動化が優先されます。オンで一時停止されていない自動化だけが競合します。そのため、キーワードのルールがオフの場合、または AI キーが拒否されたため一時停止中の場合は、キャッチオールの自動化が代わりに応答します。意外に感じられる結果が 2 つあります。夜間に書き込んだ新規のお客様は、After hours ではなく First message の自動化を受け取ります。First message の方が優先順位が高いためです。また、キーワードの自動化が応答したメッセージは、AI エージェントにも、Every message の Reply with AI ステップにも届きません。両方を使いたい場合は、エージェントまたは AI ステップをキーワードの自動化の中に入れてください。未回答の Ask a question ステップに答えるメッセージはその質問のものとなり、ほかの自動化はそれをきっかけに起動しません。タグと Webhook の自動化はそれぞれ独自のイベントから起動し、この順序には関与しません。
どの組み込みガードがありますか?
ランナーは設定なしでこれらを適用します。停止させた場合、Runs タブのスキップ理由にそのガードの名前が表示されます:
- Meta が 2 回配信したメッセージは、1 回の実行として扱われます。重複はメッセージ ID で除外されます。
- リアクション、ステータス、自動化自身の送信、アプリからの送信エコーは、実行を開始しません。
- Reply with text、Ask a question、Send a picture or file、Reply with AI、エージェントの回答、Webhook の返信には、お客様の最後のメッセージから 24 時間以内であることが必要です。Send a template はこの条件の対象外です。
- WhatsApp Business アプリで返信すると、そのチャットの自動化は一時停止し、待機中の実行は残りのステップをスキップします。
- 同じチャットで同じ自動化を開始する新しいメッセージは、そのチャットで Wait ステップにより待機中の実行を置き換えます。未回答の質問に答えるメッセージは、代わりにその質問に渡されます。
- 番号からの送信は、少なくとも 100 ms 間隔を空けます。これは、Coexistence 番号に対する Meta の毎秒 20 件を下回るためです。
- ステップが失敗すると、自動化ごとに 6 時間に 1 回まで、メールで通知されます。AI キーが拒否された場合は、そのプロバイダーを使う自動化を一時停止し、メールを 1 通送信します。
create_automation ツールは何を受け取りますか?
MCP コネクターには、自動化とその利用対象のための 19 個のツールがあります。8 つは自動化用です:set_inbound_mode、list_automations、create_automation、update_automation、delete_automation、test_automation、list_automation_runs、get_automation_run です。8 つはエージェントとファイル用です:list_agents、list_files、create_agent、update_agent、delete_agent、add_agent_knowledge、delete_agent_knowledge、test_agent です。3 つは人用です:list_conversations、get_conversation、update_contact です。create_automation は connection_id(list_numbers から取得)、name、enabled、trigger、steps、settings を受け取ります。項目名はこのページで使われているもので、keyword_mode や max_tokens のような snake_case です。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 分間の Wait により、一度に数行を送るお客様が 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 }
}よくある間違い
- 2 文字のキーワードを Contains で使うこと。「oi」は「noite」や「boi」にも一致するため、対象外のメッセージに応答してしまいます。Is exactly を使うか、より長いキーワードにしてください。
- アクセント付きの綴りだけを登録すること。マッチングは大文字と小文字を区別しませんが、アクセントは区別するため、「preço」では「preco」と入力したお客様に一致しません。両方を追加してください。
- 「First message」が常連客を除外すると想定すること。30 日間 easyCoexistence が見ていないチャットであれば、どのお客様にも起動します。そのため、長年のお客様も、機能を有効にした後の最初のメッセージで歓迎メッセージを受け取ります。
- ヘッダーの画像やコピーコードボタンが必要なテンプレートを選ぶこと。自動化は本文変数のみを埋めるため、エディターは一覧に表示しますが、選択はできません。MCP で設定した場合、Meta が送信を拒否し、実行は失敗します。
easyCoexistence は、アプリで使い続けている WhatsApp Business 番号で、これらの自動化を実行します。Meta の Cloud API と Coexistence を経由します。エディターの Automations で New automation を選んで作成するか、ChatGPT や Claude に MCP コネクター経由で create_automation と test_automation を呼び出させることもできます。MCP コネクターは 30 を超えるツールを備えています。料金は接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
自動化の中で、お客様の発言によって分岐できますか?
はい。Split into paths(condition)は、メッセージのテキスト、連絡先の項目、タグ、前の API の応答、営業時間によって分岐します。AI picks the path(ai_decide)は、あなた自身のモデルで、どの言語でも意味に基づいて選びます。各パスには独自のステップのラインがあり、Otherwise のラインが残りを受け止めます。また、Call my webhook で n8n やバックエンドに判断を任せ、ケースごとに異なる {"reply": "..."} を返してもらうこともできます。
自動化や実行数に上限はありますか?
実行数に上限はなく、追加料金もかかりません。番号あたりの自動化数にも上限はありません。適用される制限はチャット単位です。AI の返信は 1 時間あたりの回数、テキストに関する Meta の 24 時間ルール、そしてスマートフォンから返信した後の一時停止です。
自動化を別の番号に移動またはコピーできますか?
エディターで「接続」を変更するか、update_automation で新しい connection_id を指定すれば移動できます。古い番号で待機中の実行は、「superseded」として終了します。コピーするには、AI に list_automations で読み取らせ、別の番号に同じトリガーとステップを作成させてください。
自動化を編集すると、待機中の実行はどうなりますか?
そのまま続行します。Wait で待機中の実行は、起動時点で保存されている自動化の次のステップ番号から再開します。そのため、編集によって送信内容が変わることがあります。停止させるには、自動化をオフにします。その場合、実行は「Automation is off」で Skipped として終了します。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日