アクション

Human Handoff、リード獲得のためのスマートデータ収集、外部ツール連携のカスタムAPIアクションなど、AIエージェントのアクションを設定します。

会話中に AI エージェントが実行できることを定義します。リアルタイム API データを使った回答、リード情報の収集、カスタム処理の実行まで対応できます。

人への引き継ぎ（Human Handoff）

Human Handoff は、人の対応が必要な会話をスムーズに有人エージェントへ引き継ぎます。

ナレッジベースの範囲外の質問や「人と話したい」という明示的な要望に有効です。引き継ぎ中は AI アシスタントが一時停止し、Inbox 上で人の担当者が会話を引き継ぎます。

ユーザー側の流れ：

ユーザーが AI とやり取りする。
AI の範囲外または人対応を希望 → AI が引き継ぎを通知。
会話が AI から外れ、有人エージェントに割り当て。
人が解決、または AI に再割り当て。

訪問者側の引き継ぎ

Quickchat 画面側の流れ：

未割り当ての会話が Inbox に表示。
担当者が AI サマリーで経緯を把握。
会話を引き継いで対応。
解決または再割り当て。

アプリ側の引き継ぎ

Human Handoff を有効化

Capabilities > Human Handoff でトグルをオンにします。

有効化

設定できる項目：

有人エージェントの稼働時間

営業時間：開始/終了と稼働日
タイムゾーン
時間外メッセージ

稼働時間設定

事前の質問

引き継ぎ前に AI が確認する質問。

例：サポート担当におつなぎしてもよろしいですか？

質問設定

確認メッセージ

引き継ぎ開始時の確認文言。

例：承知しました。サポート担当におつなぎします。少々お待ちください。

確認設定

AI サマリー

会話の要点を自動要約し、有人エージェントに文脈を提供します。

サマリー設定

引き継ぎルール

Human Handoff を開始する状況を記述します。各ルールには ルール名、平易な説明、削除せずに有効と無効を切り替えるための状態トグルがあります。

Quickchat AI には、最も一般的な引き継ぎ理由を網羅した次のデフォルトルールがあります。

Media Message: ユーザーが、AI では処理できない画像、ファイル、その他のメディアを送信した。
User Frustration: ユーザーが明確に怒り、苛立ち、不満を表している。
Customer Support Suggestion: AI Agent が次の手順としてカスタマーサポートへの連絡を案内したか、AI によるサポートを明確に終了した。
Lack Of Knowledge: AI Agent が必要な情報を持っていないことを認めた。
Irrelevant Advice: AI Agent が繰り返し対応を試みたが、ユーザーがまだ満足していない。

これらのルールはそれぞれ有効または無効にできます。また、AI に引き継ぎを開始する条件を伝える独自の ルール名 と説明を設定したルールも追加できます。

ルールに加えて、文脈を問わず Human Handoff を必ず実行する キーワード を指定できます。これは「訴訟」、「GDPR」、「チャージバック」など、AI に処理させたくないコンプライアンス関連の語句に役立ちます。

トピックルーティング

Human Handoff が実行されると、トピックルーティングは、共有キューに未割り当てのまま残すのではなく、そのトピックに最適な有人エージェントへ会話を送ります。

インサイト → トピックを管理で定義した各トピックを 1 人以上のチームメンバーに割り当てて、ルーティングを設定します。引き継ぎが開始されると、Quickchat は会話で検出されたトピックを読み取り、そのトピックに割り当てられたエージェントの 1 人へ会話を送ります。一致するルーティングルールがない場合、会話は未割り当てのままになり、チームメンバーが受信箱から担当できます。

メール通知

引き継ぎが必要な新規会話の通知先メールを設定します。

メール通知設定

スマートデータ収集 / リード獲得

会話の流れの中で、自然にユーザー情報（氏名、メール、電話など）を取得できます。収集したデータは CRM 等に送信可能です。

仕組み

AI が収集の好機を検知。
目的に沿った質問を実施（例：お名前／ご連絡先メールは？）。
回答を保存し、確認や外部連携に利用。

設定

有効化

Actions & MCPs を開く
Smart Data Gathering を選択
トグルをオン

有効化

収集項目

メールアドレス
名
電話番号

項目選択

収集タイミング

数往復の後
関心表明の直後

タイミング設定

尋ね方

控えめ：会話の中に自然に挿入
直接的：はっきり依頼

尋ね方設定

収集データのエクスポート

Inbox を開く
export アイコン
Export Gathered Data を選択
期間（開始/終了）を指定
形式（CSV, XLSX）を選択
Download

カスタムアクション

会話中に外部 API を呼び出せます。社内検索、チケット作成、通知、ナレッジ外の最新データ取得などに有効です。Actions & MCPs → Custom Actions にあります。

仕組み

アクションの種類を選びます: APIアクション、MCP、HubSpotアクション、Discordアクション、Google Sheets、Shopify MCP。接続と、AI に必要な指示を設定します。
会話中、AI はアクションの説明と、利用可能なツールまたはパラメータの詳細を使って、いつ実行するかを判断します。
Quickchat が呼び出しを実行し、結果を AI に返します。AI が応答を読み、自然な言葉でユーザーに返答します。
会話で使用する前に、アクションのエディターでテストまたは接続を行います。

API アクションの作成

Actions & MCPs を開く。
Custom Actions の + → API Action。
Details：
- Name：明快で説明的に
- Description：使用条件とパラメータ記入の指針
Connection：
- Action Type：GET / POST
- Action endpoint URL：完全な URL
- Headers：Authorization や content-type: application/json など必要最小限
Parameters：name / location（query, body, header）/ description を定義。path はパラメータの location ではなく、{{placeholder}} テンプレートでエンドポイント URL に直接埋め込みます。
Test request → 応答確認 → Done

リクエスト本体以外にも、API Action には知っておくと役立つ任意の設定が 3 つあります: Save to memory、Run only when、Response filter。

Discordアクション

Discordアクションでは、入力済みで編集可能な API Action のギャラリーを利用できます。

サポートとチケット: サポートチケットを開くでは、サーバーとテキストチャンネルを選択します。メンション可能なサポートロールは任意で選択できます。プライベートスレッドを開き、現在の依頼者を追加し、必要に応じてロールをメンションする要約を投稿する 3 つの Action が作成されます。
モデレーション: メンバーをタイムアウト、メンバーをキック、メンバーをBAN、メンバーのBANを解除、ロールを割り当て、スローモードを設定、アナウンスを送信。各テンプレートは 1 クリックでインストールされ、現在の Discord リクエストに含まれるサーバー、メンバー、ロール、チャンネルを使用します。

Quickchat は HTTP メソッド、URL、ヘッダー、body、パラメータ、説明、レスポンス設定、実行条件を backend で作成します。作成されたカードは通常の HTTP Request Action です。すべてのフィールドを確認して編集できます。

7 つのモデレーションテンプレートにはすべて、次の場合のみ実行に author_is_admin is true が含まれます。Discord が現在の送信者の Administrator 権限を計算し、Discord gateway がその値を渡し、Quickchat がリクエスト送信前に確認します。公開チャットと API メタデータからこのキーを設定することはできません。Discord 上で管理者アカウントと管理者ではないアカウントの両方を使ってモデレーション Action をテストしてください。AI Preview では認可済みの Discord 送信者を利用できません。

Bot 自体には、各リクエストに必要な Discord 権限が引き続き必要です。

アクション	Bot の権限またはアクセス
メンバーをタイムアウト	Moderate Members
メンバーをキック	Kick Members
メンバーをBAN、メンバーのBANを解除	Ban Members
ロールを割り当て	Manage Roles
スローモードを設定	Manage Channels
アナウンスを送信	View Channels と Send Messages

Discord はロール階層も適用します。Bot のロールを、管理対象のメンバーやロールより上位に配置してください。テンプレートでは、リクエストした管理者のロール階層や個別の権限を追加で確認しません。

スローモードを設定とアナウンスを送信は、チャンネル ID パラメータを受け取ります。追加の固定対象がない場合、テンプレートはそのチャンネルが管理者のリクエスト元サーバーに属することを検証しません。同じ Bot が複数のサーバーに参加している場合は、これらの Action を固定チャンネル ID を使うよう編集するか、サーバーごとに Agent と Bot の認証情報を分け、別々の信頼境界にしてください。

Support Ticket のインストールでは、既存の Action 機能を使用してデータを渡します。

open_support_ticket は選択したチャンネルにプライベートスレッドを作成し、$.id を取得して discord_ticket_thread_id として会話メモリに保存します。discord_message is true が必須で、選択したサーバーで、そのメモリキーが存在しない場合にのみ実行されます。
add_ticket_requester は {{metadata_discord_ticket_thread_id}} と、Discord が提供する {{metadata_discord_author_id}} を読み取ります。discord_message is true が必須で、スレッド ID が存在する場合に、選択したサーバーでのみ実行されます。
post_in_ticket は同じ保存済みスレッド ID を読み取り、Agent が作成した問題の 1 行要約を投稿して、依頼者をメンションします。サポートロールを選択した場合は、そのロールもメンションします。Discord メッセージ、サーバー、保存済みスレッドについて同じ条件が設定されています。Discord のリクエスト body にある allowed_mentions は、依頼者と、設定されている場合はそのロールに限定されます。

説明と Agent のメインプロンプトで、これらの Action をこの順序で実行するよう指示してください。専用のワークフロー状態、ロック、確認、再試行、復旧、照合、replay protection のレイヤーはありません。結果が不明な場合、Discord がすでにリクエストを完了している可能性があるため、再試行する前に Discord と Action ログを確認してください。

discord_ticket_thread_id は自動的に消去されません。そのため、このテンプレートで作成できるチケットは Quickchat の会話ごとに 1 件です。別のチケットには新しい Discord の会話またはスレッドを開始するか、必要なメモリのライフサイクルを追加するよう Action を編集してください。

Support Ticket では、選択したチケットチャンネルで Bot に View Channels、Send Messages、Read Message History、Create Private Threads、Send Messages in Threads、Manage Threads を付与してください。ロールをメンションしない場合は、ロールに通知（任意）をロールに通知しないに設定してください。ロールを選択した場合は、そのロールをメンション可能にし、そのメンバーがプライベートスレッドにアクセスできるようにします。ロールを選択しない場合やメンション可能なロールがない場合も、ロールへの通知なしでチケットは通常どおり開かれます。ギャラリーにはテキストチャンネルとメンション可能なロールが表示されますが、チャンネルの権限上書きをすべて検証するわけではありません。

ギャラリーは設定を省力化するもので、追加のポリシーレイヤーではありません。生成された Action を編集する場合やカスタム Discord API Action を作成する場合は、有効化する前に認証情報、対象、パラメータ、レスポンスの公開範囲、次の場合のみ実行の条件を確認してください。

Save to memory

API レスポンスから値を取り出し、任意のキーを付けて会話のメモリに保存します。以降の Action はそれを {{metadata_<key>}} として再利用でき、会話の詳細（Inbox、API、エクスポート）にも表示されます。

ある Action が生成した値を、後続の Action が必要とする場合に使います。検索系の Action がレスポンスから customer_id を保存しておけば、後続の Action は AI に値をコピーさせることなく {{metadata_customer_id}} を送信できます。

API Action エディタの Save to memory セクションで、取り出した値に メモリキー を付け、保存したいレスポンスの該当箇所を指定します。以降は、他と同じメタデータ変数として扱えます。

API Action エディタの Save to memory セクション

Run only when

Action を、会話メタデータの条件が満たされたときにのみ 実行されるよう制限します。条件は、AI が Action の呼び出しを決定した後、リクエストが送信される前に、こちら側で、呼び出し時に チェックされるため、チャットからは回避できません。

これは、権限を要する操作や取り消せない操作（メンバーの BAN、返金、レコードの削除）に適したツールです。プロンプト内の「これは管理者のみ実行可能」という一文は有用な指示ではありますが、セキュリティ境界ではありません。執拗なユーザーはモデルを言いくるめたり、プロンプトインジェクションを試みたりできます。実行条件は決定論的でプロンプトの外側に存在するため、会話で何が言われようとも保持されます。

実行条件が境界です。 サーバー側で評価され、モデルが読むプロンプトには含まれません。これが実際に Action の実行を止めるものです。
プロンプトのルールはユーザー体験のためです。 AI が無言になるのではなく丁寧に断り、理由を説明できるよう、プロンプトにも一文を残しておきましょう。

Action エディタの Run only when セクションで条件を追加します。Add condition をクリックし、メタデータキー（例: telegram_sender_is_admin）を選び、比較方法を選択します:

条件	次の場合に通過します。メタデータの値が…
is true	truthy である
is false	falsy である
exists	会話に存在する
does not exist	存在しない
equals	指定した値と一致する
does not equal	指定した値と異なる

Action は すべて の条件が満たされたときにのみ実行されます。会話に設定されていないキーに対する条件は通過しません。

telegram_sender_is_admin が true という条件が 1 つ設定された Run only when セクション

条件が満たされない場合、リクエストは送信されず、AI はユーザーにそれができない旨を伝えます。以下では、同じ BAN リクエストが、非管理者に対してはブロックされ、管理者に対しては許可されています。変わっているのは誰が依頼しているかだけです:

非管理者の BAN 試行が実行条件によってブロックされる様子: リクエストは送信されず、結果は拒否となる

管理者による同じ BAN リクエスト: 実行条件が通過し、Action は 200 を返す

Response filter

デフォルトでは、AI は API レスポンス全体 を見ます。Response filter セクションに JSONPath 式を追加すると、AI が見る範囲をその特定の部分だけに限定できます。

フィルターをかける一般的な理由は 2 つあります:

機密フィールドを隠す。 エンドポイントが AI に必要な以上の情報を返す場合に、顧客のメールアドレス、支払い情報、内部 ID をモデルのコンテキストから除外します。
プロンプトを小さくする。 冗長な API は大きなペイロードを返すことがあります。重要な数フィールドにフィルターすることで、レスポンスを小さく保ち、AI の焦点を絞ります。

1 つ以上の JSONPath 式を追加すると、AI は一致した部分のみを受け取ります。例えば $.data.items[*].name は、より大きなレスポンスから項目名だけを残します。

API Action エディタの Response filter セクション

ベストプラクティス

説明は具体的に：使用条件と各パラメータの意味を明確に。
スコープ最小化：必要なヘッダー・トークンのみ。
展開前にテスト：ステータスコードとペイロードを確認。

チュートリアル

MCP アクション

MCP（Model Context Protocol）は、AI が他のサービスのツールを直接利用できるようにするオープン標準です。エンドポイントやパラメータを手作業で記述する代わりに、MCP サーバー自身が提供するツールを公開し、AI エージェントがそれを検出して使用します。

ほとんどのサービスはワンクリックで接続できます。アクションとMCP（Actions & MCPs）を開き、+ アクションを追加 をクリックして MCP を選択します。

カタログから接続する

MCP 画面は、よく知られたサービスを検索できるカタログから始まります。サービスはカテゴリー（人気、カスタマーサポート、CRM・営業、スケジュール、Eコマース、決済・請求、マーケティング・メール、コミュニケーション、生産性、データ・分析、検索・ウェブ、旅行・予約、デザイン、開発・インフラ）ごとにまとめられています。

一覧をたどるか検索ボックスを使って、目的のサービスを見つけます。
タイルをクリックします。Quickchat がサーバーを確認し、提供されているツールを検出します。
サインインが必要なサービスの場合は、認証が必要です のパネルが表示されます。<サービス名> と接続 をクリックし、開いたポップアップでアクセスを承認すると、パネルが接続済みの表示に切り替わります。
アクションが作成されて有効になり、ツールが一覧表示されます。次のメッセージから AI エージェントが利用できます。

カタログにないサーバーを接続する

カタログの下にある URLを手動で入力 をクリックし、次の手順を実行します。

MCPサーバーURL を貼り付けます（https:// で始まる必要があります）。
サインインフローではなく固定トークンで認証するサーバーの場合は、接続ヘッダー（任意） を開き、サーバーが要求するヘッダー（例：Authorization: Bearer <your-token>）を追加します。
接続をクリックします。

タイル表示に戻るには カタログを見る を使います。必要なサービスが見つからない場合は、統合が見つかりませんか？提案する から、内容が入力済みのメールをチームに送信できます。

AI が使えるツールを選ぶ

接続すると、サーバーが公開するすべてのツールがトグル付きで一覧表示されます。AI に呼び出させたくないものはオフにしてください。たとえば予約サーバーであれば、参照系のツールはオンのままにして、キャンセル用のツールだけをオフにしておけます。

デフォルトのツールの有効化 は、後からサーバーに新しいツールが追加されたときの挙動を決めます。オンなら新しいツールはすぐに利用可能になり、オフなら 1 つずつ自分で有効化します。

訪問者に表示される内容

ツールの実行中、チャットウィジェットにはツール名から生成された短いステータス行が表示され、AI が何をしているかを伝えます。たとえば search_flights というツールなら「フライトを検索しています…」と表示されます。単なる入力中インジケーターの代わりに、待ち時間の意味が訪問者に伝わります。この表示は自動生成されるため、設定は不要です。

再接続と接続の解除

再接続：認証をやり直します。接続の有効期限が切れた場合、別のアカウントで認証したい場合、サーバーのツール一覧が変わって新しいツールを取り込みたい場合に使います。
接続を解除：保存された認証情報を失効させ、アクションをオフラインにします。アクション自体は一覧に残るため、設定をやり直さずに後から再接続できます。

接続済みのアクションで MCPサーバーURL を変更すると、認証情報がクリアされてアクションはオフになります。あるサーバーが発行した認証情報を別のサーバーに使い回すことはないためです。再度認証すればオンラインに戻ります。

トラブルシューティング

表示される内容	意味
認証に失敗しました	サインインが完了しませんでした。再接続を試してください。ポップアップを途中で閉じた場合は、何も保存されていません。
接続しましたが、ツールの読み込みに失敗しました	認証は成功しましたが、ツール一覧を読み込めませんでした。再接続をクリックしてください。
このサーバーでツールが見つかりませんでした。再接続してみてください。	認証は通りましたが、サーバーがツールを公開していません。承認したアカウントに、想定しているデータへのアクセス権があるか確認してください。
https:// で始まる有効な URL を入力してください	URL を読み取れませんでした。サーバーの完全な `https://` アドレスを使用してください。Quickchat は常に `https` で接続するため、認証情報が暗号化されずに送信されることはありません。
アクションが自動的にオフになった	認証の有効期限が切れたか、プロバイダー側で失効しています。アクションを開いて再接続をクリックしてください。

最終更新日: 2026/08/06