> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# キャンペーン

> **Info**
>
> アウトバウンド発信に関する規制は国、州、業界によって異なるため、適切な発信時間や試行回数の上限は、発信先や目的によって変わります。同意の取得、エージェントの発言内容、その後の対応など、アウトバウンド発信に関する法令遵守と、連絡先の居住地域の規則に沿った上限の設定は、ユーザーの責任となります。詳しくは、[ElevenAgentsの利用規約](https://elevenlabs.io/agents-terms)と[TCPAガイダンス](/docs/ja/eleven-agents/legal/tcpa)をご覧ください。

## 概要

キャンペーンでは、エージェントによるアウトバウンド通信を実行できます。受信者のリストを送信すると、各受信者が指定した最終結果に到達するまで、再試行、コールバック、転送、発信可能時間帯の設定に従ってキャンペーンが連絡します。キャンペーンは一括発信に代わる機能です。

### キャンペーンの用途

完了までに複数回の通話が必要なアウトリーチには、キャンペーンを使用します。

* **会話に基づくフォローアップ。** 受信者が午後4時のコールバックを希望した場合や、同僚の番号への発信を依頼した場合、キャンペーンが通話分析を読み取り、適切な次回通話をスケジュールします。
* **発信可能時間帯。** 通話は、指定したタイムゾーンで評価され、定義した時間帯にのみ発信されます。ただし、受信者が指定した時刻へのコールバックは例外で、その時刻に発信されます。
* **上限付きの継続発信。** 失敗した通話や応答がなかった通話は、設定した上限に達するまで、スケジュールに従って再試行されます。
* **オペレーターによる可視化。** すべての受信者と通話、それぞれの判断理由を確認でき、いつでも一時停止またはキャンセルできます。

## キャンペーンポリシー

キャンペーンポリシーでは、発信を継続する度合いと発信可能な時間を定義します。ワークスペースにデフォルトのポリシーを設定すると、各キャンペーンは作成時にそのスナップショットを取得します。後からワークスペースのポリシーを変更しても、その後に作成されるキャンペーンにのみ適用されます。

```json
{
  "policy": {
    "timezone": "America/New_York",
    "retry": {
      "retry_delay_seconds": 600,
      "max_short_retries": 1,
      "max_total_calls": 6,
      "max_callbacks": 2,
      "max_redirects": 2,
      "interval_placement": "start"
    },
    "calling_periods": [
      {
        "weekdays": [0, 1, 2, 3, 4],
        "intervals": [
          { "start": "10:00", "end": "12:00" },
          { "start": "16:00", "end": "18:00" }
        ]
      }
    ],
    "data_collection": {
      "callback_time": "__system_data_collection_callback_time",
      "redirect_phone_number": "__system_data_collection_redirect_phone_number",
      "stop": "__system_data_collection_do_not_call"
    }
  }
}
```

### 再試行の上限

| フィールド                                 | 説明                                                                                  |
| ------------------------------------- | ----------------------------------------------------------------------------------- |
| `retry_delay_seconds`                 | 失敗、応答なし、またはボイスメールとなった通話を短時間後に再試行するまでの待機時間。                                          |
| `max_total_calls`                     | 初回通話を含む、受信者ごとの試行回数の上限。この回数を超えて受信者に発信することはありません。デフォルトは6回、最大30回です。                    |
| `max_short_retries`                   | 次の発信可能時間帯へ移るまでに、各発信可能時間帯で許可される短時間後の再試行回数。                                           |
| `max_callbacks`, `max_redirects`      | 受信者がリクエストできるコールバックと転送の上限。通話が転送されると、番号ごとに再試行とコールバックの割り当てがリセットされます。                   |
| `max_consecutive_failures_per_number` | 任意。1つの番号で連続して失敗できる回数。この回数に達すると、登録されている次の番号（受信者1人につき最大5件）へ移るか、次の番号がない場合は終了します。       |
| `interval_placement`                  | 通話が将来の時間帯に移された場合の発信タイミング。時間帯の開始時、時間帯内のランダムな時刻、またはすでに失敗した時刻を避けるようローテーションする方法から選択します。 |

### 発信可能時間帯

`calling_periods` では、発信できる週単位の時間帯を定義します。曜日には0～6の番号が割り当てられ、月曜日が0です。時刻はポリシーの `timezone` における現地時間の `HH:MM` で指定します。同じ曜日の時間帯を重複させることはできません。

指定時刻のコールバックのみ例外です。受信者が特定の時刻へのコールバックを希望した場合、設定した時間帯の範囲外でも、その時刻に発信されます。この点を考慮してmax_callbacksを設定してください。

ポリシーに設定できる `timezone` は1つです。連絡先が複数のタイムゾーンにまたがる場合は、各地域に個別のキャンペーンを作成し、それぞれに `timezone` と発信可能時間帯を設定してください。これにより、すべての通話が受信者の居住地域で許可された時間内に発信されます。

### 動的変数のマッピング

キャンペーンでは、デフォルトのデータ収集項目をワンクリックでエージェントに追加し、コールバック、転送、発信停止を有効にできます。

追加の分析結果をフォローアップ通話用の[動的変数](/docs/ja/eleven-agents/customization/personalization/dynamic-variables)にマッピングすることもできます。これにより、前回の通話で得た情報を引き継いで再試行やコールバックを開始できます。

### フォローアップのコンテキスト

コールバック時に会話を自然に継続できるよう、エージェントのプロンプトで以下の変数を参照してください。

| 変数                                   | 内容                             |
| ------------------------------------ | ------------------------------ |
| `campaign__call_type`                | 通話が初回連絡、再試行、コールバック、転送のいずれであるか。 |
| `campaign__previous_conversation_id` | 受信者との前回の会話ID。                  |
| `campaign__previous_summary`         | 前回の会話の要約。                      |
| `campaign__previous_transcript`      | 前回の会話の文字起こし。                   |

## チャネル

| チャネル     | モード  | 備考                                                                                                                   |
| -------- | ---- | -------------------------------------------------------------------------------------------------------------------- |
| 電話       | 音声   | 再試行、コールバック、転送のすべての動作に対応します。                                                                                          |
| WhatsApp | 音声   | 受信者ごとに1回、許可リクエストを送信し、その後に再試行とコールバックを実行します。[WhatsAppのアウトバウンド](/docs/ja/eleven-agents/whatsapp/outbound)をご覧ください。       |
| WhatsApp | テキスト | 承認済みのWhatsAppメッセージテンプレートを各受信者に送信します。再試行は適用されません。[WhatsAppのアウトバウンド](/docs/ja/eleven-agents/whatsapp/outbound)をご覧ください。 |

メールとSMSチャネルは近日公開予定です。

## キャンペーンを作成する

#### キャンペーンを開く

ElevenAgentsのナビゲーションで、**キャンペーン** を選択します。

#### ワークスペースのポリシーを保存する

**設定** を開き、タイムゾーン、再試行の上限、発信可能時間帯を定義して保存します。[キャンペーンポリシー](#campaign-policy)をご覧ください。

#### キャンペーンを作成する

**新規キャンペーン** を選択し、エージェント、チャネル、電話番号を選んで、受信者をアップロードします。CSVをアップロードするか、一括発信と同じリクエスト形式でAPIから受信者を送信します。受信者ごとに最大5件の電話番号（CSVでは `phone_number` ～ `phone_number_5`）を登録できます。

#### 高度な機能を有効にする

**詳細設定** をオンにすると、指定した発信可能時間帯での再試行、コールバック、フォローアップが有効になります。これらの設定はワークスペースの設定から自動的に反映されますが、キャンペーンごとにここで調整することもできます。

#### 進捗を確認する

**分析** タブで進捗を確認します。

キャンペーンを作成すると通話がキューに追加され、発信可能時間帯に入ると発信されます。

> **Warning**
>
> [ゼロリテンションモード](/docs/ja/eleven-agents/customization/privacy/zrm)を使用しているワークスペースやエージェントでは、キャンペーンを利用できません。フォローアップの判断には、保持される通話状態と会話分析が必要です。そのため、ゼロリテンションのワークスペースからのリクエストと、ゼロリテンションのエージェントに対する送信は拒否されます。

## 同時実行数

キャンペーン通話は、ワークスペースとエージェントの同時実行数の上限にカウントされます。デフォルトでは、ワークスペースの同時実行数の50％とエージェントの同時実行数の70％のうち、低い方がキャンペーンに適用されます。キャンペーンごとに、さらに低い上限を設定できます。

## API

キャンペーンの作成、管理、分析はElevenLabs APIから利用でき、既存のワークフローやアプリケーションにキャンペーンを組み込めます。利用可能なエンドポイントについては、[APIリファレンス](/docs/ja/api-reference/introduction)をご覧ください。

## ベストプラクティス

* **対象を絞って始める。** すべての対象者に実施する前に、短いリストと控えめな `max_total_calls` でテストしてください。
* **時間帯を慎重に設定する。** 発信可能時間帯は、現地の発信可能時間を守るための主要な設定です。`timezone` を受信者の所在地に合わせ、許可された時間の十分内側に発信可能時間帯を設定してください。
* **フォローアップのシグナルを収集する。** キャンペーンでコールバック、転送、発信拒否のリクエストを処理するには、エージェントがそれらを取得する必要があります。各項目を記録するタイミングをエージェントのプロンプトで指定してください。
* **フォローアップのコンテキストを使用する。** プロンプトで `campaign__previous_summary` を参照し、再試行やコールバックで冒頭を繰り返さず、前回の通話の続きから始められるようにします。
* **上限を低く保つ。** 発信を続けることは、ユーザーだけでなく受信者にも負担になります。何度も発信するより、適切なタイミングで数回発信する方法を選んでください。

## よくある質問

#### 実行中のキャンペーンのポリシーを変更できますか？

いいえ。キャンペーンのポリシーは作成時に確定します。ワークスペースのポリシー変更は、その後に作成するキャンペーンに適用されます。実行中のキャンペーンを変更するには、そのキャンペーンを停止して新しく作成してください。

#### 1人の受信者を複数のキャンペーンに追加できますか？

各キャンペーンは独自にリードを追跡し、発信拒否の状態もキャンペーンごとに管理されます。同じ相手に重複して連絡しないようにする必要がある場合は、キャンペーンを作成する前に、キャンペーン間で受信者の重複を除外してください。

## 次のステップ

* [データ収集](/docs/ja/eleven-agents/customization/agent-analysis/data-collection)：エージェントが判断に使用するシグナルを取得します。
* [動的変数](/docs/ja/eleven-agents/customization/personalization/dynamic-variables)：受信者ごとに通話をパーソナライズします。
* [ガードレール](/docs/ja/eleven-agents/best-practices/guardrails)：アウトバウンドエージェントが話題やブランド方針から外れないようにします。