アクション

最終更新日: 2025/10/03

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

人への引き継ぎ（Human Handoff）

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

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

ユーザー側の流れ：

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

訪問者側の引き継ぎ

Quickchat 画面側の流れ：

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

アプリ側の引き継ぎ

Human Handoff を有効化

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

有効化

設定できる項目：

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

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

稼働時間設定

事前の質問

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

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

質問設定

確認メッセージ

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

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

確認設定

AI サマリー

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

サマリー設定

（任意）トリガーキーワード

常に引き継ぎを発動させるキーワードを指定できます。

例：請求書、領収書、配達状況など。

キーワード設定

メール通知

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

メール通知設定

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

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

仕組み

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

設定

有効化

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

有効化

収集項目

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

項目選択

収集タイミング

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

タイミング設定

尋ね方

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

尋ね方設定

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

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

カスタムアクション

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

仕組み

API アクション（名前、説明、HTTP メソッド、エンドポイント URL、ヘッダー、パラメータ）を定義。
会話中、説明とパラメータのヒントに基づき AI が実行判断。
Quickchat が HTTP リクエストを送り、JSON を 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, path）/ description を定義
Test request → 応答確認 → Done

ベストプラクティス

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