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