タスク（Task）

概要

タスク（Task） は、Agent のプロアクティブメッセージ機能です。ユーザーが先に話しかけるのを待つのではなく、Agent 側からユーザーへ会話を開始します。

通常の会話が「ユーザーが質問 → Agent が回答」であるのに対し、タスクは「プラットフォームが設定した条件に従い、ユーザーの代わりに Agent へメッセージを送信 → Agent が返信を生成 → 返信をユーザーへプッシュ」という流れになります。タスクで設定する「トリガーメッセージ」は、本質的にはユーザーの代わりに Agent へ送る一言であり、Agent は実際のユーザーメッセージを受け取ったときと同様に返信を生成します。エンドユーザーに表示されるのは Agent の返信であり、トリガーメッセージそのものではありません。

代表的な利用シーン：

前提条件

• タスクは、すでに Agent と会話したことがあるユーザーにのみ送信されます。プラットフォームは各ユーザーについて、対象チャネル上で「最後にアクティブだった」会話を特定し、その会話にメッセージを挿入します。会話履歴のないユーザーにはタスクメッセージは送信されません（実行明細では NO_CONVERSATION として記録されます）。
• 対象チャネルがサードパーティ連携（WhatsApp、Telegram、LINE など）の場合は、該当する連携が「Integrations」で正しく設定され、有効になっていることを確認してください。連携が無効化されていたり、認証情報が失効していたりすると送信に失敗します（CHANNEL_CONFIG_INVALID / CHANNEL_AUTH_FAILED）。
• タスクの実行では Agent の LLM を呼び出して返信を生成するため、通常どおりクレジット（Credits）が消費されます。

アクセス方法

開発スペース → エージェント → 任意の Agent を選択 → 左側メニュー「Tasks」 に移動します。

タスク一覧では、タスク名による検索、およびステータス（Status）、トリガータイプ（Trigger）、対象ユーザー（Target）による絞り込みが可能です。一覧の項目は以下のとおりです：

タスクの作成

右上の New task をクリックし、右側のドロワーで設定を行います。

1. 基本情報

注意：All users を選択すると確認ダイアログが表示されます。これは、その Agent のすべてのチャネル上の全ユーザーに一斉配信することを意味するためです。誤送信を防ぐため、対象会話の範囲が適切に設定されていることを必ず確認してください。

対応している対象チャネル

ヒント：一部のチャネル（Discord、DingTalk、SoBot など）は、プラットフォームのプロトコル上の制約により、現時点ではサーバー側からのプロアクティブ送信に対応していません。これらはチャネルのドロップダウンでグレーアウトされ、理由が表示されます。自社チャネル（Web / Widget など）の返信は会話に直接書き込まれ、ユーザーが次回会話ウィンドウを開いたときに表示されます。IM チャネルおよびカスタマーサポートプラットフォームでは、各プラットフォームの API を通じてユーザーへ能動的にプッシュされます。

2. トリガー方式（Trigger）

トリガー方式は「いつ送信するか」を決定します。以下の 3 種類があります：

能動 - スケジュールトリガー（Active - Scheduled）

プラットフォームが設定されたスケジュールに従って能動的に送信を開始します。定期配信や単発通知に適しています。

時刻はタスクで選択したタイムゾーンに基づいて計算されます。スケジュールタスクは作成後 WAITING ステータスとなり、初回の実行時刻に達すると RUNNING に移行します。Once タスクは実行完了後、自動的に COMPLETED に移行します。

能動 - イベントトリガー（Active - Event）

お客様の業務システムから Webhook でプラットフォームを呼び出してトリガーします。注文、決済、チケットなどの業務イベントとの連携に適しています。

タスク作成時に認証方式を選択して認証情報を入力すると、プラットフォームが一意の Webhook URL を自動生成します（作成後、タスク詳細で確認できます）：

Webhook 呼び出し例

Webhook URL は {プラットフォームのドメイン}/bot/proactive-task/webhook/{webhookPath} の形式です。タスク詳細に表示される完全なアドレスをご利用ください。

                      
                      POST {Webhook URL}
Content-Type: application/json
Authorization: Basic base64(username:password)

{
  "idempotency_key": "order-20260903-0001",
  "target": {
    "channel": "TELEGRAM",
    "user_id": "customer_123"
  },
  "variables": {
    "order_no": "SO-20260903-0001",
    "eta": "9月5日"
  }
}

                    

注意：Webhook リクエストの成功は「受信して送信キューに入った」ことを意味するだけです。実際の送信結果は実行履歴でご確認ください。認証失敗、タスクの停止済み、対象チャネルがタスクの対象チャネル範囲外である場合などは、いずれも権限エラーが返されます。Webhook アドレス 1 件あたりのレート制限は 120 回 / 分です。

受動 - ユーザートリガー（Passive - User Triggered）

プラットフォームが 1 分ごとにすべての対象ユーザーをスキャンし、ルールに合致したユーザーに対して送信をトリガーします。休眠ユーザーの呼び戻しや、優良ユーザーへのフォローなどのシーンに適しています。

ルール設定

Add rule をクリックしてルールを追加します。複数のルール間は AND（すべてを満たす）または OR（いずれかを満たす）を選択できます。

説明：ユーザー属性は「変数管理 → ユーザー属性」から取得され、ユーザーごとに個別の値を持ちます（ユーザーが未設定の場合は属性のデフォルト値が使用されます）。ユーザープロファイルによる絞り込みに適しています。カスタム属性は「変数管理 → カスタム変数」から取得され、Agent 単位で統一された値であり、すべてのユーザーで同じです。「マスタースイッチ」のような条件に適しています。すべてのルールフィールドは、そのユーザーが対象チャネル上で最後にアクティブだった会話に基づいて値を取得します。

メッセージ頻度制御（Message Frequency）

受動トリガータスクでは頻度制御の設定が必須です。設定したウィンドウ内（N 時間 / N 日）において、同一ユーザーがこのタスクによってトリガーされるのは最大 1 回のみとなり、ルールに継続的に合致するユーザーに繰り返し通知が届くことを防ぎます。

ヒント：ユーザーの最終会話日時（User's last chat time）は「過去」の時刻であるため、「N 単位 経過」系の演算子を使用してください。「今から N 単位 後」系の演算子は未来の日時フィールド（サブスクリプションの有効期限など）にのみ適用されるもので、最終会話日時に使用しても決して合致しません。

3. トリガーメッセージ（Message）

「ユーザーの代わりに」Agent へ送信するメッセージ内容を入力します。Agent はこのメッセージと、自身のプロンプトやナレッジベースなどに基づいて返信を生成し、ユーザーへプッシュします。

{{変数}} の形式で以下の変数を参照できます：

例

• 定期配信：簡潔で親しみやすい口調で、今日の業界の主要ニュースをまとめてください。
• 休眠ユーザーの呼び戻し：数日間ご無沙汰していました。声をかけて、最近追加された新機能を教えてください。
• イベント通知：私の注文 {{event.variables.order_no}} が出荷され、{{event.variables.eta}} にお届け予定です。配送情報を教えて、受け取りを忘れないよう案内してください。

ヒント：トリガーメッセージは Agent に向けて書く「ユーザー視点」の質問であり、ユーザーにそのまま表示される文言ではありません。Agent にできるだけそのまま伝えてほしい場合は、メッセージ内で明示的に指示してください。例：「次の内容をそのままユーザーに伝えてください：……」。

内容を確認したら Create をクリックします。

注意：1 つの Agent で同時に WAITING / RUNNING ステータスにできるタスクは最大 10 件です。上限を超える場合は、既存のタスクを停止するか、完了するまでお待ちください。

タスクのステータス

タスクと実行履歴の確認

一覧の View をクリックしてタスク詳細に移動します。タスク詳細には 2 つのタブがあります：

• Configuration：タスク設定の読み取り専用ビュー。イベントトリガータスクの場合は、ここで Webhook URL と認証情報を確認できます。
• Execution History：各実行の記録。実行日時、対象数、成功 / 失敗数、成功率が含まれます。

いずれかの実行をクリックすると、実行明細を確認できます。チャネルごとの成功 / 失敗の統計と、送信記録が 1 件ずつ表示されます。失敗理由の説明：

停止と削除

• Stop：WAITING / RUNNING / ERROR ステータスのタスクはいつでも停止できます。停止後は TERMINATED に移行し、復元はできません。
• Delete：COMPLETED / TERMINATED ステータスのタスクのみ削除できます。削除時には実行履歴と実行明細も併せて削除されます。

よくある質問

Q：タスクは正常に実行されたのに、ユーザーに表示される内容が設定したトリガーメッセージと異なるのはなぜですか？
トリガーメッセージは「ユーザーの代わりに Agent へ送る質問」であり、ユーザーに表示されるのは、その質問に対して Agent が生成した返信です。文言を正確に制御したい場合は、トリガーメッセージ内で Agent にそのまま出力するよう明示的に指示してください。

Q：新規ユーザーにもタスクメッセージは届きますか？
届きません。タスクは会話履歴のあるユーザーにのみ送信され、かつ会話の作成日時が「対象会話の範囲」内である必要があります。

Q：スケジュールタスクが指定時刻ちょうどに送信されないのはなぜですか？
スケジューラーは 1 分ごとにスキャンを行い、また大量送信はプロジェクト単位のレート制限に従って分割してプッシュされるため、実際の到着時刻は多少遅れる場合があります。

Q：Webhook が権限エラー（Permission deny）を返します。
以下を順に確認してください：Webhook URL が正しいか、認証情報が一致しているか、タスクが停止されていないか、リクエスト内の target.channel がタスクに設定された対象チャネルに含まれているか。