---
title: "アウトバウンドキャンペーン"
description: "連絡先リストをアップロードすると、エージェントが発信可能時間帯、再試行、進行状況のリアルタイム表示を活用して処理します。"
---
キャンペーンは連絡先リストに対して設定した内容に従い発信します。エージェントを選択し、CSV をアップロードして、発信可能な時間を設定すると、ThunderPhone がリストを順に処理します。選択したスケジュールに従って、不応答や留守番電話への再試行も行います。**エンゲージメント → キャンペーン**（`/dashboard/campaigns`）で確認できます。
単発のプログラムによる発信には、[アウトバウンド通話 API](/ja/guides/place-outbound-calls)を使用してください。
## 前提条件
- デプロイ済みの音声エージェント。
- 発信対応の電話番号。顧客のVoIP番号は引き続きキャンペーンをサポートします。ThunderPhoneの番号は最初は着信専用です。組織管理者は、電話番号ページから発信をリクエストできます。ThunderPhoneは各リクエストを手動で審査し、承認された番号でキャンペーンを実行できます。[VoIPプロバイダーを接続する](/ja/guides/voip-providers)を参照してください。
- `phone` または `phone_number` 列を含むCSVファイル（または貼り付けたJSON）の連絡先。**1回のアップロードにつき最大5,000行**、UTF-8エンコード。新しいJSONアップロードはフラットな構造である必要があります。追加の値には、文字列、数値、ブール値、または `null` を使用できます。配列またはネストされたオブジェクトを含む行は、検証メッセージとともに個別に拒否されます。有効な行は引き続きインポートされます。CSVセルは文字列です。受け入れられた追加列は、キャンペーンの連絡先レコードで連絡先ごとの変数として保持され、各発信に自動的に渡されます。ThunderPhoneは、各発信通話の前に保存済みエージェントのプロンプトも分類し、エージェントが電話メニューを操作すべきかどうかを判断します。`name` や `account_id` などのヘッダーは、保存済みエージェントのプロンプト内の `{{name}}` および `{{account_id}}` に対応します。名前マッピングでは、列を組み合わせて `name` にすることもできます。デフォルト、命名規則、32 KBのオブジェクト上限、および完了Webhookで返される値については、[通話ごとの変数](/ja/guides/call-variables)を参照してください。
以前の JSON アップロードによる古い連絡先レコードには、ネストされたメタデータが含まれている場合があります。そのメタデータは保存された連絡先に残ります。各発信では変数ペイロードから非スカラー値を除外し、値は記録せずに、その試行で無視されたキー名をログに記録します。再試行でも同じフィルタリングが使用されます。
## キャンペーンを作成する
名前を付け、**音声エージェント**を選択して、**発信元番号**
（アウトバウンド対応番号のいずれか）を選択します。
電話番号または変数が無効な行は個別に拒否され、行番号とともに
報告されます。それ以外の行は問題なくインポートされます。
**タイムゾーン**と1日の**開始時刻/終了時刻**の時間帯を選択します。キャンペーンは
その時間帯にのみ発信します。タイムゾーンは、発信元番号のゾーン
（米国およびカナダでは市外局番、それ以外では国）を基準とします。フリーダイヤル番号のように
複数のゾーンにまたがる番号の場合は、ブラウザのタイムゾーンを使用します。
どちらが適用されるかは、フィールド下のヒントに表示されます。デフォルトの時間帯は
午前9時から午後5時です。午前8時より前に開始する、または午後9時より後に終了する時間帯には
警告が表示されます。この時間外の通話は、TCPAなどの発信時間に関する規則に
違反する可能性があります。終了時刻が開始時刻より前の場合、日付をまたぎます。たとえば、22:00 →
02:00では、警告とともに午後10時から翌日の午前2時まで発信します。時間帯は各連絡先のタイムゾーンではなく、
キャンペーンのタイムゾーンで実行されるため、連絡先が複数のタイムゾーンに分散している場合は
タイムゾーンごとに分けてください。
必要に応じて、開始を予約する**開始日時**と、キャンペーンを自動的に完了させる
**終了日時**を設定します。
- **同時通話数** — このキャンペーンが同時に実行する通話数
（1～10、デフォルトは3）。組織で10件のアウトバウンド通話が進行中の場合、
キャンペーンは新しい通話を開始しません。そのため、並行するキャンペーンは
この上限を共有します。すべての通話は、組織の[同時通話数上限](/api-reference/introduction#call-limits)
（デフォルトは20。インバウンド、アウトバウンド、ウェブ、テスト通話の合計）にも
カウントされます。この上限に達している場合、または同じ番号に過去10秒以内に発信している場合、
連絡先は次回の処理まで待機します。試行回数は消費されません。
- **最大試行回数** — 各連絡先に発信できる回数
（1～10、デフォルトは2）。
- **再試行までの待機時間（分）** — 再試行前の待機時間（最低30、
デフォルトは60）。
- **再試行する結果** — 再試行を行う結果：**応答なし**、
**留守番電話**、**失敗**（すべてデフォルトで有効）。
より多くの試行回数や短い間隔が必要な場合は、サポートにお問い合わせください。スタッフが
組織の両方の上限を引き上げることができます。
キャンペーンは下書きとして作成されます。連絡先を追加できるのは、キャンペーンが
下書きである間のみです。キャンペーンを開始するには、通話料金への明示的な同意が
必要です。将来の**開始日時**を設定すると*スケジュール済み*になり、
それ以外の場合は直ちに*実行中*になります。
これらの上限が導入される前に保存されたキャンペーンは、設定どおりに実行され続けます。
他の編集を行っても、試行回数と間隔は保存時のまま維持されます。
## 結果と再試行の仕組み
各通話後、連絡先には結果が設定されます。成功した通話は
完了としてマークされます。応答なしと判定された通話、留守番電話と検出された通話、
または失敗した通話は、その結果が **再試行対象** リストに含まれており、かつ
連絡先に残りの試行回数がある場合に再試行されます。試行回数を使い切った連絡先は
*試行回数上限到達* としてマークされます。再試行不可の失敗は *失敗* としてマークされます。
アカウント残高の状態が正常でない間は、発信が自動的に一時停止し、
正常な状態に戻ると再開します。長期間のキャンペーンでは
[自動チャージ](/ja/guides/billing-and-topups)を有効にしてください。
## 監視と制御
各キャンペーンカードには、ステータスと進行状況（例: 「248件中173件完了」）が表示されます。
キャンペーンを開くと、ステータスの内訳、連絡先ごとの結果、最近の通話を確認できます。各項目から、
通話履歴内の完全な文字起こしと録音にアクセスできます。
- **一時停止 / 再開** — 一時停止すると新規発信が停止します。すでに
進行中の通話は自然に終了します。一時停止中のキャンペーンは編集および再開できます。
- **キャンセル** — キャンペーンを完全に停止します。
- すべての連絡先が最終状態に達するか、**終了日時** を過ぎると、キャンペーンは自動的に完了します。
キャンペーンのステータス: `draft`、`scheduled`、`running`、`paused`、
`completed`、`cancelled`。連絡先のステータス: `pending`、`scheduled`、
`calling`、`completed`、`failed`、`exhausted`。
## 次のステップ
キャンペーンの通話をリアルタイムで聞けます。
個別の通話をプログラムから発信します。