電話システム接続操作マニュアル

Audio Agent を電話システムとインテグレーションすることで、音声 Agent が直接電話に応答できるようになります。ユーザーは電話をかけるだけで Agent と音声で対話できます。
今回のサポート範囲：

• Twilio サービスプロバイダー · 着信（ユーザーから電話がかかってくる）· 番号着信。「お客様が直接電話番号にダイヤルするだけで Agent と通話できる」シーンに適しています。
• サードパーティ SIP 転送による着信。すでにコールセンターやアウトバウンドシステムがあり、お客様に接続した後、通話を Agent に転送するシーンに適しています。

一、はじめる前に（事前準備）

1. 音声機能を有効化済みの Agent
   Agent には音声モデル、ボイス、開始メッセージ（オープニングトーク）を設定しておく必要があります（Agent の音声設定で行います）。電話が接続された際に再生されるのは、まさにここで設定した開始メッセージです。
2. Twilio アカウント
   • 「公衆網番号着信」を利用する場合：自分自身の Twilio アカウントが必要で、電話番号を購入済みである必要があります。
   • 「サードパーティ SIP 転送」を利用する場合：GPTBots プラットフォームが提供する共有 SIP エンドポイントを使用するため、番号を自分で用意する必要はありません。
3. アクセス経路：開発スペース → あなたの Agent → インテグレーション → 電話システム。

二、公衆網電話番号のバインド（最も一般的）

「お客様が直接電話番号にダイヤルするだけで Agent と通話できる」シーンに適しています。

手順

1. サービスプロバイダー：Twilio · Elastic SIP Trunk を選択します。

2. Twilio アカウント情報を入力します：

   項目	入力内容	説明
   Account SID	ACxxxxxxxx…	Twilio コンソールのトップページで確認できます
   Auth Token	あなたの Twilio Auth Token	着信リクエストの署名（X-Twilio-Signature）を検証し、偽装された着信を防止するために使用します
   Elastic SIP Trunk ドメイン	your-trunk.pstn.twilio.com	あなたの Trunk ドメイン
   接続リージョン	最寄りを選択（US1 / IE1 / DE1 / AU1 / JP1 / SG1）	通話の遅延に影響します
   バインドする電話番号	+1 415 555 0188	Twilio で購入した番号（国番号を含む）
   通話方向	着信のみ	今回は着信のみサポートします

3. 保存をクリックします。保存が成功すると、「Webhook」エリアにメディア / コールバック URL が自動生成されます。

4. この URL を Twilio に反映します：
   「メディア / コールバック URL」をコピー → Twilio コンソールで該当番号の設定を開く → A CALL COMES IN（着信があったとき） を見つける → 方式で Webhook を選択し、この URL を貼り付け、メソッドは HTTP POST を使用 → 保存します。

5. 完了です。携帯電話でこの番号にダイヤルすると、Agent の開始メッセージが聞こえ、対話を開始できるはずです。

三、サードパーティ SIP システムからの転送着信（コールセンター / PBX）

「すでにコールセンターやアウトバウンドシステムがあり、お客様に接続した後、通話を Agent に転送する」シーンに適しています。この場合、GPTBots 自身が 1 つの SIP エンドポイントとして機能し、純粋な SIP 相互接続となり、電話番号は不要です。

このエリアは、サービスプロバイダーが Twilio であり、かつプラットフォームで共有 SIP Domain が有効化されている場合にのみ表示されます。

表示される情報

1. Agent SIP アドレス（SIP URI）· 唯一の音声入口
   サードパーティシステムがお客様に接続した後、通話を SIP REFER 転送でこのアドレスに転送すると、「着信」として同一の Agent に接続されます。
2. SIP ユーザー名 / SIP パスワード（設定を保存すると自動生成されます）
   あなたの PBX / ソフトフォンは、このユーザー名とパスワードで SIP Domain 上で認証を行います。

   ⚠️ パスワードは生成 / 再生成時に一度だけ表示され、プラットフォームには保存されません。直ちにコピーして厳重に保管してください。忘れた場合は「再生成」をクリックして新しいものに交換するしかありません。

3. サポート機能：SIP REFER / 転送、カスタムヘッダー（X-headers）によるパラメータ受け渡し、TLS / SRTP。

使用ガイド

あなたの SIP システムで、上記の SIP ユーザー名 + パスワード を使って Agent SIP アドレス に発信 / 転送するだけです。公衆網番号も同時にバインドしている場合、両者は同一の Agent に接続されるため、重複して設定する必要はありません。

四、応用：エンドユーザーの ID を渡してパーソナライズする

デフォルトでは、Agent は着信番号によって発信者を識別します。もしあなたのシステムが独自のユーザー体系を持っている場合、SIP 通話時に**カスタムヘッダー（X-headers）**でユーザー識別子を付与できます：

• ヘッダー名：X-User-Id
• 役割：Agent はこれをもとに該当ユーザーの属性と過去の対話履歴を関連付け、パーソナライズされた応答を実現します（例：会員ランクや過去の注文に基づいて回答するなど）。

X-User-Id を渡さない場合、Agent は発信者番号を訪問者識別子として使用します。通常どおり対話は可能ですが、ユーザープロフィールに基づくパーソナライズは行われません。

五、テスト発信と記録の確認

1. バインドした番号にダイヤル（またはサードパーティシステムから転送）し、以下を確認します：
   • 開始メッセージが聞こえること。
   • 複数ターンの対話が正常に行えること。
   • 発話によって Agent が再生中の内容を**割り込み（中断）**できること。
2. ログ / 対話記録ページでその通話を確認できます：
   • 会話ソースは Twilio として表示され、着信番号が表示されます。
   • 完全な複数ターンの問答記録。
   • 実行タイムライン（logtree）：開始ノード → 各ターンの対話 / ツール呼び出し → 終了音声。

六、よくある質問（FAQ）

Q1. 番号にダイヤルしても反応がない / すぐに切断される？

• 「メディア / コールバック URL」が Twilio 番号の A CALL COMES IN に正しく反映されているか、メソッドが HTTP POST になっているかを確認してください。
• Auth Token が正しく入力されているか確認してください。誤りがあると着信の署名検証に失敗し、応答が拒否されます。
• Agent の音声機能が完全に設定されている（モデル / ボイス / 開始メッセージ）ことを確認してください。

Q2. クレジット不足と表示される / 接続できない？

• アカウントのポイントが十分か確認してください。ポイントが尽きると着信が拒否されます。
• 同時通話数の上限を超えていないか確認してください。上限を超えた新規着信は拒否されます。

Q3. SIP パスワードを忘れた場合は？

• 「再生成」をクリックして新しいパスワードを取得し（旧パスワードは即時無効になります）、あなたの SIP システムにも同期して更新してください。パスワードは一度だけ表示されるため、速やかに保存してください。

Q4. 1 通の電話の最長時間は？

• 1 通の通話は最長 60 分で、それを超えると自動的に終了します。

Q5. Agent から能動的に電話をかけさせることはできますか？

• 今回は着信（ユーザーから電話がかかってくる）のみサポートしており、アウトバウンド発信には対応していません。

七、注意事項

• 今回サポートするのは Twilio サービスプロバイダーと着信方向のみです。
• 通話の課金は通常の音声 Agent と同様で、使用量に応じてポイントが差し引かれます。
• インテグレーション設定（番号、認証情報など）を変更した後は、再度保存しないと有効になりません。