ThunderPhone v3、提供開始。セルフサービスで、1分あたり2セントから。発表内容を見る

Using the dashboard

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

連絡先リストをアップロードすると、エージェントが発信可能時間帯、再試行、進行状況のリアルタイム表示を活用して処理します。

キャンペーンは連絡先リストに対して設定した内容に従い発信します。エージェントを選択し、CSV をアップロードして、発信可能な時間を設定すると、ThunderPhone がリストを順に処理します。選択したスケジュールに従って、不応答や留守番電話への再試行も行います。エンゲージメント → キャンペーン(/dashboard/campaigns)で確認できます。

単発のプログラムによる発信には、アウトバウンド通話 APIを使用してください。

前提条件

  • デプロイ済みの音声エージェント。
  • 発信が有効な電話番号。顧客の VoIP 番号では引き続きキャンペーンを利用できます。ThunderPhone の番号は当初、着信専用です。組織管理者は、電話番号ページから発信をリクエストできます。ThunderPhone は各リクエストを手動で審査し、承認された番号でキャンペーンを実行できます。VoIP プロバイダーに接続を参照してください。
  • phone または phone_number 列を含む CSV ファイル(または貼り付けた JSON)形式の連絡先。アップロードあたり最大 5,000 行、UTF-8 エンコードが必要です。 新しい JSON アップロードはフラットである必要があります。追加の値には、文字列、数値、 真偽値、または null を使用できます。配列またはネストされたオブジェクトを含む行は、 検証メッセージとともに個別に拒否されますが、有効な行は引き続きインポートされます。CSV セルは 文字列です。受け入れられた追加列は、キャンペーンの連絡先レコードに連絡先ごとの変数として保持され、 各発信時に自動的に渡されます。ThunderPhone はまた、各発信前に保存された エージェントのプロンプトを分類し、エージェントが電話メニューを操作すべきかどうかを判断します。name や account_id などのヘッダーは、表記にかかわらず、保存されたエージェントのプロンプト内の {{name}} および {{account_id}} と一致します。名前マッピングでは、列を組み合わせて name にすることもできます。デフォルト値、命名規則、 32 KB のオブジェクト上限、および完了 Webhook で返される値については、 通話ごとの変数を参照してください。

以前の JSON アップロードによる古い連絡先レコードには、ネストされたメタデータが含まれている場合があります。そのメタデータは保存された連絡先に残ります。各発信では変数ペイロードから非スカラー値を除外し、値は記録せずに、その試行で無視されたキー名をログに記録します。再試行でも同じフィルタリングが使用されます。

キャンペーンを作成する

  1. 新しいキャンペーンをクリック

    名前を付け、音声エージェント を選択し、発信元番号 を選択します。 発信対応の番号を1つ以上選択してください。複数の市内番号に通話を分散すると、 各番号を通信事業者のスパム判定しきい値未満に保ち、相手には市外局番が地域のものとして表示されます。詳細は 番号プールを参照してください。

  2. 連絡先CSVをアップロード

    無効な電話番号または無効な変数を含む行は個別に拒否され、 行番号とともに報告されます。他の行は正常にインポートされます。

  3. 発信時間帯を設定

    タイムゾーン と毎日の開始/終了時間を選択します。キャンペーンは この時間帯にのみ発信します。タイムゾーンは最初の発信元番号のゾーン (米国およびカナダでは市外局番、それ以外の地域では国)に基づきます。発信番号から 判定できない場合は、エージェントのタイムゾーンが使用されます。フリーダイヤル番号など、 複数のゾーンにまたがる番号では、エージェントのタイムゾーンが使用されます。 エージェントにタイムゾーンがない場合は、ブラウザのタイムゾーンが使用されます。フィールドの下にあるヒントには、 使用されるタイムゾーンが表示されます。時間帯のデフォルトは 午前9時~午後5時です。午前8時より前に開始する、または午後9時より後に終了する時間帯には 警告が表示されます。この時間外の通話は、TCPAなどの発信時間に関する規則に 違反する可能性があります。終了時刻が開始時刻より早い場合は日付をまたぎます。たとえば、22:00 → 02:00では、午後10時から翌日の午前2時まで発信し、警告が表示されます。 各連絡先の現地時間で発信 はデフォルトで有効になっており、 市外局番に基づいて各連絡先がいる地域で時間帯を適用します。午前9時は、ニューヨークの連絡先ではニューヨークの午前9時、 ロサンゼルスの連絡先ではロサンゼルスの午前9時を意味します。 米国またはカナダの市外局番がない連絡先には上記のタイムゾーンが使用され、 2つのゾーンにまたがる市外局番には、両方が時間帯内にある場合にのみ発信されます。 これを無効にすると、すべての連絡先に対してキャンペーンのタイムゾーンで時間帯が適用されます。 必要に応じて、開始を予約する 開始日時 と、キャンペーンを自動的に完了する 終了日時 を設定します。

  4. ペースと再試行を調整
    • 同時通話数 — このキャンペーンで同時に実行する通話数です (1~10、デフォルトは3)。組織で10件のアウトバウンド通話が進行中の場合、 キャンペーンは新しい通話を開始しません。そのため、並行するキャンペーンでは この上限を共有します。各通話は組織の 同時通話上限 (デフォルトは20。着信、発信、Web、テスト通話の合計)にもカウントされます。 この上限に達している場合、または同じ番号に過去10秒以内に発信した場合、 連絡先は次回の処理を待機します。試行回数は消費されません。
    • 番号ごとの1日あたりの通話数 — 各発信元番号が任意の24時間以内に発信できる アウトバウンド通話の最大数です(1~500、デフォルトは75)。上限を設定しない場合は 値をクリアします。プール内の番号が現在、中程度または高いスパムリスクとして フラグ付けされている場合、キャンペーンはフラグが解除されるまでその番号をスキップします。
    • 最大試行回数 — 各連絡先に発信できる回数です (1~10、デフォルトは2)。
    • 再試行バックオフ(分) — 再試行までの最短待機時間です (最低30、デフォルトは60)。
    • 再試行タイミング — 日付と時間帯に分散 はデフォルト設定で、 各再試行をより後の日付と、連絡先の1日の異なる時間帯(午前、昼、午後遅く)に移動します。 バックオフ後 は、バックオフ時間の経過後に正確に再試行します。
    • 応答がない場合は2回発信 — 通話が応答されずに鳴り終わった場合、 30~60秒後に同じ番号からもう一度発信します。試行回数は消費されません。iPhoneでは、 「繰り返しの着信を許可」が有効な場合、3分以内の2回目の着信は「おやすみモード」を 通過して鳴ることがあります。再発信には発信時間がかかるため、ほとんどの通話が応答されずに終わるキャンペーンでは、 これを有効にすると新規の連絡先への到達が遅くなります。
    • 再試行する条件 — 再試行をトリガーする結果です。応答なし、 留守番電話、失敗(すべてデフォルトで有効)。

    より多くの試行回数や短い間隔が必要な場合は、サポートにお問い合わせください。スタッフが 組織の両方の上限を引き上げることができます。

  5. 下書きを作成してから開始

    キャンペーンは下書きとして作成されます。連絡先を追加できるのは、キャンペーンが 下書きである間のみです。キャンペーンを開始するには、通話料金への明示的な同意が 必要です。将来の開始日時を設定するとスケジュール済みになり、 それ以外の場合は直ちに実行中になります。

番号プールと1日の上限

通信事業者は、1日に多くの通話を発信したり短時間に連続して発信したりする番号をスパムとして扱います。また、地域の市外局番が表示されると、相手が電話に出る可能性が高まります。複数の発信番号で構成されるキャンペーン(番号プール)では、通話をそれらの番号に分散します。

  • 各連絡先には、前回の発信に使用した番号から電話がかかるため、再試行でも同じ発信者番号が使用されます。新しい連絡先には、その市外局番のプール番号が割り当てられます。該当する番号がない場合は同じタイムゾーンの番号、それもない場合は直近24時間で最も使用回数が少ない番号が割り当てられます。連絡先テーブルでは、各連絡先に発信した番号を確認できます。発信前にテキスト送信を有効にすると、番号はテキストを送信した連絡先のための枠を確保します。その枠がすべて埋まると、再試行は別のプール番号から発信される場合があります。
  • 番号ごとの1日あたりの通話数には、他のキャンペーンや API 呼び出しを含め、直近24時間に組織内でその番号から発信されたすべてのアウトバウンド通話がカウントされます。
  • アウトバウンド通話の利用開始から1週間未満の ThunderPhone 番号にはウォームアップが適用されます。初日は最大20件の通話を発信し、7日目までに上限まで均等に増加します。独自の通信事業者の番号ではウォームアップは適用されません。
  • すべての番号が上限に達すると、連絡先は待機状態になります。失敗にはならず、試行回数も消費されません。キャンペーンページには待機している理由が表示され、直近24時間の通話が集計対象外になると自動的に発信が再開されます。より速く進めるには、キャンペーンを一時停止して番号を追加するか、上限を引き上げます。
  • キャンペーンの途中で番号が使用できなくなった場合でも、キャンペーンは残りの番号から発信を続けます。使用可能な番号がなくなった場合にのみ一時停止します。

目安として、リストの1日あたりの件数を番号数で割った値が上限未満になるように、プールの規模を設定します。プールは発信ペースの制御と地域性のためのものです。スパムとして扱われた番号は、新しい番号を追加して隠すのではなく利用停止にしてください。

通話前にテキストを送信

事前に着信すると伝えられた番号には、発信者が応答しやすくなります。キャンペーンでは、最初の通話の数分前に各連絡先へテキストを送信し、誰がどの番号から発信するかを伝えられます。

キャンペーンの作成または編集フォームで、通話前にテキスト送信から有効にします。有効にしたら、テキストの送信元で番号を選択し、メッセージを編集して、通話前の分数を設定します(1~60、デフォルトは2)。API では、キャンペーンの pre_call_sms_* フィールドを設定します。

  • テキストは自身の Twilio または Telnyx の番号から送信されます。ThunderPhone の番号ではテキストを送信できません。

  • メッセージでは、連絡先の変数に加えて {{org_name}}、{{agent_name}}、{{call_from_number}} を使用できます(この連絡先に発信するプール番号であり、通話はこの番号から発信されます)。変数がない場合は省略されるため、名が登録されていない連絡先には「Hi, this is …」と表示されます。デフォルトのメッセージは次のとおりです。

    Hi {{first_name}}, this is {{org_name}}. We'll call you in a few minutes from {{call_from_number}}. Reply STOP to opt out of texts.
  • テキストが送信されるのは最初の通話のみで、再試行時には送信されません。キャンペーンは5分ごとに通話を実行するため、デフォルトの2分では、テキスト送信から約5分後に通話されます。

  • 通話前の分数は短く保ちます。テキストを送信した連絡先は通話されるまで通話枠を占有するため、長いリードタイムはキャンペーンを遅くします。たとえば、同時に3件発信し、30分に設定すると、3人にテキストを送信した後、通話するまで30分待機します。テキストを送信した連絡先は、期限が来た再試行より先に通話されます。

  • テキストは、発信時間帯が開いており、通話時にも開いている場合にのみ送信されます。さらに5分の余裕が必要です。各連絡先の現地時間で発信が有効な場合、その連絡先自身の時間帯が適用されます。それ以外の場合、連絡先は次の時間帯まで待機します。時間帯は、通話前の分数に12分を加えた長さ以上である必要があります。

  • テキストの送信に失敗した場合やスキップされた場合でも、通話は遅延しません。連絡先には直ちに発信されます。固定電話はスキップされます。送信に失敗したテキストは再送されません。

キャンペーンを開くと、各連絡先のテキスト結果をテキスト列で確認できます。結果は、配信済みまたは送信済み、未送信(理由付き)、スキップ、または不明です。API では、連絡先の pre_call_smsで確認できます。また、各テキストは GET /v1/sms に source: "pre_call" として表示されます。

携帯電話番号をスキップ

携帯電話番号へのAI音声通話には、TCPAに基づき本人からの事前の明示的な同意が必要です。企業または固定電話に発信し、リスト内の携帯電話番号についてその同意を得ていない場合は、Zeusにキャンペーンで携帯電話番号をスキップするよう依頼するか、APIを通じてline_type_filterをskip_mobileに設定してください。

  • 各連絡先の番号は、最初の通話の直前に照会されます。固定電話、VoIP、フリーダイヤル番号には発信されますが、携帯電話番号および照会で分類できない番号には発信されません。skip_landlineは逆の動作を行い、固定電話のみをスキップします。
  • 照会ごとに1セント未満の料金が残高から請求されます(料金を参照)。組織で過去90日間に照会した番号は無料で、発信されない連絡先は照会されません。Zeusは有効にする前に確認します。
  • スキップされた連絡先は、結果がskipped_mobile(またはskipped_landline、skipped_unknown_line_type)のfailedとして終了し、発信されることはなく、キャンペーン結果ではスキップとしてカウントされます。
  • 照会に失敗した場合、連絡先は次回の処理を待機します。3回の処理で失敗すると、line_type_check_failedで終了し、発信されません。

このフィルターは、発信する番号に対する同意に代わるものではありません。

結果と再試行の仕組み

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

監視と制御

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

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

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

次のステップ