> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# アウトバウンドキャンペーン

> 連絡先リストをアップロードし、発信時間帯、再試行、進行状況のリアルタイム表示を活用してエージェントに対応させます。

キャンペーンでは連絡先リストに対して自動で発信します。音声エージェントを選択し、
CSV をアップロードして、発信可能な時間帯を設定すると、ThunderPhone がリストを処理します
— 応答なしや留守番電話には、選択したスケジュールで再試行します。
**エンゲージメント → キャンペーン**（`/dashboard/campaigns`）から確認できます。

単発のプログラムによる発信には、
[アウトバウンド通話 API](/ja/guides/place-outbound-calls)を使用してください。

## 前提条件

* デプロイ済みの音声エージェント。
* 発信元として組織に接続された **VoIP 電話番号** — デモ番号は着信専用のため、キャンペーン通話には使用できません。[VoIP プロバイダーを接続する](/ja/guides/voip-providers)を参照してください。
* `phone` または `phone_number` 列を含む CSV ファイル（または貼り付けた JSON）の連絡先。**1 回のアップロードにつき最大 5,000 行**、UTF-8 エンコード。追加の列はすべて、キャンペーンの連絡先レコードに連絡先ごとの変数として保持されます。

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

<Steps>
  <Step title="新しいキャンペーンをクリック">
    名前を付け、**音声エージェント**を選択し、**発信元番号**（VoIP 番号のいずれか）を選択します。
  </Step>

  <Step title="連絡先 CSV をアップロード">
    無効な電話番号を含む行は個別に拒否され、行番号とともに報告されます。その他の行は問題なくインポートされます。
  </Step>

  <Step title="発信時間帯を設定">
    **タイムゾーン**と 1 日の**開始/終了**時間帯を選択します。キャンペーンはその時間帯にのみ発信します。時間帯は日付をまたぐことができます（例: 22:00 → 02:00）。
    必要に応じて、開始をスケジュールする **開始日時**と、キャンペーンを自動完了させる **終了日時**を設定します。
  </Step>

  <Step title="ペーシングと再試行を調整">
    * **同時通話数** — このキャンペーンで同時に実行する通話数（1～10、デフォルトは 3）。組織全体でもすべての処理を通じて **同時アウトバウンド通話数 10** に制限されるため、並行するキャンペーンでこの上限を共有します。
    * **最大試行回数** — 各連絡先に発信できる回数（デフォルトは 2）。
    * **再試行までの待機時間（分）** — 再試行までの待機時間（デフォルトは 60）。
    * **再試行対象** — 再試行をトリガーする結果: **応答なし**、**留守番電話**、**失敗**（すべてデフォルトで有効）。
  </Step>

  <Step title="下書きを作成して開始">
    キャンペーンは下書きとして作成されます。連絡先を追加できるのは、キャンペーンが下書きの間のみです。キャンペーンを開始するには、通話料金への明示的な同意が必要です。将来の **開始日時** を設定すると *scheduled* になり、それ以外の場合は直ちに *running* として開始されます。
  </Step>
</Steps>

## 結果と再試行の仕組み

各通話後、連絡先には結果が設定されます。成功した通話は完了としてマークされます。応答なしと判定された通話、留守番電話として検出された通話、または失敗した通話は、その結果が **再試行対象** リストに含まれ、かつ連絡先に試行回数が残っている場合に再試行されます。試行回数を使い切った連絡先は *exhausted* としてマークされます。再試行不可の失敗は *failed* としてマークされます。

<Note>
  アカウント残高の状態に問題がある間は、発信が自動的に一時停止され、問題が解消されると再開します。長期間のキャンペーンでは、
  [自動チャージ](/ja/guides/billing-and-topups)を有効にしておいてください。
</Note>

## 監視と制御

各キャンペーンカードには、ステータスと進捗（例: 「248 件中 173 件完了」）が表示されます。キャンペーンを開くと、ステータスの内訳、連絡先ごとの結果、最近の通話を確認できます。各項目は、通話履歴内の完全な文字起こしと録音にリンクしています。

* **一時停止 / 再開** — 一時停止すると新しい発信は停止しますが、すでに進行中の通話は自然に終了します。一時停止中のキャンペーンは編集および再開できます。
* **キャンセル** — キャンペーンを完全に停止します。
* すべての連絡先が最終状態に達するか、**終了日時**を過ぎると、キャンペーンは自動的に完了します。

キャンペーンステータス: `draft`, `scheduled`, `running`, `paused`,
`completed`, `cancelled`。連絡先ステータス: `pending`, `scheduled`,
`calling`, `completed`, `failed`, `exhausted`。

## 次のステップ

<CardGroup cols={2}>
  <Card title="通話をライブで監視" icon="tower-broadcast" href="/ja/guides/monitor-live-calls">
    キャンペーン通話をリアルタイムで聞く。
  </Card>

  <Card title="アウトバウンド通話 API" icon="phone-arrow-up-right" href="/ja/guides/place-outbound-calls">
    個別の通話をプログラムで発信する。
  </Card>
</CardGroup>