ダッシュボードの 接続 → VoIP (
/dashboard/voip-connections) には、このフロー全体のガイド付きバージョンがあります。アカウント作成とAPIキーを案内するTelnyxガイド付きセットアップ、既存アカウントの接続パス、AIセットアップガイド生成機能を備えた手動SIPフォームが含まれます。対応プロバイダー
1. 認証情報をテスト
永続的なVoIP接続を作成する前に、プロバイダーの認証情報をテストして動作を確認します。これにより、作成ステップに渡すverification_evidence_idが返され、テストのために認証情報が二重課金されることを防ぎます。
Response
statusはfailとなり、checksに失敗したステップが表示されます。プロバイダー側の設定(トランク割り当て、IP許可リスト、発信認可)を修正して、再試行してください。
2. 接続を作成
取得したverification_evidence_idを渡します。
status="connected"のVoIP接続オブジェクトです。認証情報はサーバー側に保存され、後続のGETで平文として返されることはありません。ローテーションするには、新しいtestを実行し、新しいエビデンスを使用してPATCHします。
3. 番号を一覧表示してインポート
認証情報で参照でき、まだThunderPhone組織に存在しない番号を確認します。source="voip"およびstatus="provisioning"を持つ電話番号リソースになります。
4. インポートした各番号を検証する
インポートすると番号は利用可能として登録されますが、実際にその番号で通話をルーティングするには、往復の検証(着信ダイヤルイン確認 + 発信認可プローブ)が必要です。voip_verification_status が verified に切り替わり、番号は
status="active" になります。失敗した場合、レスポンスには失敗内容が示されます。修正後(多くの場合はプロバイダーダッシュボードでのトランク割り当て漏れ)、再度呼び出してください。
5. エージェントを割り当てて通話する
番号を検証したら、デモ番号と同じ方法で着信 / 発信エージェントを 割り当てます。着信通話を処理するおよび 発信通話を行うを参照してください。認証情報のローテーション
プロバイダーキーがローテーションされた場合は、テストしてから更新するフローを再実行します。次のステップ
VoIP接続リファレンス
接続、エビデンス、インポートのレスポンスに含まれるすべてのフィールド。
電話番号リファレンス
エージェントの割り当て、組織間の転送、番号の解放。
発信通話を行う
番号を所有したら、発信を開始できます。