Flow ノードパラメータ リファレンス
Flow ノードパラメータ リファレンスは、ノード設定のためのオンデマンド参照ガイドです。各ノードは、目的、ユースケース、主要パラメータ、出力分岐、注意事項、例という一貫した構成に従っており、フロー構築時に必要な情報をすばやく確認できるようにしています。
利用可能な機能は、チャネルやワークスペースによって異なる場合があります。実際に Flow エディタで利用可能なオプションやプロンプトを参照してください。
このリファレンスの使い方
このリファレンス内の各ノードは、以下の構成で記載されています。
- 目的: ノードが行うこと
- ユースケース: 使用する場面
- 主要パラメータ: 設定すべき最も重要なパラメータ
- 出力分岐: ノードが遷移できる経路
- 注意事項: 見落としやすい制限や注意点
- 例: ノードの一般的な使い方
ノードカテゴリの概要
| ノードカテゴリ | ノード名 |
|---|---|
| エントリー | Event Trigger |
| 判定・制御 | Conditional Branch, Wait for Behavior, Delay, A/B Random Split, Merge |
| メッセージ送信 | Send Message, Invite Rating, Send Email |
| アクション | Assign Agent, Assign AI Agent, Add Label, Change Status, Change Priority, Snooze Conversation, Update Customer Data, Update Conversation Data, Block Contact, Send Webhook, Call API |
エントリーノード
Event Trigger
目的
フローの開始地点、トリガー方法、対象オーディエンスを定義します。
ユースケース
- 会話が作成されたとき
- 訪問者がメッセージを送信したとき
- 指定されたイベントが発生したとき
- AI またはシステムイベントがトリガーされたとき
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Trigger event | フローの開始イベント | Yes | フローをいつ開始するかを決定します。訪問者メッセージ、会話作成、会話オープン、会話更新、しきい値を超えた顧客待機イベント、訪問者の返信タイムアウト、AI Agent の応答例外などが含まれます。 |
| Audience scope | 対象ユーザー | Yes | 匿名ユーザーと登録ユーザーを対象にできます。匿名ユーザーは、本人確認情報、電話番号、メール情報をまだ提供していないユーザーです。連絡先属性や会話属性で絞り込むフィルタ条件を追加できます。 |
| Channel scope | 対象チャネル | Recommended | マルチチャネルフローでは、対象範囲を明確に制限してください。チャネルが選択されていない場合、この開始条件はいずれの会話にも一致しません。 |
出力分岐
- デフォルトで続行
注意事項
- Trigger は、いつ開始するかだけでなく、誰が開始できるかも定義します。
- 同じ業務シナリオでオーディエンス設定や頻度設定が不明確だと、トリガーが重複しやすくなります。
例
「AI Agent でエラーが発生した際に、人間のエージェントへ引き継ぐフォールバックフローを開始する。」
判定・制御ノード
Conditional Branch
目的
現在の会話情報または顧客情報に基づいてフローを異なる経路へ振り分け、一致しない場合は自動的にフォールバックします。
ユースケース
- 国別に振り分ける
- ラベル別に振り分ける
- ソースまたはチャネル別に振り分ける
- ステータス、優先度、言語別に振り分ける
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Branch condition | 各分岐のルール | Yes | 複数のケースを設定でき、関連する連絡先属性や会話属性に基づいてフィルタリングできます。 |
| Branch name | 分岐ラベル | Recommended | キャンバス上で識別しやすくなり、テストトレースも追跡しやすくなります。 |
| Fallback path | 一致条件がない場合の経路 | Recommended | 一致しないケースをカバーします。Otherwise 分岐を選択すると、すべての条件を満たさない場合に、Otherwise 用に設定された分岐へ進みます。 |
出力分岐
- 条件分岐ごとに 1 つの出力
- フォールバック出力
注意事項
- 条件が重複したり競合したりしないようにしてください。
例
「北米、日本、ヨーロッパの訪問者をそれぞれ対応するウェルカムメッセージへ振り分け、それ以外の訪問者はデフォルト言語のウェルカムメッセージへ送る。」
Wait for Behavior
目的
特定の行動が発生するまで待機し、その後のフロー進行を決定します。待機時間も設定できます。
ユースケース
- ユーザーの返信を待つ
- イベントの変更を待つ
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Behavior to wait for | 待機するイベント | Yes | たとえば、メッセージ、会話、連絡先イベントです。利用可能な行動には、顧客返信、エージェント返信、会話のオープン、ステータスの Resolved への変更、連絡先データ更新などがあります。 |
| Timeout | 最大待機時間 | Yes | 常に設定することを推奨します。分、時間、日で設定できます。 |
| Path after timeout | 行動が発生しなかった場合の動作 | Recommended | フォールバックとして使用されます。 |
出力分岐
- 発生
- タイムアウト
注意事項
- タイムアウト出口のない待機ノードは、フロー停止の原因になる可能性があります。
- 待機時間が長いほど、業務目的とフォールバック経路をより明確に定義する必要があります。
例
「ウェルカムメッセージ送信後、10 分待機する。ユーザーが返信した場合は問い合わせ対応を続行し、返信がない場合はその会話を非アクティブとして扱う。」
Delay
目的
指定した時間が経過した後にフローを続行します。
ユースケース
- 遅延リマインドを送信する
- 会話終了後しばらくしてから評価依頼を送信する
- 翌日の特定時刻にフローを続行する
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Delay duration / time | 続行するタイミング | Yes | 期間または特定時点として設定できます。 |
| Continue path | 遅延後の遷移先 | Available by default | 通常はデフォルトで続行します。 |
出力分岐
- デフォルトで続行
注意事項
- Delay ノードはタイミングを制御するものであり、業務条件を評価するものではありません。
- 遅延後にも条件確認が必要な場合は、次のノードとして条件分岐を追加してください。
例
「会話終了の 30 分後に満足度評価の案内を送信する。」
A/B Random Split
目的
複数バージョンにトラフィックをランダムに分割し、異なる文言や経路をテストします。
ユースケース
- ウェルカムメッセージの効果を比較する
- 支払いリマインド文言を比較する
- 2 つのコンバージョン経路を比較する
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Version name | 各実験バージョンの識別子 | Yes | わかりやすい名前を使用してください。 |
| Split ratio | 各バージョンの配分率 | Yes | すべてのバージョンの合計で全体を完全にカバーする必要があります。 |
出力分岐
- 実験バージョンごとに 1 つの出力
注意事項
- 結果を評価するために、A/B ノードは明確な目標イベントと組み合わせて使用してください。
- バージョン間で変更する要素は、一度に 1 つまたは 2 つの主要変数にとどめてください。
例
「ユーザーの 50% には割引重視の支払いリマインド文言を、残りの 50% には緊急性重視の支払いリマインド文言を表示する。」
Merge
目的
複数の経路を再び 1 つにまとめ、同じ次のステップへ接続します。
ユースケース
- 異なる分岐で先に別々の処理を行った後、同じ後続アクションを共有する
- 異なる言語のウェルカムメッセージの後に、同じ問い合わせプロセスへ進む
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Merge rule | どの経路をまとめるか | Yes | 通常は接続線によって表されます。マージ条件は 2 種類あり、すべての経路が到達した後に続行するか、いずれかの経路が到達した時点で続行するかを選択できます。 |
出力分岐
- デフォルトで続行
注意事項
- マージ前に、すべての経路で必要なアクションが完了していることを確認してください。
例
「異なる国向けのウェルカムメッセージ送信後、すべての経路を同じエージェント割り当てノードへ進める。」
メッセージ送信ノード
Send Message
目的
テキスト、画像、動画、添付ファイルを含む基本的なマルチパートメッセージをユーザーに送信します。URL ボタンまたは分岐ボタンを含めることもできます。
ユースケース
- ウェルカムメッセージ
- リマインドメッセージ
- ガイダンスメッセージ
- ボタンベースのルーティングメッセージ
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Message block | 送信するテキスト内容 | Yes | メッセージブロック単位で編集できます。 |
| Language version | 各テキストの言語分類 | Optional | 同じテキストに対して複数の言語バージョンを設定できます。 |
| Default language | 一致しない場合のフォールバック文言 | Yes | フォールバックとして使用されます。 |
| Button type | URL ボタンまたは分岐ボタン | Optional | 2 種類のボタンは用途が異なります。 |
| Button copy | ユーザーに表示されるボタン名 | Optional | 短く明確にしてください。 |
| Destination URL / branch key | ボタン動作 | Depends on button type | URL ボタンは対応するリンクをブラウザタブで開き、分岐ボタンは対応する分岐を通じてフローを続行します。 |
| Not-clicked time window | ボタンがクリックされない場合のカウントダウン | Recommended when using branch buttons | クリックされなかった場合の出力を制御します。 |
出力分岐
- デフォルトで続行
- ボタン分岐
- クリックされない
- 送信失敗
注意事項
- 多言語コンテンツでは、同じテキストメッセージ内に異なる言語バージョンを設定し、デフォルト言語を保持してください。
- 分岐ボタンは、ユーザーに次のステップを明確に選択してもらうシナリオに適しています。
- クリックされない場合に備えて、カウントダウン時間とフォールバック分岐を設定してください。カウントダウン時間はカスタマイズ可能です。
- ボタン、添付ファイル、リッチメディアのチャネル対応状況は異なる場合があります。
例
「こんにちは。知りたい内容を選択してください: 料金 / 製品デモ / サポートへの問い合わせ」
Invite Rating
目的
適切なタイミングで評価または満足度フィードバックを依頼します。
ユースケース
- 会話終了後に CSAT を収集する
- アフターサービス完了後に満足度フィードバックを収集する
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Invitation copy | ユーザーに評価を依頼する文言 | Yes | 短く丁寧にしてください。 |
| Rating method | 評価の収集方法 | Yes | LiveDesk の CSAT 評価システムに準拠します。 |
| Result handling | 評価受領後の処理 | Recommended | ラベル付与、エスカレーション、またはフォローアップ経路へつなげることができます。 |
出力分岐
- デフォルトで続行
- 送信失敗
注意事項
- 評価依頼は通常、Delay ノードの後に使用するのが最適です。
- 業務タスク完了後または問題解決後にトリガーしてください。早すぎる送信は避けてください。
例
「今回のサービスにご満足いただけましたか？ぜひ評価をお聞かせください。」
Send Email
目的
メールを通じて会話の外でユーザーに連絡したり、会話記録を送信したりします。
ユースケース
- 見積書や資料を送信する
- 会話記録を送信する
- 外部通知を追加する
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Recipient | メール受信者 | Yes | 指定したメールアドレスまたは取得済みのメールアドレスを使用できます。 |
| Subject | メール件名 | Recommended | 開封率に影響します。 |
| Body / template | メール内容 | Yes | カスタマイズまたはテンプレートベースで設定できます。 |
| Content mode | カスタム内容または会話記録 | Based on the use case | 配信方法を区別します。 |
出力分岐
- デフォルトで続行
- 送信失敗
注意事項
- メール送信前に、対象のメールアドレスが存在し有効であることを確認してください。
- メールは補足情報の提供に適しており、主要な会話フローの置き換えには向きません。
例
「ユーザーがメールアドレスを残した後、自動で見積メールを送信する。」
アクションノード
Assign Agent
目的
現在の会話を人間のエージェントまたはエージェントチームに引き継ぎます。指定されたエージェントは、対応するチャネルの Human Agent リストに含まれている必要があります。チャネルに対してエージェントが設定されていない場合、割り当ては失敗し、会話は未割り当てのままになります。
ユースケース
- 高価値顧客を人間のエージェントへ引き継ぐ
- タイムアウト内に対応されなかったユーザーをエスカレーションする
- AI フォールバック失敗後に人間のエージェントへ引き継ぐ
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Assignment method | 割り当て方法 | Yes | 特定のエージェントへの割り当て、チーム単位、または戦略ベースの割り当てとして設定できます。特定の人間エージェントへ割り当てる場合は、割り当て戦略を明確に定義してください。 |
| Target agent / agent team | 割り当て先 | Depends on method | 業務範囲に適合している必要があります。 |
| Handoff message | 割り当て後に説明メッセージを送るかどうか | Optional | メッセージノードと併用されることがよくあります。 |
出力分岐
- デフォルトで続行
注意事項
- 割り当て先は、現在の会話の受信トレイおよび業務範囲に対して受け入れ可能である必要があります。
- ユーザーが唐突な中断を感じないよう、割り当ては説明メッセージと組み合わせて使用することを推奨します。
例
「高優先度の会話をただちに人間サポートチームへ割り当てる。」
Assign AI Agent
目的
会話を AI エージェントに引き継ぎます。
ユースケース
- 標準的な質問を自動処理する
- 夜間に無人サポートを提供する
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| AI target | 割り当て先の AI | Yes | 対象の AI を事前に準備してください。 |
| Enablement condition | AI に引き継ぐタイミング | A preceding decision is recommended | 分岐ノードと併用されることがよくあります。 |
出力分岐
- デフォルトで続行
注意事項
- AI で対応できないケースに備えて、このノードはフォールバック経路と組み合わせて使用することを推奨します。
例
「基本的な問い合わせは AI に割り当て、複雑な問い合わせは人間対応の経路に残す。」
Add Label
目的
会話に分類ラベルを追加します。
ユースケース
- ソースを示す
- 意図を示す
- フローステージを示す
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Label value | 追加するラベル | Yes | 後続のレポートや分岐判定に利用できます。 |
出力分岐
- デフォルトで続行
例
「ユーザーが返信した後に『Contacted』ラベルを追加する。」
Change Status
目的
会話ステータスを更新します。
ユースケース
- 会話を自動でクローズする
- 対応中としてマークする
- 遅延対応対象としてマークする
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Target status | 変更先ステータス | Yes | 業務上のステータス体系と一貫性を保ってください。 |
出力分岐
- デフォルトで続行
例
「タイムアウト後も返信のない会話を Resolved に変更する。」
Change Priority
目的
会話の優先度を上げる、または下げます。
ユースケース
- 苦情をエスカレーションする
- 高価値顧客の対応を優先する
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Priority | 対象の優先度 | Yes | 後続の割り当てや対応順序に使用されます。 |
出力分岐
- デフォルトで続行
例
「緊急課題が特定された場合、会話の優先度を High に引き上げる。」
Update Customer Data
目的
フロー中に収集した情報を顧客プロフィールへ反映します。
ユースケース
- 取得した情報を連絡先へ書き戻す
- 顧客の言語や地域を記録する
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Field | 更新するデータフィールド | Yes | 顧客プロフィールのフィールドに対応します。 |
| Value | 更新する値 | Yes | 固定値またはフロー変数を使用できます。 |
出力分岐
- デフォルトで続行
例
「メッセージに含まれるメールアドレスで顧客データを更新する。」
Update Conversation Data
目的
フロー情報を会話レベルの属性へ書き戻します。
ユースケース
- 現在のフローステージを記録する
- 外部 API から返された結果を保存する
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Attribute name | 会話属性の名前 | Yes | 後続の分岐で参照しやすくなります。 |
| Attribute value | 書き込む値 | Yes | 固定値または変数を使用できます。 |
出力分岐
- デフォルトで続行
例
「後続のレポート用に、現在のルーティング結果を会話データへ書き込む。」
Block Contact
目的
リスクのあるユーザーを制限します。この連絡先からの会話メッセージは以後受け付けられなくなります。
ユースケース
- 悪質な嫌がらせ
- 無効なトリガーの頻発
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Handling rule | 連絡先をブロックする | Yes | 業務上のガバナンスルールと一致している必要があります。 |
出力分岐
- デフォルトで続行
例
「メッセージにセンシティブワードが含まれている場合、その連絡先をブロックリストに追加する。」
Send Webhook
目的
現在のフロー情報を外部システムへ送信します。
ユースケース
- CRM に通知する
- BI に通知する
- ボットまたは連携プラットフォームを同期する
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Request method | 使用する HTTP メソッド | Yes | たとえば、POST や GET です。 |
| URL | 送信先 | Yes | 外部システムでリクエストを受け取るアドレスです。 |
| Request headers | 追加のヘッダー情報 | Optional | 認証やコンテンツ仕様に使用されます。 |
| Request parameters / body | 送信するデータ | Optional | 業務データを構造化するために使用されます。 |
| Timeout | 最大待機時間 | Recommended | 信頼性の制御に役立ちます。 |
出力分岐
- デフォルトで続行
注意事項
- Webhook は情報を外部へ送信する用途に適しており、戻り値に依存して複雑な後続判断を行う用途には向きません。
- 外部結果に基づいて分岐が必要な場合は、代わりに Call API ノードを使用してください。
例
「ユーザーが人間への引き継ぎ経路に入ったとき、会話情報を外部システムへ同期する。」
Call API
目的
外部システムにリクエストを送信し、その結果を後続フローの判断に使用します。
ユースケース
- 注文ステータスを確認する
- 在庫を確認する
- ユーザーランクを確認する
主要パラメータ
| パラメータ | 意味 | 必須 | 説明 |
|---|---|---|---|
| Request method | 使用する HTTP メソッド | Yes | たとえば、GET や POST です。 |
| URL | リクエスト先 | Yes | 外部 API のエンドポイントです。 |
| Request headers | 追加のヘッダー情報 | Optional | 認証に使用されます。 |
| Parameters / body | 送信する値 | Optional | 変数を含めることができます。 |
| Timeout | 最大待機時間 | Recommended | フローが長時間待機しすぎるのを防ぎます。 |
| Result binding | 結果の書き込み先 | Recommended | 後続ノードで結果を利用できるようにします。 |
出力分岐
- 成功
- 失敗
注意事項
- API ノードは、結果を取得したうえで判断する用途により適しています。
- 後続ノードで使えるよう、返却データは速やかに変数または会話データへ書き込んでください。
例
「まず注文の支払いステータスを確認し、その後、支払いリマインド経路またはアフターサービス経路のいずれかを選択する。」
一般的なパラメータ設定ガイド
ノードを保守しやすくするため、パラメータ設定時には以下の原則に従ってください。
- 文言パラメータ: 直接的で、簡潔かつ曖昧さのない表現にする
- 条件パラメータ: 検証可能にし、曖昧な条件を避ける
- 時間パラメータ: 単位と業務上の意味を常に明記する
- 外部呼び出しパラメータ: 追跡しやすい一貫した名前を使用する
- 変数パラメータ: 一貫した名前を使用し、同じ意味に対して別名を使わない
制限事項と適用範囲
以下は実装詳細ではなく、フロー設定前に知っておくべき注意点です。
テキストの長さ
- テキストメッセージは簡潔に保ってください。
- 長文の文言は、読みやすさに影響する場合があります。
- マルチチャネル環境では、長すぎるテキストはデバイスごとに表示が異なる可能性があります。
ボタン数
- 1 つのメッセージ内のボタン数は少なく保ってください。
- 最も重要な 1 つまたは 2 つの選択肢を優先してください。
- ボタンが多すぎるとクリック率が低下し、チャネル差異の影響も受けやすくなります。
添付ファイルとリッチメディア
- サポートされるファイル形式、数量、サイズはチャネルごとに異なる場合があります。
- 添付ファイルやリッチメディアを設定する前に、対象チャネルの対応範囲を確認してください。
分岐ボタンの適用範囲
- 分岐ボタンは、次のステップが明確な選択肢に適しています。
- 複雑なインタラクションでは、事前に対象チャネルでテストと検証を行ってください。
割り当て先の制限
- 割り当て可能なエージェント、チーム、または AI は、現在の業務範囲および引き継ぎルールに準拠している必要があります。
- 設定した対象に会話の受信資格がない場合、フロー結果は想定と異なるものになる可能性があります。
外部呼び出しの信頼性
- Webhook と API 呼び出しはいずれも、外部システムの可用性に依存します。
- 失敗、タイムアウト、フォールバック経路を必ず考慮してください。
