自動化 #

自動化を使用すると、Zapierやn8nのように、連絡先や会話向けに構築されたマルチステップのワークフローを構築できます。

オートメーションはすべてのアカウントで利用可能です。すでにサイドバーに表示されており、有効化やリクエストの手続きは不要です。

自動化 とはワークフローのことです。開始のきっかけとなる1つの トリガー と、その後に順番に実行される（または条件に基づいて分岐する）任意の数の ステップ で構成されます。「オープニングメッセージを送信し、返信をエージェントに引き継ぐ」といった単純な処理以上の、マルチステップのシーケンス、データ検索、外部ツールとの連携、連絡先の行動に応じた条件分岐などを行うためのツールです。

場所: サイドバーの AI Studio グループの下にある 自動化 をクリックします。

自動化の作成 #

最初の自動化を作成（すでに作成済みの場合は 新しい自動化）をクリックします。空のキャンバスが表示され、以下の2つの方法で構築できます。

• 平易な英語で説明する。 プロンプトボックスにやりたいことを入力します（例：「1時間以内に返信がない場合はフォローアップを送る」、「価格について問い合わせた連絡先にタグを付ける」、「AIエージェントが注文ステータスを検索できるようにする」など）。すると、トリガーとステップ（AIエージェントが呼び出せるAIエージェント機能ツールを含む）が自動的に構築されます。その後もチャットを続けて結果を調整できます。何を依頼すればよいかわからない場合は、ボックスの下に例が表示されています。いずれかをクリックしてボックスに挿入し、そこから編集するか、More ideasをクリックして他の例を表示できます。入力中、ボックスには文の続きがカーソルの先にグレーで提案されます。Tabキーを押すと提案を採用でき、そのまま入力し続ければ無視されます。

• 手動で構築する。 左側のパネルからパーツをキャンバスにドラッグしてつなぎ合わせます。ステップ上の + は双方向に機能します。ドラッグして引っ張るとポインターに線が追従し、離した場所に次のステップが作成され、自動的に接続されます。または、クリックして小さなピッカーを開き、その場所にステップを挿入することもできます。出力ドットからドラッグして同様の操作を行うこともでき、ピッカー内のアイテムを直接キャンバスにドラッグすることも可能です。ピッカーの検索ボックスに入力すると、組み込みアクション、接続済みアプリ、ロジックステップなど、すべてを一度に検索できるため、どこに何があるかを知っておく必要はありません。左側のパネルの上部にも同じ検索ボックスがあり、「loop」、「webhook」、またはアプリ名を入力すると、トリガー、アクション、アプリ、ロジックのすべてのセクションが一度にフィルタリングされます。

• Champに依頼する。 どのページからでも、アプリ内のヘルパーにやりたいことを伝えると（「誰かが予約したらタグ付けして、前日にリマインダーを送る」、「私がチャットを引き継いでから2時間後にAIをオンに戻す」など）、Champが自動化を作成します。以下のChampに作成や修正を依頼するを参照してください。

これら3つを組み合わせることも可能です。プロンプトから始めるかChampから始め、キャンバス上で結果を調整する、あるいはその逆も可能です。

プロンプトバーで構築する #

プロンプトバーはキャンバスの下部に固定されているため、構築中も継続的に変更を依頼できます。

• 停止できます。 ビルド中、送信ボタンが停止ボタンに変わります。これをクリックするとビルドがその時点で終了し、キャンバスはリクエスト前の状態のまま維持されます。
• 会話を記憶します。 同じセッション内での直近の指示が記憶されるため、「そのステップを削除して」や「遅延を2日間に変更して」といった短いフォローアップの指示でも、自動化全体を再度説明することなく理解されます。
• 変更は承認を待機します。 すでにステップが存在する自動化の変更をAIに依頼した場合、即座にキャンバスが置き換わることはありません。提案されたバージョンがキャンバス上に表示され、新しいステップは緑色、変更されたステップは琥珀色で枠囲みされます。また、画面下部のバーに、追加・変更・削除された項目、変更された接続数、AIが命名した場合はその新しい名前が表示されます。承認をクリックすると変更が適用され、拒否をクリックするとすべてが元の状態に戻ります（Cmd+ZまたはCtrl+Zでも拒否できます）。選択するまで、自動化の保存や有効化はできません。空のキャンバスからビルドする場合は、失うものがないため即座に適用されます。
• AIのメッセージは閉じるまで表示されます。 AIがビルド内容について説明（省略したステップや回答が必要な質問など）を表示した場合、そのメモは閉じるまで画面上に残ります。これは変更内容の横にあるレビューバーにも表示され、その後はプロンプトバーの上にあるAIのメモを表示ボタンから、次のリクエストを行うまでいつでも再表示できます。
• 「元に戻す」で変更全体が取り消されます。 AIが追加または再配置した内容は1つの変更としてカウントされるため、承認後にツールバーの元に戻すを1回クリックするだけで、キャンバスを元の状態に戻せます。
• 依頼した内容のみを追加します。 アカウントのクレジット変更、アカウントのブロック、データの削除、メッセージの送信などは、依頼しない限り勝手に行われることはありません。そのため、連絡先にタグを付けるよう依頼すれば、タグ付け以外の余計な処理は行われません。
• 言語設定に従います。 キャンバス上のステップラベル、自動化の名前、説明、メモは、アプリで設定されている言語（設定 → プロフィール → 言語で選択したもの）で作成されます。アプリをフランス語に設定すれば、特に指定しなくてもAIはフランス語で記述します。既存の自動化はそのまま維持されるため、言語を変更しても自動的に書き換えられることはありません。ステップ名の変更が必要な場合は、プロンプトバーで依頼するか、手動で変更してください。
• ビルド内容に名前と説明を付けます。 新しい自動化には名前と短い説明が自動的に入力されるため、自動化リストを開かなくても各自動化の役割を確認できます。後から変更を依頼した場合、名前や説明の変更を指示したり、変更によって内容が不適切になったりしない限り、既存の名前と説明はそのまま維持されます。自分で入力した内容は、明示的に依頼しない限り置き換えられません。

変更の保存 #

キャンバス上の内容は自動的には保存されません。ステップの追加、フィールドの編集、ノードの移動、オートメーション設定の変更など、あらゆる変更は、右上の 保存 をクリック（または Cmd+S / Ctrl+S を押す）するまで、ブラウザ上に下書きとして保持されます。未保存の変更がある場合、ボタンの横に 未保存の下書き と表示されます。破棄 をクリックすると下書きが破棄され、オートメーションは最後に保存された状態に戻ります。

有効なオートメーションは、作業中も最後に保存されたバージョンで実行され続けるため、作成途中のものが実際に動作してしまうことはありません。有効 スイッチをオンにすると、その時点で保存が行われます。これは、スイッチをオンにした状態がキャンバス上の状態であるためです。未保存の変更がある状態でタブを閉じたり別のページに移動したりしようとすると、保存するか、保存せずに移動するか、そのまま留まるかを確認するメッセージが表示されます。

トリガー #

すべてのオートメーションは、必ず1つのトリガー（開始のきっかけとなるイベント）から始まります。現在多くのトリガーが用意されているため、トリガーピッカーではそれらの内容に基づいてグループ分けされています。

メッセージング

連絡先

取引

予約

タスク

アカウント

アプリ

全般

トリガーはビルダーだけでなく、アカウント全体に対して反応します。 「メッセージ受信」、「連絡先更新」、「取引更新」は、AIエージェントが会話中に連絡先を更新した場合、ブロードキャスト、画面上で誰かがレコードを編集した場合、インポート、あるいは独自のソフトウェアがAPIを呼び出した場合など、変更の発生源に関係なく実行されます。これについて自動化側で何か特別な設定をする必要はありません。これが現在の仕様です。

トリガーを間違えた場合や、後で変更したくなった場合は、トリガーを開いて トリガーを変更 をクリックし、別の種類に切り替えることができます。その際、自動化の残りの部分はそのまま維持されます。現在のトリガーにすでに設定を入力済みの場合は、クリアされる前に確認を求められます。

アプリイベント #

アプリイベントトリガーは、使用している他のアプリで発生したイベントをきっかけに自動化を開始します。現在、HubSpot、Pipedrive、Salesforce、Close、Stripe、Shopify、Calendly、Typeform、Googleスプレッドシート、Googleドライブ、Googleカレンダー、Gmail、Outlook、Slack、Discord、Trello、ClickUp、Asana、Monday、Jira、Linear、Notion、Airtable、Zendesk、Zoom、Mailchimp、MailerLite、Kit、DocuSign、GitHubなど、41種類のアプリから選択できます。選択ツールには、イベントを報告できるアプリのみが表示されます。

設定方法

1. トリガーを開き、アプリの下にあるアプリイベントを選択します。（すでに別のトリガーを設定している場合は、先にトリガーを変更をクリックしてください。）
2. アプリで対象のアプリを選択します。イベントで、自動化を1回実行するために必要なイベントを選択します。
3. アプリがまだ接続されていない場合は、アクションステップでアプリを接続するのと同じ方法で、その場で接続します。アカウントには、自動化が監視対象としている接続済みアカウントが表示されます。
4. イベントに設定項目がある場合は、イベント設定を入力します。これらは、アプリがどのイベントを送信すべきかを判断するために必要な詳細情報であり、必須項目にはマークが付いています。一部のイベントでは、アプリ側の開発者設定からの詳細情報が求められます。その場合は、イベントの下にあるアプリでの設定方法に、情報の確認場所が記載されています。
5. 自動化を保存し、有効にします。

監視中かどうか： トリガーの設定の下に現在の状態が表示されます。監視中は、アプリからのイベントが自動化を開始する状態です。自動化により一時停止中は、自動化がオフになっている状態です。再度有効にすると監視が再開されます。監視していませんと表示される場合は、接続済みアカウントが削除されたなど、アプリから返された理由が併記されます。自動化を一時停止するとイベントの受信も停止します。自動化を削除したり、トリガーを別のアプリやイベントに変更したりすると、古いリスナーは削除されます。アプリのアカウントの接続を解除すると、そのアカウントを監視しているすべての自動化が停止し、トリガーにその理由が表示されます。

一部のアプリでは、イベントの報告に数分かかることがあります。 すべてのアプリがイベント発生と同時に通知を送るわけではありません。そのようなアプリの場合、数分おきにイベントの有無を確認するため（イベント設定の間隔（分単位））、イベント発生から実行開始まで少し時間がかかることがあります。選択したイベントがこの仕組みで動作する場合、トリガーに注記が表示されます。

アプリが送信した情報の利用： アプリがイベントに関して送信するすべてのフィールドは、後続のステップで ${trigger.field_name} として利用可能です。これらに加えて、${trigger.app_event.toolkit} はアプリ、${trigger.app_event.event} はイベント、${trigger.app_event.id} はこの配信のID、${trigger.app_event.received_at} は到着時刻です。配信されたデータ全体は、そのまま ${trigger.raw} に格納されます。+ 選択ツールのサンプルには、イベントに通常含まれるデータが初期表示されます。実際のイベントが1件でも受信されると、「最後の実際のイベントをサンプルとして使用」をクリックできるようになり、選択ツールにアプリが送信する実際のフィールドが正確に表示されます。

コストについて： 各実行にかかるコストは、他のトリガーで開始された実行と同じです（自動化のコストを参照）。実行履歴では、これらの実行には アプリイベント というラベルが付けられます。

例：HubSpotの取引ステージ変更。 HubSpotの取引が新しいステージに移動したときにWhatsAppメッセージを送信したい場合を想定します。

1. アプリイベントを選択し、アプリにHubSpot、イベントに取引ステージが更新されましたを選択して、HubSpotアカウントを接続します。
2. HubSpotの2つのイベント（コンタクトが作成されましたおよび取引ステージが更新されました）では、イベント設定でHubSpotアプリIDと開発者APIキーが必要です。これらはどちらも、developers.hubspot.comのHubSpot開発者アカウントから取得できます。
3. 新しいステージに対して条件ステップを追加し、目的のステージ（例：「成約」）のみが処理されるようにします。その後に、コンタクトへのメッセージを送信ステップを追加します。
4. 保存して自動化を有効にし、HubSpotでテスト用の取引を移動させます。その後、「最後の実際のイベントをサンプルとして使用」をクリックすると、実際のHubSpotイベントのステージやコンタクトのフィールドが + 選択ツールに表示されます。

オートメーション設定 #

一部の選択肢は、特定のステップではなくオートメーション全体に適用されます。これらはエディタ右上の歯車アイコンからオートメーション設定で管理され、他の設定と同様にドラフトの一部となります。適用するには保存をクリックしてください。以下の5つがあります。

• 説明: このオートメーションの役割に関するメモ。リストの名前の下に表示されます。
• 再エントリーを許可 — 連絡先がこのオートメーションを複数回通過できるかどうか。
• 応答で停止 — 連絡先からメッセージが届いた瞬間に実行を終了する。
• おやすみ時間を尊重 — 連絡先の現地時間で夜間に送信されるメッセージを保留する。
• 指定時間のみ実行 — 設定した時間枠外ではトリガーを無視する。

オートメーションの役割を記述する #

「不在着信の自動返信」のような名前なら十分ですが、「1ヶ月後のフォローアップ3」では不十分です。オートメーション設定の上部にある説明ボックスは自由記述欄です。そのオートメーションが何をするものか、誰向けか、なぜ作成したのかを1〜2行で記述してください。

記述した内容はオートメーションリストの名前の下に表示されるため、リストを開かなくても各オートメーションの目的を確認できます。リストの検索ボックスは名前だけでなく説明も検索対象とするため、「レストラン」や「リマインダー」といった言葉を説明に入れておけば、後から簡単に見つけることができます。これは任意の設定であり、オートメーションの実行方法には影響しません。空欄のままにすれば、リストの表示は以前のまま維持されます。

連絡先が複数回通過できるようにする #

再エントリーを許可 は、すでにオートメーションを通過した連絡先に対してトリガーが再度発生した場合の動作を決定します。

• オフ: 各連絡先はオートメーションを1回だけ通過します。次にトリガーが発生しても（別のメッセージ送信、別の予約、同じタグの再付与など）、何も開始されません。実行履歴には何も記録されず、トリガーのフィルターに一致しないメッセージと同様の扱いになります。このオートメーションを一度でも実行した連絡先は、完了、失敗、停止のいずれであっても「通過済み」とみなされます。
• オン: トリガーが発生するたびに、連絡先は何度でもエントリーできます。予約リマインダー、予約確認、毎回同じ返信が必要なキーワードなど、繰り返し発生するイベントに適した設定です。

デフォルト設定はトリガーによって異なります。 「連絡先追加」（連絡先ページから手動で追加する場合）ではオフになっているため、同じリストを2回追加しても二重にメッセージが送られることはありません。それ以外のすべてのトリガーではオンになっています。これは従来のオートメーションの動作であり、この設定が導入される前に作成したオートメーションが勝手に変更されることはありません。

2点注意してください。再エントリーは連絡先に基づいているため、「スケジュール実行」、「Webhook受信」、「RSS」、「メール受信」など、連絡先を伴わないトリガーには影響しません。また、3つの予約トリガー（予約完了、予約キャンセル、予約前）は、スイッチの設定に関わらず常に再エントリーが許可されます。これらは予約ごとに1回、リマインダーごとに1回実行されるため、連絡先単位で「1回」に制限すると、リピーターの次の予約や同じ予約に対する2回目のリマインダーがスキップされてしまうためです。そのため、これらのトリガーではスイッチはグレーアウトされます。

連絡先からの返信で停止する #

応答で停止は、フォローアップシーケンスのための機能です。遅延ステップで待機中、またはステップを実行中のラン（実行）は、連絡先が任意のチャネルでメッセージを送信した瞬間に終了します。そのランは実行履歴でキャンセル済みと表示されます。他のユーザーのランには影響せず、オートメーションは全員に対して有効なまま維持されます。「応答で停止」によってランが終了した場合、詳細ページには連絡先が返信した旨が表示されます。一方、手動でキャンセルしたランには、手動でキャンセルされた旨が表示されます。

デフォルトではオフになっています。オンの状態で、オートメーション自体のトリガーが受信メッセージである場合、1回の実行を停止させる返信が、トリガーと一致し、かつ再エントリーが許可されていれば、新しい実行を開始する可能性があります。これは、ほとんどのCRMでフォローアップシーケンスが再開されるのと同じ仕組みです。各連絡先にシーケンスを一度だけ送信したい場合は、再エントリーもオフにしてください。

「おやすみ時間」を尊重する #

自動化はトリガーが作動した瞬間に実行されますが、そのタイミングが常に適切とは限りません。例えば、12時間前の予約リマインダーを設定した場合、早朝の予約枠を持つ連絡先には午前2時に届いてしまいます。また、世界各地の連絡先は、あなたが活動している時間帯に眠っているかもしれません。

クワイエットアワー（おやすみ時間）を尊重するは、オートメーションごとに設定できるスイッチです。設定場所: エディター右上の歯車アイコンをクリックしてオートメーション設定を開くと、オートメーションのトリガーの種類に関係なく表示されます。

デフォルトではオフになっています。 新規および既存のすべての自動化でオフになっているため、すでに作成済みの自動化の動作が勝手に変わることはありません。

このスイッチをオンにすると、その自動化においてのみ以下の動作となります：

• 連絡先の現地時間で午後8時から午前8時の間に送信される予定のメッセージステップは待機状態となり、現地時間の午前8時頃に送信されます。一度にすべてが送信されるのではなく、8:00〜8:15の間にランダムな短い遅延を挟んで分散されます。これは「メッセージを送信」、「WhatsAppテンプレート」、「WhatsApp Web送信」の各ステップに適用されます。
• それ以外のステップはすべて即座に実行されます。 タグ付け、条件分岐、遅延、Webhook、連絡先の更新、タスク作成などは保留されません。待機するのはメッセージの送信のみです。
• ループ内のメッセージステップは例外です。 この設定がオンになっていても即座に送信されます。各連絡先のメッセージを個別に保持すると、1つのループが静かな時間帯全体に広がってしまうためです。朝まで待機させる必要がある場合はメッセージをループの外に配置するか、トリガーの 「これらの時間帯のみ実行」 を使用して、ループ全体が適切な時間帯に実行されるようにしてください。
• トリガー自体のタイミングは変わりません。 「予定の3時間前」のリマインダーは、依然として3時間前に実行されます。もしその時間が午前3時であれば、実行自体は行われ、メッセージのみが朝まで待機します。
• 現地時間とは、あなたではなく連絡先の時間を指します。 これは電話番号の国コードや連絡先に保存されたタイムゾーンから算出されます。これはアカウント全体の「おやすみ時間」設定と同じ仕組みです。

これは、「設定」→「プロフィール」にあるアカウント全体の**「おやすみモード」**設定とは別物です。あちらはフォローアップやAIによるスケジュール送信を対象としています。その設定は自動化には適用されないため、各自動化に個別のスイッチが用意されています。アカウントレベルの設定については、おやすみモードとコンプライアンスを参照してください。

特定の時刻にリマインダーを作成する場合： メッセージが常に営業時間内に送信されるのであれば、トグルはオフのままで構いません。オンにしてもコストはかかりませんが、使用されない待機時間を追加する理由もありません。

特定の時間帯のみ実行する #

「サイレント時間（Quiet hours）」はメッセージの送信を保留にしますが、他のステップはすべて実行されます。しかし、場合によってはそれが望ましくないこともあります。自動化全体を特定の時間帯以外はオフにしておきたいというケースです。例えば、チャットをチームに引き継ぐ場合、チームの勤務時間が9時から18時であれば、深夜2時に引き継ぎが発生して朝まで保留されるのではなく、引き継ぎ自体が発生しないようにしたいと考えるでしょう。

指定した時間帯のみ実行するは、オートメーションごとに設定できる2つ目のスイッチです。設定場所: オートメーション設定（エディター右上の歯車アイコン）を開くと、トリガーの種類に関係なく、クワイエットアワーを尊重するのすぐ下に表示されます。これをオンにして、開始時間、終了時間、タイムゾーンを設定してください。

• 時間帯の内部では、自動化はこれまで通り動作します。
• 時間帯の外では、トリガーは単純に無視されます。 自動化は実行されず、後で実行するためにキューに入れられることもなく、実行履歴にも表示されません。イベントは、トリガーのテキストフィルターに一致しないメッセージと同じように扱われます。深夜のイベントを最終的に処理する必要がある場合は、このスイッチは不適切です。オフのままにして、代わりにサイレント時間を考慮するを使用してください。
• 終了時間が開始時間より早い場合は、夜間をまたぐ時間帯となります。 21:00から08:00に設定すると、夜間を通して実行され、日中はオフになります。
• 時間帯は、自動化に設定したタイムゾーンを使用します。 各連絡先の現地時間ではありません。「サイレント時間」は連絡先ごとの設定ですが、こちらは自動化全体に対して1つの時計を設定するものです。タイムゾーンは、**スケジュール通り（On schedule）**トリガーで受け付ける形式（例: Europe/London や America/Lima）で入力してください。
• 「スケジュール通り」トリガーは、実行される瞬間にチェックされます。 スケジュールされた実行のタイミングが時間帯の外にある場合、スキップされ、移動はされません。

違いを一言で言うと、サイレント時間を考慮するは自動化を実行してメッセージのみを朝まで保留しますが、この時間帯のみ実行は自動化自体を一切実行しません。

もし、時間帯によって動作が異なる1つの自動化（日中はこれ、夜間はあれ、といった動作）を作成したい場合は、実行をスキップするのではなく、条件ステップを時刻に設定して分岐させてください（ステップを参照）。

1つのエージェントのみでオートメーションを実行する #

多くのアカウントでは複数のAIエージェントが稼働しており、特定の1人（例えばサポートエージェントのみで、セールスエージェントは対象外など）にのみ適用したいオートメーションには、それを指定する方法が必要です。4つのトリガーには、そのためのフィールドが用意されています。

トリガーを開いてフィールドをクリックすると、グループ化されたリストが表示されます。上部にはAIエージェントの名前が、その下には（アカウントにまだ存在する場合）従来のキャンペーンが表示されます。いずれかを選択すると、そのエージェントが担当する連絡先に対してのみオートメーションが実行され、アカウント内の他のすべての会話は無視されます。初期状態の「任意のエージェント」のままにすると、エージェントが割り当てられていない連絡先を含め、アカウント内のすべての連絡先に対してオートメーションが実行されます。

この設定は、その時点で連絡先に割り当てられているエージェントを読み取るため、今日連絡先を別エージェントに変更すると、それ以降はそのオートメーションの実行対象も変更されます。

このフィールドで選択できるのは1つだけです。オートメーションは単一のエージェントまたは単一のキャンペーンに絞り込まれるため、別のエージェントにも同じステップを適用したい場合は、2つ目のオートメーションを作成してください。

その他のトリガーはすべて、アカウント全体に対して実行されます。 コンタクト、取引、予約、タスク、アカウント、または一般的なトリガーにはエージェントフィールドが存在しません。これらはアカウント内のすべてに対して起動します。これらを特定の1人のエージェントに絞り込むには、トリガーの直後に条件ステップを追加し、コンタクトに割り当てられたエージェントを確認してから、残りのステップを真のパスに配置してください。ステップを参照してください。

まだ絞り込みに対応していないエージェントもあります。 フィールドに表示されないエージェントは、そのすぐ下にカウントが表示されるため、リストが短い理由をすぐに確認できます。該当する会話は通常通り機能しますが、現時点ではここで個別に指定することはできません。

AIエージェントを使用しているアカウントについて、もう1つ知っておくべきことがあります。このように絞り込まれたメッセージトリガーによる自動化は、新しい連絡先からの最初のメッセージだけでなく、それ以降のすべてのメッセージに対しても実行されます。以前は2通目のメッセージから開始されていたため、すべての新しい会話の最初のメッセージが対象外となっていました。（これは、受信メッセージをトリガーとする自動化に関するものであり、上記で説明した、追加された連絡先1件につき1回だけ実行される連絡先が追加されましたトリガーとは別物です。）

AIエージェントによる自動化の呼び出し #

AIエージェント関数トリガーを使用すると、オートメーションをAIエージェントが顧客との会話中に利用できる機能に変えることができます。これは、エージェントがすでにカスタム関数を使用しているのと同じ仕組みです。顧客が何かを尋ねると、エージェントはそのオートメーションが適切なツールであると判断し、会話から収集した詳細情報を使用してそれを呼び出します。必要に応じて、その結果を受け取り、次の返信で使用することも可能です。

設定方法:

1. 関数に名前を付ける。 英数字とアンダースコアを使用した短い名前（例: check_availability、register_warranty）にします。AIはこの名前を見て判断するため、何をする関数なのかがわかる名前にしてください。
2. 使用するタイミングを説明する。 この説明は、AIが関数を呼び出すかどうかを判断する基準になります。新しいチームメンバーに指示を出すような感覚で記述してください。「顧客が特定の日に予約枠が空いているか尋ねてきたときにこれを使用する」のように書きます。
3. 収集する詳細を追加する。 各パラメータは、AIが呼び出し前に会話から収集すべき情報（市区町村、注文番号、希望日など）です。それぞれに名前、型、短い説明を付け、必須項目を指定します。型にはテキスト、数値、はい/いいえ、またはJSONが選べます。AIが単一の値ではなく構造化されたデータの塊（例：配送先住所全体）を渡すべき場合はJSONを選択してください。
4. 使用できるエージェントを選択する。 この機能を持たせるAIエージェントを選択します。ここ（トリガー設定）で選択するか、後から各エージェントの**「AI機能」**タブで選択できます。後者の場合、他の機能と並んでオン/オフの切り替えスイッチが表示されます。どちらで編集しても同じ設定が反映されるため、作業しやすい方で行ってください。
5. 自動化をオンにする。 その瞬間から、対象のエージェントがその機能を使用できるようになります。どこかにコピーしたり、Webhookアドレスやシークレットキーを貼り付けたりする必要はありません。

名前、説明、詳細を自分で書くのが面倒ですか？まずオートメーションのステップを作成してから、トリガー設定の上部にあるAIで入力をクリックしてください。オートメーションの内容を読み取り、自動的に入力されます。すでに入力済みの内容はそのまま保持され、空欄のみが埋められます。結果を確認し、必要に応じて調整してから保存してください。

オートメーション内では、AIが送信したすべての情報が通常のデータボタンから利用可能です。各パラメータはtrigger.argsの下に表示され、会話の対象となっている連絡先やチャネルの情報も利用できます。

エージェントへの回答。 Return response ステップを追加すると、そのステップが返した内容がAIの読み取る回答になります。これにより、データベース内の在庫検索、カレンダーの確認、見積もりの計算など、同じ会話の中で実際のデータを引用できるようになります。Return responseステップがない場合、エージェントは自動化が完了するまで（最大25秒間）待機し、完了したか失敗したかの通知を受け取ります。「システムに苦情を登録する」といった、データを返す必要のない作業にはこれが適しています。自動化が25秒経過しても続いている場合や、長いDelayステップで待機している場合、エージェントはバックグラウンドで実行中であると判断し、次の処理へ進みます。注意点として、エージェントは返信を最大25秒間待機するため、トリガーとReturn responseステップの間にDelayステップを配置しないでください。Return responseステップに到達する前に実行が失敗した場合（ステップのエラーや残高不足など）、エージェントは呼び出しが失敗したことを通知され、人間にアラートを送信し、顧客には技術的な問題が発生したことを伝えます。実際には存在しない回答を約束することはありません。Return responseステップ自体がエラー状態（400以上）を送信した場合も同様です。「見つかりません」という回答をエージェントに伝えたい場合は、本文に明確なメッセージを含めて200を送信してください。

オートメーションがオフの間、エージェントはその関数を呼び出すことはできません。再度オンにするまで、エージェントの機能リストからその関数は消去されます。

また、カスタム関数ページに「オートメーションで管理」というバッジが付いた関数がリストされているのが確認できます。このエントリは自動的に管理されるため（名前やフィールドはトリガーの設定に従います）、そのページから編集や削除を行うことはできません。編集が必要な場合は、オートメーションを開いてください。

自動化への連絡先の追加 #

ほとんどのトリガーは何らかのイベントを待機しますが、連絡先が追加されたトリガーは自分で操作するものです。対象の連絡先を選択すると、その一人ひとりに対してオートメーションが一度実行されます。フォローアップシーケンス、ウェルカムシリーズ、再エンゲージメント施策（メッセージ送信、待機、再メッセージ送信など）を構築し、好きなタイミングで連絡先を投入するのに適しています。

他のオートメーションと同様に構築してください。連絡先が追加されましたトリガーを設定し、ステップを追加します。連絡先に関するすべての情報は、通常のデータボタンを通じてステップ内で利用可能です（名前、電話番号、メールアドレス、チャネルなど）。そのため、メッセージを送信ステップで名前を呼んで挨拶することができ、送信先の連絡先も自動的に認識されます。

連絡先を追加する場所は4つあり、作業中の場所から直接実行できます:

連絡先から一括で追加。 連絡先に移動し、対象の連絡先（1件、複数、またはフィルタリングされたリスト全体）にチェックを入れ、下部のバーにあるオートメーションをクリックします。オートメーションを選択し、連絡先を追加をクリックしてください。連絡先が追加されたトリガーを持つオートメーションのみが表示されます。一時停止中のオートメーションは、オンにするまでグレーアウトされます。

個別の連絡先から追加。 連絡先を開いて詳細パネルを表示し、オートメーションに追加をクリックします。

会話から。 チャットで、会話上部の3点メニューを開き、自動化に追加を選択します。返信の途中で、この相手をフォローアップシーケンスに追加すべきだと気づいたときに便利です。

自動化自体から。 自動化を見ながら「誰をここに追加しようか？」と考えているときに使う方法です。自動化リストで、有効になっている「連絡先が追加された」自動化の行には、人追加アイコンが表示されます。これをクリックし、名前、電話番号、またはメールアドレスで連絡先を検索して、追加したい相手にチェックを入れて追加します。同じボタンが、自動化のログページにある「追加された連絡先」パネルの上部にも配置されています。

どのルートを選択しても、その連絡先に対して自動化が開始され、そのまま作業を続けることができます。

段階的な追加（ドリップ）。 何百人もの連絡先を一度に追加すると、短時間に何百通ものメッセージが送信されることになりますが、特にWhatsAppでは、これは通常望ましいことではありません。同じダイアログで「段階的に追加」にチェックを入れ、一度に追加する連絡先の数と、バッチ間の待機時間（分）を設定します。例えば「30分ごとに20件」と設定すれば、500人のリストを約半日かけて処理できます。どのような設定であっても、連絡先は一度にすべてではなく着実に供給されるため、大量のバッチによってアカウントに過度な負荷がかかることはありません。

進捗の確認。 自動化を開き、ログをクリックします。実行履歴の上部にある「追加された連絡先」パネルには、追加した各バッチ、これまでに処理された連絡先の数、および一時停止、再開、キャンセルの各ボタンが表示されます。一時停止すると新しい連絡先の追加は止まりますが、すでに開始された実行は通常通り完了します。キャンセルすると残りの処理は完全に停止し、再開することはできません。

同じ人物を2回追加する場合。 デフォルトでは、各連絡先は特定のオートメーションを一度しか通過できません。後でもう一度追加しても、その連絡先は自動的にスキップされ、進捗ラインでは「スキップ済み」としてカウントされます。月次のチェックインのように、連絡先が再度オートメーションを通過できるようにしたい場合は、オートメーション設定（右上の歯車アイコン）を開き、再エントリーを許可をオンにしてください。連絡先が複数回通過できるようにするを参照してください。

知っておくべきことが2つあります。連絡先の詳細は追加した瞬間に取得されるため、後から電話番号を編集しても、すでにキューに入れられた実行には反映されません。また、連絡先が追加されている最中に自動化をオフにすると、失敗するのではなくバッチが一時停止します。再度オンにして再開をクリックしてください。

ステップ #

トリガーの後には、必要なだけステップを追加できます。

• アクション — DM Champ内で何らかの操作を行います。連絡先へのメッセージ送信、詳細の編集、タグ付け、リスト間の移動、別のAIエージェントへの引き継ぎ、タスクや取引の作成・更新、予約の作成・移動・キャンセル、ワークフロー内で後から使用するための検索、人間への通知などです。全リストは以下のアクションにあります。

• インテグレーション — 外部アプリ（Googleスプレッドシート、Slackなど）を接続し、そのアクションを自動化内で使用します。ビルダーから一度接続すれば、他のステップと同様にドラッグ＆ドロップで使用できます。まだ接続していないアプリを使用するステップには、キャンバス上に小さなオレンジ色のドットが表示され、設定パネルに**「接続」**ボタンが表示されます。これをクリックして開いたタブでアプリを承認すれば、そのステップは自動的にロック解除されます。これはAIが作成する自動化にも適用されます。アプリ接続が必要なステップがある場合は、自動化をオンにする前に通知されます。

  アプリの「人気」見出しの下にあるすべてのアクションには、技術的なフィールドの代わりにガイド付きフォームが用意されています。例えば、Googleスプレッドシートに行を追加する場合、リストからスプレッドシートを選択し、シートを選択すると、シートの各列見出しが入力フィールドとして表示されます。これには、以前のステップから値を挿入するための通常のデータボタンも含まれます。行の検索も同様で、スプレッドシートとシートを選択し、検索内容を入力するだけです。同様の対応は、Gmail（送信、下書き、返信、メール検索）、Slack（チャンネルはライブリストから取得）、Notion（データベースを選択すると各プロパティがフィールドとして表示）、HubSpot（連絡先、取引、会社、チケット）、Googleカレンダー（イベント作成や検索時に自分のリストからカレンダーを選択）、Googleドキュメント（リストからドキュメントを選択）、およびTelegramにも適用されています。特殊な設定は「詳細オプションを表示」の背後にあり、適切な値がすでに設定されています。この機能以前に設定されたステップはそのまま動作します。開いて「シンプルモードに切り替え」を選択すれば、いつでもガイド付きバージョンに変更できます。

  その他のアクションでは、アプリが要求する設定ごとに1つのフィールドが表示され、平易な言葉でラベル付けされています。ラベルの横にある i をクリックすると説明が表示されます。複数の値を保持する設定は、コードボックスではなく小さなフォーム形式になっています。リスト（例えば、新しいHubSpotノートがリンクされるレコードなど）は Add で追加し x で削除する行のセットであり、固定の選択肢はドロップダウンメニュー、名前付きの値のセットは名前と値の行として表示されます。すべてのボックスは、+ ボタンを使用して前のステップから値を取得できます。生の値を直接入力したい場合は、フィールドの横にある Edit as JSON をクリックするとテキストとして表示され、そこで変更した内容はフォームに反映されます。

  統合ステップ内で テストステップ を使用すると、そのステップだけを実際に実行できます。Sheets の例では、実際にスプレッドシートに行が追加されるため、自動化を有効にする前に動作を確認できます。

  アプリが使用するアカウントを変更するには、そのアプリのステップを開きます。接続が完了すると、設定パネルの上部に接続済みのアカウント（アプリが共有している場合は名前またはメールアドレス）が表示され、切断 および 別のアカウントを使用 のオプションが表示されます。別のアカウントを使用 を選択すると現在のアカウントが切断されます。その後、接続 をクリックして別のアカウントでサインインしてください。接続はワークスペース全体で共有されるため、そのアプリを使用するすべての自動化が新しいアカウントに切り替わります。接続がない間は、そのアプリを使用するステップは実行されません。

• メール (メールサーバー) — Gmail 経由ではなく、独自のメールサーバーからメールを送信します。ステップタイプとしてこれを選択し、プロバイダーの送信詳細（サーバーアドレス、ポート、ユーザー名、パスワード、および送信元メールアドレス）を一度入力してください。これらは通常、メールプロバイダーの設定の「SMTP」または「送信」セクションに記載されています。保存前にメールサーバーに対して詳細が検証されるため、設定に誤りがある場合は、自動化の初回実行時ではなく、その場で確認できます。

  知っておくべきことが2つあります。ポート587を使用してください。これは暗号化されており、ほぼすべてのプロバイダーがサポートしており、当社の送信ネットワークから機能するポートです。また、メールアカウントで2段階認証を使用している場合は、通常パスワードを入力する代わりに、プロバイダーのアカウント設定でアプリパスワードを作成してください。

  接続が完了すると、ステップは宛先、件名、メッセージのみとなり、以前のステップからデータを挿入するための通常のボタンが使用できます。必要に応じてCcやBccも利用可能です。パスワードは暗号化されて保存され、二度と表示されることはありません。再接続時には再度入力が必要です。

• 組み込みアプリ — いくつかのツールには、インテグレーションカタログとは別に、独自のファーストクラスのステップが用意されています：

  • Mollie — 支払いリンクの作成や、支払いが完了したかどうかの確認を行います。Mollie APIキー（Mollieダッシュボード → Developers → API keys）を使用して一度接続してください。
  • WooCommerce — ストア内の顧客や注文の検索、注文ステータスの変更、クーポンコードの作成を行います。ストアのURLとREST APIキー（WooCommerce → Settings → Advanced → REST API → Add key）を使用して接続してください。
  • WordPress: 投稿の作成・更新・取得、ユーザーの作成、メールアドレスによるユーザー検索を行います。サイトのURL、WordPressのユーザー名、アプリケーションパスワード（Users → Profile → Application Passwords）を使用して接続してください。WordPressを参照してください。
  • FluentCRM: コンタクトの作成・更新、メールアドレスによる検索、タグの追加・削除、リストへの追加を行います。FluentCRMはWordPressサイト上で動作するため、接続情報はWordPressと同じです。タグとリストは名前ではなくIDで指定されます。FluentCRMを参照してください。
  • MemberPress: メンバーの取得、メールアドレスによる検索、メンバーの作成、サブスクリプションやトランザクションの一覧表示、およびメンバーシップを付与するためのトランザクション作成を行います。サイトのURLと、MemberPress → Developer Toolsから取得したAPIキーを使用して接続してください。MemberPressを参照してください。

  接続はメールステップと同じ方法で行われます。詳細は保存前にサービスに対してライブチェックされ、キーは暗号化されて保存され、二度と表示されることはありません。すべてのステップで、通常のデータ挿入ボタンを備えたプレーンなフィールドが提供されます。

• データベースクエリ — 技術的なユーザー向け：独自の外部MySQLまたはPostgresデータベースに対してSQLクエリを実行します（例：ショップのデータベースで顧客を検索する）。接続を一度追加すると（保存前にライブテストされます）、クエリを記述します。以前のステップから取得した値には $1、$2（Postgres）または ?（MySQL）プレースホルダーを使用し、それらの値を「値」フィールドに入力することで、連絡先に入力されたテキストがSQLに直接貼り付けられるのを防ぎます。データベースはインターネットからアクセス可能である必要があります。

• HTTPリクエスト — 組み込みの統合機能がまだないツール向けに、外部のWebアドレスを直接呼び出します。

• 条件 — 設定したルールに基づいて、オートメーションを2つのパスのいずれかに分岐させます。確認したい項目は入力するのではなく、+ ボタンを使用して挿入し、比較方法（等しい、含む、より大きい、正規表現に一致など）を選択して、比較対象を入力します。含むは入力したテキストと完全に一致するものを探します。パターンが必要な場合（キーワードの複数の綴り、メッセージの先頭のみにある単語、注文番号の形式など）は、正規表現に一致を選択し、^(ja|yes)\b のような正規表現を入力してください。/i スタイルのフラグを追加するには、パターンを /ja|yes/i のように記述します。無効なパターンは、偽のパスを静かに進むのではなく、実行履歴でエラーとしてステップを失敗させます。ルールが一致した場合は真のパスのステップが実行され、一致しない場合は偽のパスのステップが実行されます。空のままにしたパスは、単に実行を終了します。誰かのタグを確認するのは最も便利な方法の一つです。連絡先の tag_names を挿入し、以下の 例：スパムとしてタグ付けされた人を無視する のように、タグ名を使用して含むを選択してください。

  複数の項目をチェックする。 条件（Condition）には一度に複数のルールを設定できます。一致条件をすべて一致（すべてのルールが真である必要がある）またはいずれか一致（1つでも真であればよい）に設定し、条件を追加を使用してルールを増やします。例：国がNL かつ メッセージに価格が含まれる。これらを組み合わせたり、括弧でグループ化したりする必要がある場合は、ルールを式として入力してください：(${trigger.contact.country} == 'NL' or ${trigger.contact.country} == 'BE') and ${trigger.message.body} contains 'pricing' — andはorよりも結合優先順位が高く、括弧を使用するとそれが優先されます。このように記述された条件は、行形式ではなく式ボックスとして開かれます。

  

  ステージは名前ではなくIDで比較されます。 タスクや案件のステージは内部ID（todo、in_progress、done…）として渡されますが、これはボード上の列タイトルとは異なる場合があります。そのため、フィールドがタスクや案件のステージであり、比較条件が等しいまたは等しくないの場合、値ボックスには独自のステージリストが表示されます。名前で列を選択すると、ステップはそのIDを保存します。以前にステージ名を入力して保存された条件には、リストの下に警告が表示されます。テキストが列のいずれかと一致すると、ボタンが表示され、それをその列のIDに置き換えることができます。

  アカウントを参照する他の値もリスト形式です。 連絡先のタグ（含む、等しい）、タグ追加トリガーが保持するタグ、案件やタスクの担当者、AIエージェント、またはドロップダウン型のカスタムフィールドの場合、値ボックスは自分のタグ、チームメンバー、エージェント、またはフィールドの選択肢のリストになります。代わりに前のステップの値を使用するをクリックすると、トリガーや他のステップの値と比較できます。

  次のステップにはすべて分岐が必要です。 条件（Condition）に接続されたステップは、その「はい（Yes）」または「いいえ（No）」のハンドルに接続されている必要があります。分岐なしで接続されたステップは、条件の回答に関係なく実行されてしまいます。エディタはこれを警告し、ハンドルに移動させるまでオートメーションを有効にすることはできません。

条件は、値ではなく時刻に基づいて分岐させることもできます。条件タイプを時刻に設定し、開始時間、終了時間、タイムゾーンを指定します。現在時刻がその時間枠内であれば「真（true）」のパスが、時間枠外であれば「偽（false）」のパスが実行されます。開始時間より終了時間を前に設定すると、夜間をまたぐ時間枠（21:00から08:00まで）を作成できます。また、曜日のトグルで特定の曜日のみに制限することも可能です（すべてオフにすれば毎日適用されます）。この条件はステップが実行された瞬間に時刻を確認するため、遅延（Delay）の後に配置された時刻条件は、オートメーションが開始された時刻ではなく、実際にそのステップに到達した時刻を参照します。これを利用して、「1つのオートメーションで時間帯によって挙動を変える」ことができます。日中と夜間で異なる処理を行う場合などに便利です。時間帯以外ではオートメーション自体を実行させたくない場合は、オートメーション設定の指定した時間帯のみ実行するを使用してください。

通常の値を比較する条件では、時刻と直接比較することもできます。データ挿入ピッカーの現在時刻グループには、now.hour（0〜23）、now.minute、now.weekday（1 = 月曜日…7 = 日曜日）、now.day、now.month、now.yearが用意されています。これらは、条件のオプションであるタイムゾーンフィールドに入力しない限り、UTCで読み取られます。

• AIステップ — 組み込みのAIにこれまでのデータを読み取らせ、ワークフローの一部として回答や決定を生成させます。プロンプトを記述し、以前のステップからの値を挿入すると、そのステップの出力がそれ以降のすべてのステップで使用可能になります。プロンプト以外に設定する項目はなく、AI自体は自動的に管理されます。ステップの設定には事前に料金が記載されています。AIステップが実行されるたびに0.25クレジットを消費します（ループ内のAIステップは繰り返しごとに0.25クレジットを消費します）。また、テストステップを実行すると実際のAIが使用されるため、同様に0.25クレジットを消費します。

  知っておくべき制限が2つありますが、どちらも余裕があるため、ほとんどの自動化で問題になることはありません。返信には最大長があり、AIがそれ以上のスペースを必要とする場合は回答が途切れます。テスト時にその旨のメモが表示されるため、より短い回答を求めるか、作業を2つのAIステップに分割してください。また、プロンプト自体にも、以前のステップからのデータが入力された後の最大サイズがあります。非常に大量のデータ（長いチャット履歴やスクレイピングしたページ全体など）を挿入すると、実行は停止し、より少ないデータを渡すようメッセージが表示されます。また、設定 → プロフィールで Pause all AI messages がオンになっている間、AIステップは一切実行されません。実行は停止し、アカウントでAIが一時停止されているというメモが表示され、料金は発生しません。一時停止をオフにすれば、新しい実行は再び行われます。

• Delay — 続行する前に一時停止します。Wait type には2つの方法があります。For a fixed amount of time は標準的な方法で、10分、2時間、3日など待機します。オプションでランダムなジッター（ゆらぎ）を追加できるため、連続した実行がすべて同じ秒数で発生するのを防げます。Until a specific moment は、代わりに日時まで待機します。通常は + ボタンを使用して以前のステップから挿入した日時（予定の開始時間など）を指定し、Offset（分単位）で調整します。-180 はその瞬間の3時間前、-1440 は1日前、0 はその瞬間を意味します。実行がそのステップに到達した時点で指定した日時が過ぎている場合、待機せずにそのまま続行します。30日を超える待機は許可されません。30秒を超える待機は、実行を保持し続けるのではなく適切に一時停止するため、実行は時間になるまで waiting と表示され、分、時間、日単位の待機も問題ありません。

• Loop — リスト内の各アイテムに対してステップのグループを1回ずつ繰り返します（例：Find contacts が返した連絡先ごと、または連絡先のタグごと）。Max iterations を空のままにすると、最大1,000個までのすべてのアイテムを処理します。数値を設定すると、それより前に停止します。長いリストは一度に収める必要はありません。実行が時間制限に近づくと、ループはその場で一時停止し、数秒後に同じアイテムから再開するため、数百件の連絡先に対する毎日のスキャンも自動的に完了します。ループ内の Delay も同様に機能し、ループは待機を終えてからそのアイテムの次のステップに進みます。繰り返すステップをループの body ハンドルに接続して終了してください。単に終了するブランチが、ループがそのアイテムの処理を終えたと判断する基準となり、自動的に次のアイテムへ進みます。ループ内の Condition はアイテムごとに判定を行います。そのアイテムの true（または false）ブランチのみが実行されるため、Loop → Condition → Send message は条件を満たしたアイテムにのみ送信されます。ループに戻る線は不要であり、キャンバス上で描画することもできません。後のステップからループ（またはそれより上のステップ）へ接続を引こうとすると、理由を示すメモが表示され、接続は拒否されます。以前に作成した自動化でそのような接続が存在する場合、その自動化のすべての実行は最初のステップの前に停止し、どの接続を削除すべきかが通知されます。

• Return response — Webhook または AI Agent Function トリガーで始まる自動化用です。自動化を呼び出したもの（Webhookを叩いた外部ツールや、会話中のAIエージェント）にデータを返します。デフォルトでは呼び出しに対して確認応答のみが返されますが、このステップを追加すると、代わりに独自の返信を送信できます。ステータスコードを選択し、本文（JSONまたはプレーンテキスト）を記述して以前のステップの値を挿入することで、呼び出し元ツールに検索した行や作成した連絡先などを渡すことができます。呼び出し元は最大30秒間待機します。自動化がそれ以上かかる場合（上流のDelayステップなど）、通常の確認応答にフォールバックし、自動化はそのまま続行されます。このステップに到達する前に実行が失敗した場合、呼び出し元は待機せずに即座に回答を受け取ります。ステータス200と本文に "status": "failed"（残高不足の場合はエラーコードとして insufficient_credits）が返されます。これは意図的にエラー状態にはしていません。リクエストは受信されており、以前のステップが既に実行されている可能性があるためです。StripeやShopifyのようなツールはエラーが返されるとWebhookを再送し、その結果ステップが再度実行されてしまうためです。詳細は実行履歴に残ります。Test step では、サンプルデータを使用した返信のプレビューを確認できます。

また、少しのコードでデータを整形するための 変換 (Transform) ステップもあります。これは小さなスクリプトを書くことに慣れている技術的なユーザー向けです。それ以外のユーザーは無視しても問題ありません。

前のステップで返された値の使用 #

Contact ID のように1つの値を求めるフィールドでは、ステップ全体ではなく、+ ボタンを使用してその1つの値を挿入してください。find_contact という Find contact ステップの後は、それが ${nodes.find_contact.contactId} になります。${nodes.find_contact} をそのまま挿入すると、ステップが返したすべての情報が一度に渡されてしまい、連絡先を必要とするステップで「contact not found（連絡先が見つかりません）」というエラーが発生します。

式 #

${ } 内では、JavaScriptを少し記述して、値が使用される前に変更することができます。変数を指定できるフィールドであればどこでも記述可能です。その際、+ ボタンで挿入されるものと同じ変数名を使用してください。

周囲のテキストはそのまま維持されるため、Hi ${ trigger.contact.first_name.toUpperCase() }! と記述すると「Hi ADA!」と送信されます。フィールドの下にある 結果 (Result) ボックスには、入力中にサンプルデータを使用してコードがどのように評価されるかが表示されます。

コードが失敗した場合（タイプミスや、その連絡先でフィールドが空の場合など）、その部分は空として出力され、ステップの残りの部分はそのまま実行されます。実行履歴には、どのコードがなぜ失敗したかが記録されます。

コードは即座に単独で実行されます。インターネットアクセスはなく、待機処理も行えず、最大でも0.5秒以内に完了する必要があります。外部からデータを取得する場合は、HTTPリクエスト ステップを使用してその結果を挿入してください。ロジックが複数行にわたる場合や、複数のステップで同じ結果を共有する場合は、変換 (Transform) ステップを使用する方が適しています。

連絡先を検索するステップのテスト #

Run および Test step はトリガーのサンプルデータを使用します。このサンプルは架空の連絡先（contact_abc123、[email protected]、電話番号なし）です。この連絡先はあなたのアカウントには存在しないため、連絡先を検索したりメッセージを送信したりするステップをテストすると、「contact not found」や「no number stored（番号が保存されていません）」というエラーで失敗します。これは想定通りの動作です。実際のトリガーが実行されると、ステップは実際の連絡先を取得して正常に動作します。実際のデータでテストするには、一度自動化を実際に実行してから、ツールバーの Replay をクリックして、前回の実行で実際に受信したデータを使用して再度実行してください。

アクション #

アクションとは、DM Champ自体の中で実行される処理のことで、アプリの接続や事前の設定は不要です。ピッカー内では、ここでの分類と同じようにグループ化されています。

アカウント内の既存の項目を参照するフィールドはドロップダウン形式になっています（パイプラインとそのステージ、連絡先リスト、タグ、チームメンバー、タスクステージ、イベントタイプ、下書きのブロードキャスト、WhatsAppテンプレートなど）。リストから選択してください。値が以前のステップから取得されるべき場合（Webhookから送信されたステージ名など）、フィールドの下にある「代わりに以前のステップの値を使用する」をクリックし、**+**ボタンを使用して挿入します。

連絡先

メッセージング

タスク

取引

予約

その他

アカウントAPIアクション #

上記の各アクションの下にあるステップピッカーには、開くまで折りたたまれているアカウントAPIというセクションがあります。ここにはDM Champ APIの各エンドポイントに対応する約390のアクションが含まれており、連絡先、案件、パイプライン、タグ、タスク、予約、ブロードキャスト、ナレッジベース、FAQ、要約、メッセージ、サブアカウントなど、アカウントの構成要素ごとにグループ化されています。APIで実行可能なあらゆる操作を、HTTPリクエストステップやAPIキー、コードなしで、通常のオートメーションステップとして実行できるようになりました。

いくつか知っておくべき点があります：

• 各アクションの設定には、エンドポイントが受け取るパラメータごとに1つのフィールドが表示されます。オブジェクトやアイテムのリストを期待するフィールドは、JSONを入力するボックスです。すべてのフィールドで、以前のステップからの値を通常の ${…} 形式で受け入れ、+ ボタンで挿入できます。
• キャンバス上のステップには、呼び出すメソッドとアドレス（例: PUT /v1/pipelines/:pipelineId）が表示されるため、戻り値の詳細を確認したい場合はAPIリファレンスでエンドポイントを調べることができます。コロンで始まるアドレスの一部は、ステップ上で入力する値であるため、Pipeline ID が default に設定されると、実際には /v1/pipelines/default が呼び出されます。
• 何かを削除するアクションの設定には、赤い警告が表示されます。これらはAPI呼び出しが実行する内容をそのまま即座に実行するため、後から元に戻すことはできません。
• ピッカーの上部にあり、上記の表に記載されているアクションは変更されていません。これらは一般的な操作を行うための最も迅速な方法であり、ほとんどのオートメーションではこのセクションを開く必要はありません。

例：新しいクライアントアカウントのパイプラインとタグを設定する。 これは、以前はスクリプトが必要だった操作をコードなしで行う方法です。

1. トリガー：サブアカウント作成。
2. アカウントAPI → タグ → タグの作成または割り当て (POST /v1/tags)。タグの名前とサブアカウントを${trigger.sub_account.id}に設定します。
3. アカウントAPI → パイプライン → パイプラインの更新 (PUT /v1/pipelines/default)。JSONフィールドにステージを入力します。ステージのtrigger_tagはusers/<the sub-account id>/tags/<the tag id the previous step returned>として記述し、どちらも**+**ボタンで挿入します。

これ以降作成されるすべてのクライアントアカウントには、手動で開くことなく、同じボードとタグルールが適用されます。

例：予約が入ったときに要約を自分宛てにメールする。

1. トリガー：予約完了。
2. アカウントAPI → 要約 → 会話の要約 (POST /v1/summaries)。トリガーの連絡先を指定します。
3. メール。ステップ2の要約を本文に含めます。

変数の記述方法。 + ボタンを使用して挿入したものはすべて ${…} として配置されます（例：${trigger.contact.first_name} や ${trigger.appointment.start_time}）。これが自動化で解決される唯一の形式です。ブロードキャストテンプレートで馴染みがあるかもしれない {{first_name}} というスタイルは、ここでは理解されません。入力した通りにそのまま送信されるため、メッセージには名前の代わりに {{first_name}} が含まれた状態で届いてしまいます。プレースホルダーのテキストがそのままメッセージに含まれて届いた場合は、ほぼ間違いなくこれが原因です。プレースホルダーを削除し、+ ボタンを使用して再度挿入してください。カスタムフィールドは、その人物に関する他のすべての情報と同様に contact の下に配置されます（${trigger.contact.your_field_key}）。スペース、疑問符、その他の記号を含むフィールド名（Facebookリードフォームは各質問を独自のフィールドとして送信します）は、${trigger["what_service_are_you_interested_in?"]} のように角括弧と引用符で囲みます。+ ボタンを使用すると、自動的にその形式で挿入されます。${…} には、${ trigger.contact.phone.replace("+", "") } のように値を変更する小さなコードを含めることもできます。詳細は式を参照してください。変数を保持するすべてのフィールドの下にある Result ボックスには、サンプルデータを使用して解決された場合のテキストが表示されます。緑色の変数は解決済み（値が表示されます）、琥珀色の変数はステップがテストされていないかトリガーにキャプチャされたイベントがないためまだ確認できないもの、赤色の変数はサンプルに含まれていないフィールドを指しており、通常はタイプミスやパスの間違いです。${ } 内のコードについては、ボックスにサンプルでの計算結果が表示されるか、失敗した場合はその理由が赤色で表示されます。変数は、リストや値のグループを保持するフィールド（リンクするレコードのリストやプロパティのセットなど）内でも機能します。その中の各 ${…} が埋められ、値全体が変数の場合はその型が維持されるため、数値は数値のまま、リストはリストのままとなります。 テスト実行なしのサンプルデータ。 ビルド中に実行したくないステップ（連絡先の作成やメッセージの送信など）がある場合、手動でサンプルを取得できます。ステップを開き、Output sample（出力サンプル）の下にある Pin sample（サンプルをピン留め）をクリックし、ステップが返す内容を貼り付けるか入力して、もう一度 Pin sample をクリックします。その後、変数ピッカー、結果ボックス、および後続のステップのテストでそのデータが使用されます。実際の Test step（ステップをテスト）が実行されるまで、そのデータには Pinned（ピン留め済み）とマークされます。ライブ実行ではピン留めされたサンプルは使用されず、ステップが実際に返す内容のみが使用されます。Webhookトリガーの場合、Save as sample（サンプルとして保存）を選択すると、何も実行せずにトリガーのサンプルとして入力したペイロードが保持されます。一方、Send test event（テストイベントを送信）を選択すると、テスト実行も開始されます。Sample payload (for testing)（テスト用サンプルペイロード）ボックスには、外部ツールが送信するものと同じ形式の有効なJSONが含まれている必要があります。キーとテキスト値はストレートダブルクォートで囲み、テキスト値内のダブルクォートは \" と記述します（例: { "note": "she said \"hi\"" }）。テキストが有効なJSONでない間、ボックスには Invalid JSON（無効なJSON）と表示され、どちらのボタンも保存や送信を行いません。

これらのフィールドへの入力について知っておくべきこととして、Contact ID、Task ID、Appointment IDなど、IDで終わる項目は、手入力ではなく**+**ボタンを使用して前のステップから挿入することを想定しています。各フィールドの下にあるヒントにもその旨が記載されています。

例：24時間前と3時間前の予約リマインダー #

これは多くのユーザーが最初に作成する自動化ですので、その全工程を紹介します。

1. 自動化を開始する。 AI Studio → 自動化 → 新しい自動化の順に進み、キャンバス上のトリガーをクリックします。

2. トリガーを選択します。 トリガーを変更をクリックし、予約を開いて、予約前を選択します。

3. リマインダーの時間を設定します。 リマインダーの下にある24時間前と3時間前のチップをクリックします。45分前など、選択肢にない時間が必要ですか？その他に分数を入力して追加をクリックしてください。1つの自動化につき最大5つまでリマインダーを設定できます。最低でも1つは必要です。何も設定しない場合、自動化は実行されません。

予約の開始時間が早く、リマインダーが夜間に送信される可能性がある場合は、オートメーション設定（右上の歯車アイコン）でクワイエットアワーを尊重するをオンにしてください。リマインダーは予定通り処理されますが、メッセージは連絡先の現地時間で午前8時まで待機してから送信されます。クワイエットアワーを尊重するを参照してください。

各リマインダーは予約ごとに1回実行されるため、リマインダーを2つ設定すると、同じ予約に対して2回実行されることになります。これはDM Champが認識するすべての予約（組み込みカレンダーの予約や、Zenchef、Formitable、OpenTable、Trafftを通じてAIが予約したテーブル）を対象としています。レストラン独自のシステム（ウィジェット、電話、直接来店など）で行われた予約はDM Champに通知されないため、リマインダーは送信されません。この設定は、オンにした後に予約されたものだけでなく、すでにカレンダーにある予約にも適用されます。また、変更にも追従します。予約を移動すればリマインダーも移動し、キャンセルすればリマインダーもキャンセルされます。予約時にすでにリマインダーのタイミングを過ぎている場合（今日の午後に予約した予定に対する24時間前のリマインダーなど）は、遅れて送信されるのではなく、単にスキップされます。

4. オプション：リマインダーごとに異なる文言を設定します。 トリガーの後に条件ステップを追加し、フィールドとしてリマインダー：開始までの分数を選択し、値として==および1440を指定します。真のパスは前日のメッセージ（「明日の…にお待ちしております」）、偽のパスは3時間前のメッセージ（「まもなく…にお待ちしております」）になります。両方とも同じ文言で良い場合は、この手順をスキップしてください。

5. メッセージを送信します。 メッセージを送信アクションを追加します。連絡先IDには、**+をクリックして予約の連絡先を挿入します。メッセージにはリマインダーの内容を記述し、+**を使って連絡先の名前や予約開始時間を挿入します。例：

Hi ${trigger.contact.first_name}, a reminder about your appointment on ${trigger.appointment.start_time}. Reply CONFIRM to keep it or CANCEL if you can't make it.

トリガーが提供するその他の詳細情報には、予約の場所、概要、連絡先の電話番号とメールアドレス、および今回の実行が何回目のリマインダーであるかなどが含まれます。開始時間は完全な日時（2026-09-01T10:00:00Z）として渡されるため、メッセージを「明日の10:00」のように表示したい場合は、メッセージの前にAIステップを配置し、連絡先に合わせた表現に変換するよう指示してください。

6. テストして、有効にします。 実行をクリックしてサンプルデータで一度テストし、ログで実行結果を確認してから、有効スイッチをオンにします。

WhatsAppの24時間ウィンドウについて。 連絡先からの最後のメッセージから24時間以上経過している場合、WhatsAppは通常のメッセージ送信を許可しません。1日前のリマインダーはまさにこの状況に該当します。そのリマインダーには、承認済みのテンプレートを使用したWhatsAppテンプレートを送信アクションを使用してください。テンプレートは会話を開始することができ、24時間ウィンドウを再開させるため、連絡先からの返信を通常通り処理できるようになります。3時間前のリマインダーには、通常のメッセージを送信を使用できる場合が多いです。その時点では、連絡先が最初のメッセージに返信している可能性があるためです。作成および承認取得については、WhatsAppテンプレートを参照してください。

「確認」/「キャンセル」ボタンについて。 タップ可能なクイック返信ボタンは、現時点ではオートメーションからは利用できません。現在の代替案としては、返信を求める方法があります。「CONFIRMと返信して予約を確定するか、CANCELと返信してキャンセルしてください」のように案内し、AIエージェントでその回答を処理する（他のメッセージと同様に返信を読み取り、キャンセルや再予約を行う）か、受信メッセージトリガーを使用した2つ目のオートメーションを作成します。後者の場合、CANCELを含むメッセージに絞り込み、その連絡先の予約を検索し、予約をキャンセルを実行した上で、人間に通知で知らせるように設定します。

例：WhatsAppの不在着信をチャットに変換する #

接客中のレストラン、修理中のガレージ、診察の合間のクリニックなど、電話が鳴っても出られない場合、発信者はリストの次の候補に電話をかけます。このオートメーションは、不在着信があったすべての発信者に数秒以内にWhatsAppでメッセージを送り、AIエージェントが対応を引き継ぎます。

テキスト返信のみが必要ですか？ 手動で構築する必要はありません。設定 → チャネルにおいて、各WhatsApp Web番号には不在着信へのテキスト返信スイッチがあり、これを使用すると、メッセージを含めた正確なオートメーションが自動的に作成されます。Twilio経由のSMSカードにも、接続したTwilio番号用に同様のスイッチがあります。詳細はWhatsApp Web → 不在着信へのテキスト返信およびSMS → 不在着信へのテキスト返信を参照してください。条件設定や、不在着信時のエージェントの切り替え、フォローアップステップの追加などを行いたい場合は、以下のように手動で構築してください。

これはWhatsApp Web経由で接続された番号への着信と、SMS用に接続したTwilio番号への着信に対して機能します。不在着信とは、応答しなかったすべての通話を指します（相手が数回鳴らして切った場合や、呼び出し音が鳴り続けた場合）。応答した通話や拒否した通話は含まれず、グループ通話は無視されます。

1. オートメーションを作成する。 AI Studio → オートメーション → 新規オートメーションに移動し、トリガーを変更をクリックして、メッセージングを開き、不在着信を選択します。番号を任意の番号のままにすると、アカウント内のすべての番号（WhatsApp WebおよびSMS）への不在着信で実行されます。フィールドにはWhatsApp Web番号とSMS番号が一覧表示されるため、特定の番号への着信のみでこのオートメーションを実行したい場合は、その番号を選択してください（別のオートメーションで別の番号をカバーすることも可能です）。

2. メッセージを送信する。 メッセージ送信アクションを追加します。連絡先IDには「+」をクリックしてトリガーの発信者を挿入します。次にテキストを入力します。例：

お電話ありがとうございます。ただいま接客中のため出ることができませんでした。ご予約でしょうか？こちらで承ります。

不在着信が発生した瞬間に発信者は連絡先として登録されます（WhatsAppプロフィールの名前が表示される場合）。そのため、メッセージは他のチャットと同様に届き、既にチャット履歴がある場合はそのチャットに送信されます。返信は着信があった番号から送信されます。WhatsApp Webには24時間ウィンドウがないため、一度もやり取りしたことがない相手であっても通常のメッセージを送信できます。

特定の回線から送信したい場合は、メッセージを送信とWhatsApp Webメッセージを送信の両方に、WhatsApp Web番号がリスト表示される送信元フィールドがあります。自動に設定すると、その人物が最後にやり取りした番号からメッセージが送信されます。不在着信の場合は、相手が発信した番号がこれに該当します。

発信者がSMS番号に電話をかけた場合、発信者の連絡先IDを使用した同じメッセージを送信ステップで応答します。テキストは接続済みのSMS番号からSMSとして送信されるため、送信元で選択する必要はありません。通話終了時に発信者はSMS連絡先として保存され、チャットには不在音声通話の行が表示されます。返信はSMS番号のAIエージェントによって処理されます。テキストは自身のTwilioアカウント経由で送信されるため、TwilioのSMS料金が適用されます。1つのオートメーションで両方の種類の番号をカバーする場合、${trigger.channel}でどちらの番号か（whatsapp_webまたはsms）が判別されるため、条件を設定することで、WhatsAppの発信者とSMSの発信者で異なる文言を送信できます。

3. エージェントに引き継ぐ。 発信者が応答すると、その番号への新しいチャットと同様に会話が処理されます。**「新しい会話の担当者」でその番号のデフォルトとして設定されたエージェントが返信します。不在着信を別のエージェントが処理する必要がある場合にのみ、メッセージの前に「AIエージェントを割り当て」**アクションを追加してください。

条件やメッセージ本文で役立つ値：${trigger.contact.first_name}、${trigger.contact.phone_number}、${trigger.channel}（whatsapp_webまたはsms）、${trigger.call.to_number}（相手がかけた番号。番号ごとにオートメーションを作成する場合は、条件の代わりにトリガーの番号フィールドを使用してください）、${trigger.call.is_video}、${trigger.call.missed_at}、および${trigger.is_new_contact}。後者は、一度もチャットしたことがない相手の場合はtrueとなるため、常連客と初めての相手で挨拶を使い分けることができます。

WhatsApp Business API番号への着信や、プラットフォーム経由で購入した番号、Android SMSゲートウェイとして使用している電話への着信では、このトリガーは起動しません。発信者が連絡先として保存されるのは、不在着信オートメーションがオンになっているアカウントのみです。オンになっていない場合、不在着信はアプリ内に一切記録されません。SMS番号にはもう1つ条件があります。Twilio経由のSMSカードの不在着信へのテキスト返信スイッチがオンになっている必要があります。このスイッチが、Twilioアカウント内のDM Champへ通話を転送する役割を果たすためです。手動で作成したSMS番号用オートメーションは、このスイッチがオフの間は機能しません。まずスイッチをオンにしてから、作成されたオートメーションをカスタマイズしてください。

例：スパムとしてタグ付けされた人を無視する #

時間を浪費する相手に一度タグを付ければ、二度と連絡を受けることはありません。同じ形式で「VIPとタグ付けされた人にのみ返信する」、「顧客とタグ付けされた人をスキップする」なども可能です。

1. 自動化を開始する。 AI Studio → 自動化 → 新しい自動化の順に進み、キャンバス上のトリガーをクリックします。

2. トリガーを選択する。 トリガーを変更をクリックし、メッセージングを開いて、受信メッセージを選択します。すべての会話をカバーするために、チャネルは 任意のチャネル のままにします。

3. チェックを追加する。 トリガーの後に 条件 手順を追加します。最初のフィールドで + ボタンをクリックし、検索ボックスに tag と入力して、tag_names（受信メッセージトリガーグループ内の連絡先の下にあるもの）を選択します。これが名前による連絡先のタグです。フィールドには自動的に ${trigger.contact.tag_names} が入力されます。比較を 含む に設定し、値ボックスにタグの名前を正確に入力します（例：spam）。

4. 実行内容を決定する。 真のパス（連絡先にタグがある場合に実行されるパス）に、おやすみモードを設定アクションを追加します。これにより、相手への送信が停止されます。3つの項目を入力します：連絡先IDは + ボタンを使用して入力（トリガーから連絡先を挿入し、手入力しないこと）、おやすみモードは true に設定し、必要に応じて自分用の記録として理由を入力します。会話は開いたままAIのみを沈黙させたい場合は、代わりに 連絡先のAIのオン/オフを切り替える を使用し、AIを有効にする を false に設定します。偽のパスは空のままにします。他のすべての人は通常通り進行します。

5. テストして有効にする。 実行をクリックしてサンプルデータで一度テストし、ログで実行結果を確認してから、有効スイッチをオンにします。

知っておくべき3つのこと：

• 大文字と小文字は区別されます。 Spam という名前のタグは spam とは一致しません。不明な場合は 設定 → タグ から名前をコピーしてください。タグの作成 を参照してください。
• tags ではなく tag_names を選択してください。 同じリストのすぐ隣にある tags は、名前ではなく内部IDコードを保持しています。それに対してチェックを行っても、入力した単語と一致することはないため、自動化は常に静かに偽のパスをたどることになります。フィールドを選択するのではなく入力したい場合は、必要なのは ${trigger.contact.tag_names} です。
• 次のメッセージから適用されます。 チェックはメッセージが到着した瞬間に連絡先が持っているタグを読み取るため、誰かにタグを付けても、すでに送信されたメッセージが取り消されるわけではありません。タグ付け自体を開始点にしたい場合は、タグが追加または削除された瞬間に起動する 連絡先が更新されました トリガーを使用してください。

例: キーワードでリストに参加（別のキーワードで退出） #

JOIN、VIP、OFFERS といったキーワードを送信してもらうだけで、ユーザーがリストに登録できるようにします。登録解除も同様に簡単です。2つの小さな自動化と1つの連絡先リストを設定するだけで、配信用のオーディエンスが自動的に構築されます。

1. 自動化を開始する。 AI Studio → 自動化 → 新しい自動化の順に進み、キャンバス上のトリガーをクリックします。

2. トリガーを選択します。 トリガーを変更をクリックし、メッセージングを開いて、受信メッセージを選択します。キーワードを有効にするチャネル（WhatsAppなど）を選択するか、任意のチャネルのままにします。テキストを含むに、キーワード（例: JOIN）を入力します。大文字と小文字は区別されません。join、Join、JOIN はすべて一致します。

3. リストに追加します。 連絡先をリストに追加アクションを追加します。+ ボタンを使用して連絡先IDを挿入し（連絡先はトリガーに含まれています）、ユーザーを追加するリストを選択します。まだリストがない場合は、先に作成してください（リストと連絡先の管理を参照）。

4. オプション: 確認メッセージを送信します。 その後にメッセージを送信アクションを追加し、同様に連絡先IDを挿入して、「リストに登録されました！いつでも STOP と返信すれば解除できます。」といったメッセージを設定します。

5. テストして有効にする。 実行をクリックしてサンプルデータで一度テストし、ログで実行結果を確認してから、有効スイッチをオンにします。

6. 退出ルートを作成します。 同じ手順で2つ目の自動化を作成します。同じトリガーでテキストを含むに STOP を設定し、アクションを連絡先をリストから削除に変更します。送信するメッセージには停止キーワードを記載してください。丁寧な退出方法があることを知っていれば、ユーザーは番号をブロックしなくなります。

これ以降、あらゆる配信でそのリストをオーディエンスとして使用できます。キーワードを送信した全員から、後で停止キーワードを送信した全員が除外されます。進行中の配信では、新しくリストに追加されたメンバーが自動的に対象となります。

知っておくべき点として、「テキストを含む」はメッセージ内のどこにあっても一致します。そのため、「joining you tomorrow」は join を含んでいるとみなされます。文中で使われないような単語を選ぶか、完全一致が必要な場合はトリガーの正規表現フィールドを使用してください。

例: ウィンドウが閉じた際にInstagramまたはFacebookのリードをWhatsAppへ移行する #

一般的な広告ファネルでは、ユーザーがInstagramやFacebookの広告を見てページにDMを送り、AIエージェントがそのユーザーを適格化して電話番号を尋ねます。リードがチャットで電話番号やメールアドレスを入力すると、AIはそれを連絡先の電話番号およびメールアドレスフィールドにリアルタイムで自動的に保存します。この部分については、マッピングや設定は一切不要です。

自動的に行われないのは、WhatsAppへの移行です。InstagramとMessengerは、連絡先からの最後のメッセージから24時間以内のメッセージ送信しか許可しておらず、会話を再開するためのテンプレートもサポートしていません。また、DM Champの組み込みフォローアップは常に会話が行われているチャネルに留まるため、ウィンドウが閉じると、それらのチャネルでのフォローアップは単にスキップされます（フォローアップシステムを参照）。この自動化により、AIが取得した番号を使用して移行を行うことができます。

1. 自動化を開始する。 AI Studio → 自動化 → 新しい自動化の順に進み、キャンバス上のトリガーをクリックします。

2. トリガーを選択します。 トリガーを変更をクリックし、連絡先を開いて、電話番号フィールドに絞り込んだ連絡先が更新されましたを選択します。これにより、会話がどのチャネルで行われているかに関係なく、AIが取得した番号を保存した瞬間にトリガーが実行されます。

3. 遅延を追加します。 例えば24時間などの固定待機時間を設定することで、会話やウィンドウ内の迅速なフォローアップが先に完了するまでの時間的余裕が生まれます。その間にリードがコンバージョンに至った場合は、次のステップの前に条件を使用して実行を停止できます（連絡先のtag_namesでCustomerのようなものをチェックします。これは例: スパムとしてタグ付けしたユーザーを無視すると同じパターンです）。

4. テンプレートを送信します。 WhatsAppテンプレートを送信アクションを追加し、+ボタンで連絡先IDを挿入し、承認済みのテンプレートを1つ選択します。テンプレートは会話を開始できるため、リードが長期間沈黙していても機能します。これがこのステップの目的です。テンプレート変数で空のままにした変数は、連絡先のフィールドから入力されます。これにはWhatsApp Business APIチャネルの接続が必要です。作成および承認についてはWhatsAppテンプレートを参照してください。

5. テストして有効にする。 実行をクリックしてサンプルデータで一度テストし、ログで実行結果を確認してから、有効スイッチをオンにします。

リードが返信すると、会話はWhatsApp上（24時間ウィンドウ内）で行われ、そこからエージェントが対応を継続します。

例：ShopifyからのWhatsApp注文確認 #

誰かがShopifyストアで注文した瞬間に、名前と注文番号を挿入したWhatsAppテンプレートを送信します。承認済みのテンプレート（例：「こんにちは {{1}} 様、ご注文ありがとうございます {{2}}！」）と、WhatsApp Business APIチャネルの接続が必要です。

1. Webhookトリガーから開始します。 新しい自動化を作成し、Webhookトリガーを選択してWebアドレスをコピーします。Shopifyはカスタムヘッダーを送信できないため、アドレスの末尾に?secret=とトリガーステップのシークレットを追加してください。

2. Shopifyで設定します。 Shopifyの設定 > 通知 > Webhookに移動し、JSON形式で注文作成のWebhookを作成してアドレスを貼り付けます。トリガーステップで受信Webhookを待機の下にある待機を開始をクリックし、テスト注文を行う（またはShopifyからテスト通知を送信する）か、キャプチャされた注文をサンプルとして選択して、**+**ピッカーにフィールドが表示されるようにします。

3. オプション：連絡先に注文番号を保存します。 連絡先を作成ステップを追加します。電話番号を${trigger.phone}に、名を${trigger.customer.first_name}に設定し、カスタムフィールドで注文番号フィールド（例：order_id）に${trigger.name}を入力します。顧客が既に連絡先として存在する場合、注文番号は既存の連絡先に保存されます。

4. テンプレートを送信します。 WhatsAppテンプレートを送信ステップを追加します。WhatsAppテンプレートの下に表示される名前を正確に入力し、送信先を入力します。連絡先を作成ステップの連絡先IDを挿入するか、電話番号に${trigger.phone}を入力します。テンプレート変数で、各ボックスを入力します：

• {{1}}（顧客名）：${trigger.customer.first_name}
• {{2}}（注文番号）：${trigger.name}（Shopifyの注文名、例：#1001）

注文の電話番号${trigger.phone}を国際形式で使用してください。Shopifyの注文では顧客の電話フィールド${trigger.customer.phone}が空であることが多く、番号なしで送信すると失敗します。

5. テストします。 キャプチャしたサンプルで実行をクリックし、ログで実行結果を開き、名前と注文番号が含まれたメッセージが送信されたことを確認します。

その後、自動化をオンにします。オフの間はShopifyのWebhookは受信され、受信Webhookを待機の下に表示されますが、メッセージは送信されません。

カゴ落ちリマインダー： Shopifyにはカゴ落ち用のWebhookはありません。Shopifyの「チェックアウト更新」Webhookを使用して同様の設定を行い、「遅延」を追加した後、2つ目の自動化（「注文作成」トリガー）によって購入者に付与されるタグに基づいた「条件」を追加することで、注文しなかった人にのみリマインダーを送信できます。

例：ウェブサイトチャットリードへのメールフォローアップ #

ウェブサイトでエージェントとチャットし、名前とメールアドレスを残したまま予約せずに離脱したユーザーがいるとします。数日間にわたってメールで状況を確認し、予約したという連絡があった時点で停止させたい場合、2つの自動化で実現できます。どちらも接続済みのメールチャネルを使用するため、返信はチャットに届き、メールエージェントが対応します。

開始する前に。 チャットウィジェットで訪問者情報を収集をオンにして、すべての訪問者が名前とメールアドレスを残すようにします。メールチャネルを接続し、タグタブで「予約済み — 予約またはセッションのスケジュールを完了したと本人が言った場合に適用」といったタグルールをエージェントに設定します（AIエージェント → タグ）。このタグが停止スイッチになります。

自動化1 — リードをメールへ移行する。

1. 受信メッセージトリガーをウェブサイトチャットチャネルに絞り込み、自動化設定で再入力を許可をオフにします。これにより、各訪問者は最初のメッセージで一度だけこのフローを通ります。（新しい連絡先トリガーは使用しないでください。「連絡先作成」トリガーの直後に連絡先を作成ステップを置くと、エディタが拒否する自己トリガーの形になります。詳細は自分自身をトリガーする自動化を参照してください。）
2. 連絡先のメールアドレスに対する条件を設定します（含まない unknown@）。これにより、アドレスを残さなかった訪問者は次のステップで失敗せず、ここで終了します。
3. 例えば1時間の遅延を入れ、ウェブサイトでの会話が終了するのを待ちます。
4. チャネルをメールに設定して連絡先を作成します。+ボタン(${trigger.contact.email})を使って訪問者のメールアドレスを挿入し、名と姓も同様に挿入します。電話番号は空のままにします。そのアドレスが既にメール連絡先として存在する場合、ステップは単にその連絡先を返します。
5. 連絡先を作成ステップから挿入した連絡先IDを使用してメッセージを送信します。これは接続済みの受信トレイからメールとして送信されます。最初の確認メール（例：「セッションの予約はできましたか？」）です。プロアクティブなメールには返信対象の以前のメッセージがないため、件名は「Message from」の後に受信トレイの送信者名が続きます。返信もその件名が維持されます。

自動化2 — メール連絡先に対するフォローアップシーケンス。

1. 新しい連絡先トリガーをメールチャネルに絞り込みます。自動化1がメール連絡先を作成した瞬間に起動します（誰かが最初にメールを送ってきた場合も起動するため、ウェブサイトのリードのみを対象にしたい場合は、タグや連絡先詳細に対する条件を追加してください）。
2. 2日間の遅延を入れます。
3. 連絡先のメールアドレス（トリガーから挿入）で連絡先を検索し、メールチャネルに絞り込みます。これにより、実行開始時ではなく現在の連絡先のタグ状態を読み取ることができます。
4. 条件：見つかった連絡先のtag_namesが Booked を含む。真のパスは空のままにします。これで予約した人の実行は終了します。
5. 偽のパスでは、2回目の確認メッセージをメッセージを送信し、その後遅延、連絡先を検索、条件、メッセージを送信を必要な回数だけ繰り返します。最後に Sequence complete のような連絡先タグを設定で終了させると、最後まで到達したユーザーを確認できます。

リードがいずれかのメールに返信すると、その会話はメール連絡先のチャットに既に存在しており、メールエージェントが回答します。返信内容に予約した旨が含まれていれば、エージェントのタグルールが「予約済み」を追加し、次のラウンドの条件によってシーケンスが終了します。自動化2の応答で停止はオフのままにしてください。オンにすると、「まだです」といった返信を含め、あらゆる返信でシーケンスが終了してしまいます。

知っておくべきことが2つあります。ウェブサイトチャットとメールの会話は、1つのスレッドに統合されるのではなく、同じアドレスを共有する2つの連絡先として扱われます。ウィジェットのチャットはウェブサイトの連絡先に残り、メールはメールの連絡先に残ります。また、連絡先はチャネルごとに1つであるため、同じ人物から先にメールが届いた場合、自動化1の「連絡先を作成」ステップは2つ目を作成せず、既存のメール連絡先を返します。

例：夜間はAI、日中はチームが対応 #

チームによってはシフトを逆転させている場合があります。AIエージェントが夕方から夜間を担当し、朝からは人間が引き継ぐという形です。エージェントの稼働時間（active hours）を夜間シフトに設定すれば、仕事の半分は完了です。日中に届いたメッセージは、AIの稼働時間が始まると同時にAIが回答し、それまでの間はチャットの**時間外（Outside hours）**フィルターに表示されます。

もう半分は、朝の引き継ぎを自動化することです。これにより、AIが午後9時に開始したチャットが、翌日の午前10時に顧客から返信があった際に、午後9時まで待機し続けるような事態を防ぎます。2つの小さな自動化でこれを実現します。1つ目は日中にメッセージが届いたチャットでAIを一時停止し、2つ目は夕方にすべてをAIに戻します。

自動化1：日中のチャットをチームに引き継ぐ

1. AI Studio → オートメーション → 新規オートメーション。トリガーはすでに受信メッセージになっています。アカウント全体に適用するか、特定のエージェントに絞り込んでください。
2. オートメーション設定（右上の歯車アイコン）で、指定した時間帯のみ実行するをオンにし、チームの営業時間（例: 08:00から20:45まで）とタイムゾーンを設定します（指定した時間帯のみ実行するを参照）。
3. 連絡先のAIをオンまたはオフにするアクションを追加し、+ボタンで連絡先IDを挿入し、AI有効をfalseに設定します。
4. day-shiftのようなタグを使用して連絡先タグを設定アクションを追加し、夜間のオートメーションでこれらのチャットを後から見つけられるようにします。

これで、日中に届いたメッセージは即座にその会話のAIを一時停止します。チャットは**AI一時停止（AI paused）**フィルターの下に表示され、そこからチームが返信します。手動で返信すると、そのチャットに対してキューに入れられていたAIの回答もキャンセルされるため、AIの稼働時間が始まってもAIが割り込むことはありません。

自動化2：夕方にチャットをAIに戻す

1. **スケジュール通り（On schedule）**トリガーで新しい自動化を作成し、AIの稼働時間が始まる数分前に設定します。午後9時開始なら、同じタイムゾーンで cron 50 20 * * * を設定します。
2. **連絡先を検索（Find contacts）**アクションを追加し、タグあり（With tag） day-shift でフィルタリングします。
3. 結果に対してループ（Loop）を追加し、内部に2つのステップを入れます。連絡先のAIをオン/オフにするでAI有効を true にし、次に連絡先タグを削除（Remove contact tag） day-shift を実行します。

チームが日中に完了したチャットは夜間にAIに戻され、誰も対応できなかった日中のチャットも、エージェントの稼働時間が始まった瞬間にキューに入れられていたAIの回答が送信されます。これで取りこぼしはなくなります。

キャンバスのツールバーにある 実行 (Run) をクリックすると、実際の連絡先に対して有効にすることなく、サンプルデータを使用して自動化を1回実行できます。これは動作を確認するための安全な方法です。リプレイ (Replay) は、前回の実行時の実際のデータを使用して再実行します。ログ (Log) を開くと実行履歴が表示され、過去のすべての実行結果（成功、失敗、進行中）を確認できます。

実行のキャンセル。 まだ実行中のもの（遅延で待機中や、静かな時間帯のために保留中のものを含む）は、手動で停止できます。実行履歴の該当行にある キャンセル をクリックするか、実行を開いて 実行をキャンセル をクリックし、確認してください。実行はその時点で停止し、キャンセル済み と表示されます。まだ到達していないステップは実行されないため、それ以降の処理は送信されません。すでに実行済みのステップは取り消されません。影響を受けるのはその実行のみであり、他のユーザーのオートメーションはそのまま継続されます。

以下の3つの機能により、連絡先に気づかれる前にミスを未然に防ぐことができます。

• 必要な情報が不足しているステップは開始されません。 必須とマークされたフィールドは実行前にチェックされ、有効スイッチが切り替わる前にも確認されます。例えば、メッセージを送信ステップに連絡先IDがない場合、実行が密かに失敗するのではなく、ステップ名とフィールド名を指定したメッセージが表示されます。情報を入力すれば、スイッチは通常通り機能します。一時停止がブロックされることはありません。
• 解決されない変数は報告されます。 ステップ内の ${…} 値が見つからなかった場合（フィールド名のスペルミスや、トリガーが実際には保持していないデータなど）、ステップはその部分を空白のまま実行し、実行詳細には空のまま渡された項目を正確に示す警告行が表示されます。「なぜメッセージに空欄があるのか」という疑問に対する答えは、通常ここにあります。
• 別の分岐に進んだ実行は、その旨を表示します。 実行後、キャンバス上の実行パネルには、通過したすべての条件と、進んだ分岐（はいまたはいいえ）がリスト表示され、実行されなかったステップの数がカウントされます。条件の回答がいいえだった実行も成功として終了するため、ここではいのパスにあるステップがスキップされたことを確認できます。
• 拒否されたステップは、理由とともに失敗として表示されます。 アプリによって拒否されたステップ（重複する連絡先、存在しないステージ、承認されていないテンプレートなど）は失敗としてマークされ、単に緑色のチェックマークが表示されるのではなく、その理由が表示されます。

Webhook トリガーで開始される自動化の場合、実行履歴には実行に至らなかった呼び出しに関する警告も表示されます。シークレットが欠落しているか間違っている状態でWebhookが呼び出されている場合、上部のバナーに拒否されたリクエスト数が表示され、修正すべき内容が通知されます。呼び出し元は、X-Webhook-Secret ヘッダーまたはURLの末尾の ?secret= として、トリガーステップのシークレットを送信する必要があります。以前は、これらの呼び出しは単に拒否され、何も表示されなかったため、設定が誤っている呼び出し元は自動化が全く起動していないように見えていました。

例：毎朝の誕生日メッセージ #

各連絡先に誕生日にメッセージを送信します。誕生日を保持する日付カスタムフィールドが必要です（年は何でも構いません。月と日のみが使用されます）。

1. AI Studio → オートメーション → 新しいオートメーションでスケジュール通りトリガーを選択し、タイムゾーンに合わせて0 9 * * *（毎日午前9時）に設定します。
2. 連絡先を検索アクションを追加します。高度なフィルターで「誕生日」「記念日が次のN日以内」「0（今日のみ）」というルールを追加します。件数を1000に設定します。デフォルトは50で、検索対象の連絡先のみがマッチします。
3. ループを追加し、+ボタンを使用して連絡先を検索ステップの連絡先リストを処理対象として選択します。
4. ループの本体ハンドルにメッセージを送信ステップを追加します。連絡先IDには、**+**ボタンを使用してループアイテムのIDを挿入します（ループがloop_1と呼ばれるとき、${nodes.loop_1.item.id}と表示されます）。メッセージも同様に、アイテムのfirst_nameを使用して名前で挨拶できます。

これでオートメーションは完了です。連絡先を検索が今日の誕生日のみを返すため、条件ステップや変換ステップは不要です。該当者がいない日はループが0回実行され、実行結果は「成功」となります。

誕生日ルールはUTCで日数をカウントします。朝の実行であればほとんどの場所で問題ありませんが、UTCより9時間以上進んでいる場合は、日付がUTCと一致するように、その日の遅い時間（シドニーなら午前11時以降、ニュージーランドなら午後1時以降）に実行してください。

自動化の有効化 #

有効 スイッチを使用してライブ状態にします（最初にドラフトが保存されます）。その時点から、トリガーが発生するたびに実際に実行されます。いつでも 一時停止 に戻すことで、作業内容を失うことなく停止できます。一時停止すると新しい実行は開始されなくなりますが、遅延 や静かな時間帯で待機中の実行はそのまま完了します。それらを停止するには、ログ をクリックし、実行履歴の該当行で キャンセル を使用してください。オートメーションを削除するには、事前に一時停止しておく必要があります。

自動的にトリガーされるオートメーション #

一部のフローは、それ自身をトリガーとして起動してしまうことがあります。典型的な例として、「タスク作成」をトリガーとして開始し、「タスク作成」ステップを含む自動化が挙げられます。新しいタスクが作成されると再びトリガーが作動し、さらに別のタスクが作成されるというループが1秒間に1回程度のペースで繰り返され、そのたびにクレジットが消費されます。同様のことは、「連絡先作成」と「連絡先作成」、「予約完了」と「予約作成」、「案件作成」と「案件作成」の組み合わせでも起こり得ます。

これを防ぐために、3つの保護機能が用意されています。

• エディターが即座に警告します。 フローがそのような構成になると、キャンバス上部に該当するステップと修正方法を記した赤いバナーが表示され、ステップには赤いマーカーが付きます。また、修正されるまで「有効」スイッチ、「実行」、「リプレイ」はオフのままになります。一時停止中の自動化は編集や保存を続けられますが、すでに有効な自動化の場合、一時停止するかステップを修正しない限り変更は保存されません。自身を再トリガーする可能性があるフロー（「連絡先更新」トリガーと、連絡先を変更するステップ（詳細、タグ、リスト、カスタムフィールドの編集、チームメンバーへの割り当て、AIのオン/オフ切り替え、おやすみモードの設定、他のAIエージェントへの引き継ぎなど）の組み合わせ）には、代わりに黄色の警告が表示されます。これは実行をブロックするものではありません。トリガーが監視するフィールドを選択して、必要な変更があった場合にのみ開始されるようにしてください。「案件ステージ変更」トリガーと「案件ステージ移動」ステップ、または「タグ追加」や「タグ削除」トリガーと「連絡先タグ設定」や「連絡先タグ削除」ステップの組み合わせにも同様の黄色い警告が表示されます。これらは通常のフロー（「成約に達したらタグを付ける」など）ですが、ステップがトリガーの監視対象を書き換えてしまう可能性があるため、警告を表示して判断を委ねています。
• AIビルダーは明らかなループ構成を拒否します。 「何かが作成された」トリガーの後に、同じ種類のものを「作成する」ステップが続くようなフローを記述した場合、ビルダーはその作成を拒否し、どのステップを変更すべきか通知します。実行を開始した対象そのものを変更したい場合（作成されたばかりのタスクに期限を設定する、新しく追加された連絡先にタグを付けるなど）は、トリガーのIDに対して対応する「更新」ステップを使用してください。具体的には、${trigger.task.id} を使用した「タスク更新」、${trigger.contact.id} を使用した「連絡先更新」などです。更新操作は「作成」トリガーを再起動させません。
• 暴走した自動化は自動的にオフになります。 数分間にわたって1分間に30回以上の実行が続く自動化は自動的に一時停止され、履歴にその理由を説明する失敗した実行ログが表示されます。前述のような自己増殖型の構成を持つ自動化は、1分間に10回実行された時点で、より迅速に停止されます。通常のバースト的な実行は問題ありません。例えば、300件の連絡先を「連絡先作成」自動化にインポートすると、1分間に300回の実行が発生してその後停止しますが、これはループではありません。ツールバーから手動で開始したテスト実行はカウントされません。フローを修正してから、再度有効にしてください。

自動化の料金 #

オートメーションの各実行には、トリガーが実際に起動した場合でも、手動で実行やリプレイを押した場合でも、0.25クレジットが消費されます。0.25クレジットは実行開始時に一度だけ課金されるため、条件ステップの最初の分岐で停止した実行であっても、1回の実行としてカウントされ、同じく0.25クレジットが消費されます。オートメーションは追加費用なしでいくらでもステップを構築できます。料金が加算される唯一のステップはAIステップで、実行されるたびに0.25クレジットが追加で消費されます。AIステップは、エージェントがどのモデルを使用していても常に「Max」モデルで実行されるため、エージェントを「Mini」に切り替えてもオートメーションのコストは変わりません。残高が不足すると、実行履歴に「クレジット不足」という明確なメッセージが表示されて実行が失敗します。チャージが完了すれば、新しい実行は再び正常に行われます。

アカウントAPIセクションのステップは、APIへの同じ呼び出しと同じ料金で請求されます。ほとんどのエンドポイントは無料ですが、会話の要約などAIを実行するものは、APIが定める料金がかかります。それ以外に追加のステップ料金は発生しません。

実行料金は、常にオートメーションが保存されているアカウントから差し引かれます。サブアカウントIDフィールドを使用してステップをサブアカウントのいずれかに指定しても、請求先が移動することはありません。実行料金は引き続きワークスペースに請求され、そのステップによってサブアカウント内で開始された処理（一時停止されていないチャットへのAIによる返信など）は、通常通りそのサブアカウントに請求されます。クライアント自身の残高から実行料金を支払いたい場合は、代わりにクライアントのアカウント内でオートメーションを作成してください。

独自のAnthropicキーを使用する場合（BYOK） 自動化は、キーの使用に関わらずクレジットで課金されます。AIステップは、お客様のキーではなく、当社の組み込み自動化AIで実行されるため、通常の自動化実行と同様に、実行ごとに常に0.25クレジットが消費されます。お客様のキーは、これまで通りエージェントの返信に対して適用され、両者が干渉することはありません。

自動化とエントリーポイントの違い #

これらは似ていますが、解決する問題が異なります。

• エントリーポイントは、「イベントを照合して会話をエージェントに引き継ぐ」という単一の機能のみを実行します。遅延、条件分岐、複雑なフローはありません。
• 自動化は完全なワークフローツールです。会話の引き継ぎだけでなく、連絡先、案件、タスク、外部統合にまたがる複数のステップ、条件、遅延、アクションを実行できます。

「この会話をあのアエージェントにルーティングする」だけであれば、エントリーポイントを使用してください。それ以上のステップやロジックが必要な場合は、自動化を構築してください。

オートメーションをクライアントアカウントにコピーする #

クライアントアカウントを運用している場合、自分のアカウントで完成させた自動化設定を、どのクライアントアカウントにもコピーできます。自動化リストで、対象の自動化設定の行にある クライアントアカウントにコピー ボタン（2つの矢印のアイコン）をクリックし、コピー先のクライアントアカウントにチェックを入れて コピー先 をクリックします。このボタンは 複製 ボタンの隣にあり、エージェンシーアカウントでのみ表示されます。

コピーには、自動化の名前、トリガー、およびすべてのステップが保持されます。クライアントのアカウントでは、以下の2点が意図的に変更されます。

• 一時停止状態で保存されます。 クライアントのアカウントで誰かがそれを開き、内容を確認して有効に切り替えるまで、何も実行されません。
• 自分のアカウントを参照していた設定はすべてクリアされます。 これらのIDは他人のアカウントでは意味をなさないためです（ステップの対象となっていたクライアントアカウント、選択されたスマートリスト、選択されたカレンダーイベント、選択されたデータベース接続など）。コピーが完了したら、クライアント自身の情報でそれらを埋めてください。ステップ自体は変更されません。

ステップやトリガーが自分のAIエージェントのいずれかを指していた場合、コピーは自動的にクライアントの対応するエージェントを指すように試みます。これは、クライアントのエージェントが同じスナップショットから作成されたか、自分の同じエージェントからコピーされたものである場合に機能します。両者が同じ設定であることをシステムが認識するため、リンクは自動的に再作成されます。一致するものがない場合は、どのエージェントを配置できなかったかが通知されます。クライアントのアカウントで自動化を開き、そこでエージェントを選択して有効にしてください。

複数のオートメーションを同時に操作する #

自動化リストの各行にはチェックボックスがあり、ヘッダーのチェックボックスですべてを選択できます。自動化を選択すると、画面下部のバーに 有効化、一時停止、削除 が表示されます。それぞれ確認が求められ、削除すると自動化の実行履歴も削除されます。Escキーを押すと選択が解除されます。

次のステップ #

• エントリーポイント — エージェントに会話を引き継ぐための、よりシンプルなルーティングツールです。
• AIエージェント — オートメーションやエントリーポイントがルーティング先として指定できるペルソナです。
• ブロードキャスト — 連絡先リストに対して、単発または継続的なメッセージを送信します。
• 予約システム — オートメーションでリマインド、予約、変更、キャンセルを行えるアポイントメントを設定します。
• WhatsAppテンプレート — WhatsAppの24時間ウィンドウ外の相手にメッセージを送る際に必要となります。