Skip to main content
デモ番号はプロトタイピングには適していますが、本番トラフィックには独自のVoIPプロバイダーを通じて所有する番号を使用してください。このガイドでは、3ステップのフローを説明します: 認証情報をテスト → 接続を作成 → 番号をインポート → 検証
ダッシュボードの 接続 → VoIP (/dashboard/voip-connections) には、このフロー全体のガイド付きバージョンがあります。アカウント作成とAPIキーを案内するTelnyxガイド付きセットアップ、既存アカウントの接続パス、AIセットアップガイド生成機能を備えた手動SIPフォームが含まれます。

対応プロバイダー

1. 認証情報をテスト

永続的なVoIP接続を作成する前に、プロバイダーの認証情報をテストして動作を確認します。これにより、作成ステップに渡すverification_evidence_idが返され、テストのために認証情報が二重課金されることを防ぎます。
Response
いずれかのチェックに失敗した場合、レスポンスのstatusfailとなり、checksに失敗したステップが表示されます。プロバイダー側の設定(トランク割り当て、IP許可リスト、発信認可)を修正して、再試行してください。

2. 接続を作成

取得したverification_evidence_idを渡します。
レスポンスは、status="connected"VoIP接続オブジェクトです。認証情報はサーバー側に保存され、後続のGETで平文として返されることはありません。ローテーションするには、新しいtestを実行し、新しいエビデンスを使用してPATCHします。

3. 番号を一覧表示してインポート

認証情報で参照でき、まだThunderPhone組織に存在しない番号を確認します。
次に、必要な番号をインポートします。
各インポートは、組織内でsource="voip"およびstatus="provisioning"を持つ電話番号リソースになります。

4. インポートした各番号を検証する

インポートすると番号は利用可能として登録されますが、実際にその番号で通話をルーティングするには、往復の検証(着信ダイヤルイン確認 + 発信認可プローブ)が必要です。
成功すると、voip_verification_statusverified に切り替わり、番号は status="active" になります。失敗した場合、レスポンスには失敗内容が示されます。修正後(多くの場合はプロバイダーダッシュボードでのトランク割り当て漏れ)、再度呼び出してください。

5. エージェントを割り当てて通話する

番号を検証したら、デモ番号と同じ方法で着信 / 発信エージェントを 割り当てます。着信通話を処理するおよび 発信通話を行うを参照してください。

認証情報のローテーション

プロバイダーキーがローテーションされた場合は、テストしてから更新するフローを再実行します。
接続は維持されるため、番号を再インポートする必要はありません。

次のステップ

VoIP接続リファレンス

接続、エビデンス、インポートのレスポンスに含まれるすべてのフィールド。

電話番号リファレンス

エージェントの割り当て、組織間の転送、番号の解放。

発信通話を行う

番号を所有したら、発信を開始できます。