Calling SDK、Call Automation SDK、PSTN、Chat SDK、SMS SDK の通話終了応答コードのトラブルシューティング
この記事では、Calling SDK、Call Automation、PSTN 通話の通話終了応答コードのトラブルシューティングについて説明します。
トラブルシューティングのヒント
トラブルシューティングを行う場合は、次のヒントを考慮してください。
- アプリケーションが
IncomingCall Event Gridイベントを受信していない: イベント サブスクリプションを作成するときに、アプリケーション エンドポイントが Event Grid で有効になっていることを確認します。 検証が成功した場合、イベント サブスクリプションのプロビジョニング状態は成功としてマークされます。 - エラー
The field CallbackUri is invalidの場合: Call Automation は HTTP エンドポイントをサポートしていません。 指定したコールバック URL が HTTPS をサポートしていることを確認します。 PlayAudioアクションで何も再生されない: 現在、オーディオ ファイルでサポートされているのは Wave ファイル (.wav) 形式だけです。 Wave ファイルのオーディオ コンテンツは、モノラル (1 チャンネル) で、16,000 (16 KHz) サンプリング レートの 16 ビット サンプルである必要があります。- PSTN エンドポイントでのアクションが機能しない: 電話番号への
CreateCall、Transfer、AddParticipant、Redirectの場合は、アクション要求でSourceCallerIdを設定する必要があります。 アクションが成功するには、ダイレクト ルーティングを使っている場合を除き、ソース発信者 ID は Communication Services リソースによって所有されている電話番号である必要があります。
製品チームによって追跡される問題の詳細については、「既知の問題」を参照してください。
Note
次の表に示すメッセージと結果のカテゴリは、パブリック プレビュー段階です。 詳しくは、Microsoft Azure プレビューの追加使用条件に関するページをご覧ください。
通話コードとサブコードのエラーについて
エラー コード、サブコード、および対応する結果カテゴリは、開発者がエラーを特定して診断するのに役立ちます。 これらのエラー コードは、通話の終了後に call.callEndReason プロパティを通じて公開されます。
エラー コードの詳細は次のとおりです。
コード - クライアントまたはサーバーの応答状態を表す 3 桁の整数です。 コード カテゴリ:
- 成功応答 (200 - 299)
- クライアント エラー (400 - 499)
- サーバー エラー (500 - 599)
- グローバル エラー (600-699)
Subcode: 整数として定義されており、各値はシナリオのグループまたは特定のシナリオの結果に固有の一意の理由を示します。
Message: 結果について説明されており、結果が失敗の場合に問題を軽減する方法のヒントを提供します。
ResultCategory: エラーの種類を示します。 コンテキストに応じて、その値は Success、ExpectedError、UnexpectedClientError、または UnexpectedServerError になります。
Azure Communication Services Calling SDK クライアントのエラー コードとサブコード
クライアント エラーで、resultCategories プロパティが ExpectedError である場合、そのエラーは SDK の観点から予期されます。 そのようなエラーは一般的に、アプリから正しくない引数が渡された、または現在のシステム状態では API 呼び出しが許可されない場合など、前提条件の失敗において発生します。 アプリケーションでは、エラー理由と API 呼び出しのロジックをチェックする必要があります。
| サブコード | コード | メッセージ | 結果カテゴリ | 通知 |
|---|---|---|---|---|
| 40101 | 408 | CallAgent の作成に失敗しました。 もう一度お試しください。問題が解決しない場合は、ブラウザー コンソール ログと .HAR ファイルを収集し、Azure Communication Services サポートにお問い合わせください。 |
UnexpectedClientError | |
| 40104 | 408 | CallAgent の作成に失敗しました。 もう一度お試しください。問題が解決しない場合は、ブラウザー コンソール ログと .HAR ファイルを収集し、Azure Communication Services サポートにお問い合わせください。 |
UnexpectedClientError | |
| 40114 | 408 | Azure Communication Services インフラストラクチャへの接続に失敗しました。 もう一度お試しいただき、ブラウザーのネットワーク要求をチェックしてください。 要求が失敗し続ける場合は、ブラウザー コンソール ログと .HAR ファイルを収集し、Azure Communication Services サポートにお問い合わせください。 |
UnexpectedClientError | 詳細については、ネットワークの要件に関するページを参照してください。 |
| 40115 | 412 | CallAgent の作成に失敗しました。Azure Communication Services インフラストラクチャへの接続を初期化できません。 もう一度お試しいただき、ブラウザーのネットワーク要求をチェックしてください。 要求が失敗し続ける場合は、ブラウザー コンソール ログと .HAR ファイルを収集し、Azure Communication Services サポートにお問い合わせください。 |
UnexpectedClientError | 詳細については、ネットワークの要件に関するページを参照してください。 |
| 40216 | 500 | CallAgent の作成に失敗しました。 もう一度お試しください。問題が解決しない場合は、ブラウザー コンソール ログを収集し、Azure Communication Services サポートにお問い合わせください。 | UnexpectedClientError | |
| 40228 | 409 | CallAgent の作成に失敗しました。この ID に関連付けられた CallAgent のインスタンスは既に存在します。 既存の CallAgent を破棄するか、別の ID で新しく作成してください。 | ExpectedError | |
| 40230 | 409 | TeamsCallAgent の作成に失敗しました。この ID に関連付けられた TeamsCallAgent のインスタンスは既に存在します。 既存の TeamsCallAgent を破棄してから新しく作成してください。 | ExpectedError | |
| 40606 | 405 | スピーカーの列挙に失敗しました。Android Chrome、iOS Safari、macOS Safari 上でスピーカーを列挙または選択することはサポートされていません。 | ExpectedError | スピーカーの列挙や選択は、Android の Chrome、iOS の Safari、macOS の Safari のいずれでもサポートされていません。 オペレーティング システムは、スピーカー (出力デバイス) を自動的に選択します。 デバイス管理と、これらの問題を軽減する最適な方法の詳細についてご確認ください。 |
| 40613 | 400 | マイクやカメラの使用に対するアクセス許可の取得に失敗しました。拒否された、または失敗しました。 ブラウザーと OS の設定内でアクセス許可を付与してください。 | ExpectedError | デバイスのアクセス許可を処理する最適な方法の詳細についてご確認ください。 |
| 40614 | 500 | デバイスのアクセス許可の要求に失敗しました。ブラウザー設定内と OS 設定内でアクセス許可を付与してから、もう一度お試しください。 問題が解決しない場合は、ブラウザー コンソール ログを収集し、Azure Communication Services サポートにお問い合わせください。 | UnexpectedClientError | デバイスのアクセス許可を処理する最適な方法の詳細についてご確認ください。 |
| 41006 | 400 | 着信通話の受け入れに失敗しました。呼び出し中の状態ではありません。 CallAgent の incomingCall イベントをサブスクライブして、着信通話を受け入れます。 |
ExpectedError | この問題の根本原因を特定するには、次の記事を参照してください - 着信通話を受信する - SDK イベントをサブスクライブする |
| 41007 | 400 | 着信通話の拒否に失敗しました。呼び出し中の状態ではありません。 CallAgent の incomingCall イベントをサブスクライブして、着信通話を拒否します。 |
ExpectedError | この問題の根本原因を特定するには、次の記事を参照してください - 着信通話を受信する - SDK イベントをサブスクライブする |
| 41015 | 500 | マイクのミュートに失敗しました。 もう一度お試しください。この問題が解決しない場合は、ブラウザー コンソール ログを収集し、Azure Communication Services サポートにお問い合わせください。 | UnexpectedClientError | |
| 41016 | 400 | マイクのミュート解除に失敗しました。 もう一度お試しください。この問題が解決しない場合は、ブラウザー コンソール ログを収集し、Azure Communication Services サポートにお問い合わせください。 | UnexpectedClientError | |
| 41025 | 400 | ビデオの開始に失敗しました。LocalVideoStream インスタンスが無効または空です。 LocalVideoStream インスタンスを渡してください。 | ExpectedError | ビデオを開始するために渡されるオブジェクトが LocalVideoStream のインスタンスであることをご確認ください。 VideoDeviceInfo オブジェクトまたは MediaStream オブジェクトを使用して、LocalVideoStream を構築します。 この問題の根本原因を特定するには、次の記事を参照してください。 - ビデオ カメラを使用して呼び出しを行う - 通話中にローカル ビデオの送信を開始および停止する - 未加工のビデオにアクセスする |
| 41027 | 400 | ビデオの開始に失敗しました。ビデオは既に開始されています。 | ExpectedError | 役立つリンク: - ビデオ カメラを使用して呼び出しを行う - 通話中にローカル ビデオの送信を開始および停止する |
| 41030 | 400 | ビデオの停止に失敗しました。ビデオは既に停止しています。 | ExpectedError | 役立つリンク: - ビデオ カメラを使用して呼び出しを行う - 通話中にローカル ビデオの送信を開始および停止する |
| 41032 | 400 | ビデオの停止に失敗しました。引数が無効です。 入力として使用される LocalVideoStream は現在送信されていません。 | ExpectedError | 通話内で送信される LocalVideoStream は Call.localVideoStreams[] 配列内に格納され、その型は Video または RawMedia です。 この問題の根本原因を特定するには、次の記事を参照してください。 - ビデオ カメラを使用して呼び出しを行う - 通話中にローカル ビデオの送信を開始および停止する - 未加工のビデオにアクセスする |
| 41033 | 500 | 通話の保留に失敗しました。 もう一度お試しください。この問題が解決しない場合は、ブラウザー コンソール ログを収集し、Azure Communication Services サポートにお問い合わせください。 | UnexpectedClientError | |
| 41034 | 500 | 通話の再開に失敗しました。 もう一度お試しください。この問題が解決しない場合は、ブラウザー コンソール ログを収集し、Azure Communication Services サポートにお問い合わせください。 | UnexpectedClientError | |
| 41035 | 400 | 画面共有の開始に失敗しました。画面共有は既に開始されています。 | ExpectedError | 通話中に画面共有を開始および停止する方法の詳細についてご確認ください |
| 41041 | 400 | 画面共有の停止に失敗しました。画面共有は既に停止されています。 | ExpectedError | 通話中に画面共有を開始および停止する方法の詳細についてご確認ください |
| 41048 | 410 | 通話のセットアップ プロセス中にビデオの開始に失敗しました。 ブラウザー設定内と OS 設定内でビデオのアクセス許可を付与し、そのカメラ デバイスが別のプロセスで使用されていないことをご確認ください。 | UnexpectedClientError | - カメラ デバイスがシステム内で無効になっている可能性があります。 - カメラが別のプロセスで使用されています。 |
| 41056 | 412 | 通話の開始または参加に失敗しました。この Azure Communication Services リソースに対して Teams Enterprise 音声ポリシーが有効ではありません。 オンラインのチュートリアルに従って有効にしてください。 | ExpectedError | Teams Enterprise 音声ポリシーを有効にするには、Enterprise Voice オンラインおよび電話システム ボイスメールのユーザーを有効にする方法を参照してください |
| 41071 | 412 | 画面共有の開始に失敗しました。通話は接続状態ではありません。 通話の statteChanged イベントをサブスクライブして、通話がいつ接続されるかを確認します。 |
ExpectedError | 役立つリンク: - 通話のプロパティを確認する - SDK イベントをサブスクライブする |
| 41073 | 412 | カスタム MediaStream の取得または設定に失敗しました。この機能は現在、Azure Communication Services によって無効になっています。 | ExpectedError | |
| 43000 | 412 | ビデオの開始に失敗しました。ビデオ デバイスは別のプロセスまたはアプリケーションで使用されています。 カメラが他のプロセスまたはアプリケーション内で使用されないようにして、もう一度お試しください。 | ExpectedError | 別のプロセスで使用されているカメラに対処する最適な方法の詳細について理解を深めてください |
| 43001 | 403 | ビデオの開始に失敗しました。選択したビデオ デバイスを使用するアクセス許可が許可されていませんでした。 ブラウザー設定内とシステム設定内で、ビデオ デバイスのアクセス許可が付与されていることをご確認ください。 | ExpectedError | ブラウザー設定とデバイス システム設定内で、カメラのアクセス許可が付与されていることをご確認ください。 デバイス システム設定内でカメラが無効ではないことをご確認ください。 macOS 上では、システム設定から画面記録が許可されていることをご確認ください。 役立つリンク: - デバイスのアクセス許可を要求する- macOS での画面共有のアクセス許可 - macOS および iOS 上の Safari でのデバイスの列挙またはアクセス |
| 43002 | 500 | ビデオの開始に失敗しました。不明なエラーです。 やり直してください。 この問題が解決しない場合は、Azure Communication Services サポートにお問い合わせください。 | UnexpectedClientError | |
| 43004 | 400 | ビデオ デバイスの切り替えに失敗しました。入力が無効です。 入力は VideoDeviceInfo 型である必要があります。 | ExpectedError | デバイス マネージャーを使用して VideoDeviceInfo オブジェクトの一覧を取得し、VideoDeviceInfo オブジェクトを使用してソースを切り替えます。 通話中にローカル ビデオの送信を開始および停止する方法の詳細についてご確認ください |
| 43005 | 400 | ビデオ デバイスの切り替えに失敗しました。同じビデオ デバイスに切り替えることはできません。既に選択されています。 | ExpectedError | |
| 43013 | 412 | ビデオの開始に失敗しました。ビデオ デバイスが見つかりませんでした。 ビデオ デバイスの電源が接続されており、システム設定内で有効なことをご確認ください。 | ExpectedError | デバイス上にカメラが接続され、インストールされていることをご確認ください。 |
| 43014 | 412 | ビデオの開始に失敗しました。メディア ストリームを要求中にエラーが発生しました。 もう一度お試しください。問題が解決しない場合は、Azure Communication Services サポートにお問い合わせください。 | UnexpectedClientError | |
| 43015 | 412 | ビデオの開始に失敗しました。メディア ストリーム要求がタイムアウトしました。ブラウザーのプロンプトに応じてカメラへのアクセス許可を付与し、もう一度お試しください。 | ExpectedError | このエラーは、ユーザーがブラウザーのアクセス許可プロンプト上で、カメラへのアクセスを付与するアクションを実行しない場合に発生することがあります。 |
| 43016 | 412 | ビデオの開始に失敗しました。アクセス許可はシステムによって拒否されました。 ブラウザー設定内とシステム設定内で、ビデオ デバイスのアクセス許可が付与されていることをご確認ください。 | ExpectedError | - ブラウザー設定とデバイス システム設定内で、カメラのアクセス許可が付与されていることをご確認ください。 - デバイス システム設定内でカメラが無効ではないことをご確認ください。 - macOS 上では、システム設定から画面記録が許可されていることをご確認ください。 役立つリンク: - デバイスのアクセス許可を要求する -macOS での画面共有のアクセス許可 - macOS および iOS 上の Safari でのデバイスの列挙またはアクセス |
| 43017 | 412 | ビデオの開始に失敗しました。サポートされていないストリームです。 もう一度お試しください。問題が解決しない場合は、Azure Communication Services サポートにお問い合わせください。 | UnexpectedClientError | |
| 43018 | 412 | ビデオの開始に失敗しました。制約の設定に失敗しました。 もう一度お試しください。問題が解決しない場合は、Azure Communication Services サポートにお問い合わせください。 | UnexpectedClientError | ビデオの制約を設定する方法の詳細についてご確認ください |
| 43019 | 412 | ビデオの開始に失敗しました。デバイスが選択されていません。 VideoDeviceInfo を使用して作成された LocalVideoStream を確実に渡して、もう一度お試しください。 問題が解決しない場合は、Azure Communication Services サポートにお問い合わせください。 | UnexpectedClientError | 役立つリンク: - ビデオ カメラを使用して呼び出しを行う - 通話中にローカル ビデオの送信を開始および停止する |
| 43200 | 412 | ビデオ ストリームのレンダリングに失敗しました。このストリームは使用できません。 ストリームの isAvailable プロパティをサブスクライブし、リモート参加者がビデオをオンにして、かつストリームがレンダリングに使用できる際に通知を受け取ってください。 | ExpectedError | 役立つリンク: - リモート参加者の動画/画面共有ストリームをレンダリングする - アプリに 1 対 1 のビデオ通話を追加する - SDK イベントをサブスクライブする |
| 43202 | 404 | ビデオ ストリームのレンダリングに失敗しました。このストリームは使用できなくなりました。 リモート参加者がビデオをオフにしました。 | ExpectedError | リモート参加者が、そのビューの作成中にビデオをオフにしました。 |
| 43203 | 408 | ビデオ ストリームのレンダリングに失敗し、ビデオ フレームの待機中にレンダリングがタイムアウトしました。 もう一度お試しください。問題が解決しない場合は、Azure Communication Services サポートにお問い合わせください。 | UnexpectedClientError | |
| 43204 | 500 | ビデオ ストリームのレンダリングが失敗し、Azure Communication Services インフラストラクチャ上でビデオのサブスクライブに失敗しました。 もう一度お試しください。問題が解決しない場合は、Azure Communication Services サポートにお問い合わせください。 | UnexpectedClientError | |
| 43209 | 405 | ビデオ ストリームのレンダリングに失敗し、初期化プロセス中に VideoStreamRenderer が破棄されました。 | ExpectedError | |
| 43210 | 400 | VideoStreamRenderer の破棄に失敗しました。既に破棄されています。 | ExpectedError | |
| 43220 | 400 | ビューの作成に失敗しました。アクティブな RemoteVideoStream ビューの最大数に既に達しています。 新しく作成するためには、以前のものを破棄してください。 |
ExpectedError | 受信ビデオ ストリームの最適な数を適切にサポートする方法の詳細についてご確認ください |
| 480 | リモート クライアント エンドポイントが登録されていません。 | リモート エンドポイントが使用可能であることを確認します。 | ||
| 481 | 着信通話の処理に失敗しました。 | Azure portal からサポート リクエストを提出します。 | ||
| 487 | エンドポイントの不一致の問題が原因で通話がキャンセルされたか、ローカルで拒否されたか、終了しました。または、メディア プランの生成に失敗しました。 | 想定されている動作です。 | ||
| 490、491、496、497、498 | ローカル エンドポイント ネットワークの問題。 | ネットワークを確認します。 | ||
| 503、504 | Communication Services インフラストラクチャ エラー。 | Azure portal からサポート リクエストを提出します。 | ||
| 600 | どこでも通話中です。 参加者は正常に接続しましたが、通話中のシグナルが返されました。 | 想定されている動作です。 | ||
| 603 | Communication Services のリモート参加者によって、通話がグローバルに拒否されました。 | 想定されている動作です。 | ||
| 604 | どこにも存在しません。 要求された URI が存在しません。 | 想定されている動作です。 | ||
| 606 | 受信不可。 参加者は正常に接続されましたが、説明されているセッションをサポートできません。 | 想定されている動作です。 |
通話コードとサブコードのエラーについて
エラー コード、サブコード、および対応する結果カテゴリは、開発者がエラーを特定して診断するのに役立ちます。 これらのエラー コードは、通話の終了後に call.callEndReason プロパティを通じて公開されます。
エラー コードの詳細は次のとおりです。
コード - クライアントまたはサーバーの応答状態を表す 3 桁の整数です。 コード カテゴリ:
- 成功応答 (200 - 299)
- クライアント エラー (400 - 499)
- サーバー エラー (500 - 599)
- グローバル エラー (600-699)
Subcode: 整数として定義されており、各値はシナリオのグループまたは特定のシナリオの結果に固有の一意の理由を示します。
Message: 結果について説明されており、結果が失敗の場合に問題を軽減する方法のヒントを提供します。
ResultCategory: エラーの種類を示します。 コンテキストに応じて、その値は Success、ExpectedError、UnexpectedClientError、または UnexpectedServerError になります。
通話終了コードとサブコードの呼び出し
通話が終了した理由については、さまざまな説明があります。 通話の終了コードと、通話がどのように終了したかを示すサブコードの意味を次に示します。
| サブコード | コード | メッセージ | 結果カテゴリ | 通知 |
|---|---|---|---|---|
| 0 | 0 | 通話は、ローカル参加者によって正常に終了されました。 | 成功 | |
| 0 | 487 | 通話は、呼び出し元が通話を取り消したために正常に終了しました。 | 成功 | |
| 0 | 603 | 通話は、呼び出し先から拒否されたため正常に終了しました。 | 成功 | 通話は、クライアント SDK、Call Automation、Graph、PSTN、または Teams の拒否機能を介してターゲット ユーザーから拒否されたため、終了しました。 |
| 7 | 496 | クライアントのネットワーク接続が突然切れ、複数回再試行しても接続できなかったため、通話が終了しました | ExpectedError | ブラウザーがオフラインであるか、ネットワークに問題があります。 ブラウザーのネットワーク接続を確認して、再試行してください。 |
| 3100 | 410 | クライアントで予期しないネットワークの問題が発生したため、通話のセットアップに失敗しました。クライアントのネットワークを確認して再試行してください。 | UnxpectedClientError | ネットワーク構成を確認し、Azure Communication Calling のネットワーク要件に従っていることを確認します。 |
| 3101 | 410 | クライアントで予期しないネットワークの問題が発生したため、通話が終了しました。クライアントのネットワークを確認して再試行してください。 | UnxpectedClientError | ネットワーク構成を確認し、Azure Communication Calling のネットワーク要件に従っていることを確認します。 |
| 3111 | 410 | 通話のセットアップに失敗し、通話の接続中にメディア オファーを処理できませんでした。 | UnxpectedClientError | やり直してください。 問題が解決しない場合は、通話情報、クライアント ログ、ブラウザー コンソール ログを収集して、Azure Communication Services サポートにお問い合わせください。 |
| 3112 | 410 | クライアント側のネットワーク構成の問題が原因で通話のセットアップに失敗しました。クライアントのネットワーク構成を確認してから、再試行してください。 | ExpectedError | |
| 4097 | 0 | 通話は、会議の開催者によってすべてのユーザーについて終了されました。 | 成功 | |
| 4502 | 490 | ネットワーク接続の問題が原因で通話に失敗し、ブラウザーがネットワーク HTTP 要求を完了できませんでした。 | UnexpectedClientError | クライアントが HTTP 要求と応答を完了できませんでした。 やり直してください。 問題が解決しない場合は、通話情報、クライアント ログ、ブラウザー コンソール ログを収集して、Azure Communication Services サポートにお問い合わせください。 |
| 4506 | 408 | 通話がタイムアウトしました。呼び出し先が通話を受信し、通話に出たかどうかを確認します。 | UnexpectedClientError | やり直してください。 問題が解決しない場合は、通話情報、クライアント ログ、ブラウザー コンソール ログを収集して、Azure Communication Services サポートにお問い合わせください。 |
| 4507 | 495 | 通話は、アプリケーションが有効な Azure Communication Services トークンを提供しなかったために終了しました。 | UnexpectedClientError | アプリケーションでトークン更新メカニズムが正しく実装されていることを確認します。 |
| 4521 | 0 | ユーザーが通話から突然切断されたため、通話は終了しました。 これは、ユーザーが通話をホストしているアプリケーションを閉じたことが原因である可能性があります。たとえば、ユーザーが通話を切るための適切な操作をせずに、ブラウザー タブを閉じてアプリケーションを終了した場合などです。 | ExpectedError | |
| 5000 | 0 | この参加者の通話は終了しました。 参加者が別の参加者によって会話から削除されました。 | 成功 | |
| 5003 | 0 | 通話は、すべての呼び出し先エンドポイントが通話を拒否したため、正常に終了しました。 | 成功 | |
| 5300 | 0 | 通話は、この参加者が別の参加者によって会話から削除されたために終了しました。 | 成功 | 別の参加者が削除したため、この参加者の通話は終了しました (別のクライアント、Call Automation API、Graph API など)。 |
| 5,317 | 0 | 参加者ロールの更新のために、ターゲット参加者が削除されます。 | ExpectedError | |
| 5828 | 403 | ユーザーが招待者リストに含まれていないため、Rooms 会議への参加は承認されません。 | UnexpectedClientError | |
| 5829 | 403 | 会議の終了時刻を過ぎてから、または開始時刻より前に Rooms 会議に参加することはできません。 | UnexpectedClientError | |
| 5830 | 403 | Communication Services ユーザーのみが Rooms 会議に参加できます。 | ExpectedError | |
| 7000 | 0 | Azure Communication Service Call Automation API またはサーバー ボットによって通話が終了しました。 | 成功 | ACS Call Automation API または Graph ボットによって通話が終了しました。 |
| 10003 | 487 | 別のエンドポイントが他の場所で通話に出たため、このユーザー エンドポイントの通話は取り消されました。 | 成功 | ターゲット ユーザーに対して通話が開始され (通話の開始、参加者の追加、転送)、ターゲット ユーザーにアクティブなエンドポイントが同時に複数あり、そのエンドポイントの 1 つでユーザーが通話に出ました。 これは通常の動作です。通話に出て接続できるエンドポイントは 1 つだけです。 他のすべてのエンドポイントは、既に通話に出たことを示すサブコード 10003 を受け取ります。 |
| 10004 | 487 | 通話は、ターゲット ユーザーが時間内に出るか拒否しなかったため、タイムアウトで取り消されました。 ユーザーが通知を見たか、アプリケーションが自動的に処理できることを確認し、その通話をもう一度始めてみてください。 | ExpectedError | 通話は、事前に定義した時間 (通常は 2 分) が経ってもターゲット ユーザーが出るか拒否しなかったため、取り消されました。 |
| 10009 | 401 | 認証されていない ID。 Azure Communication Services トークンが有効であり、有効期限が切れていないことを確認します。 | UnexpectedClientError | |
| 10024 | 487 | 通話は正常に終了しました。 すべての呼び出し先エンドポイントによって通話が拒否されました。 | 成功 | もう一度通話を行ってみます。 |
| 10037 | 480 | ターゲット ユーザーに、ACS に登録されているエンドポイントがありませんでした。 ターゲット ユーザーに少なくとも 1 つのアクティブなエンドポイントがあり、それがオンラインであることを確認してください。 | ExpectedError | ターゲット ユーザーが Azure Communication Services Calling SDK を使用している場合は、そのクライアント アプリケーションで SDK が正常に初期化されていることを確認します。 ターゲット ユーザーが Teams ユーザーの場合は、クライアントがオンラインであることを確認します。 ターゲット ユーザーの識別子 (CommunicationUserIdentifier、MicrosoftTeamsUserIdentifier、または MicrosoftTeamsBotIdentifier) が正しいことを確認します。 Graph API user のプロパティ department が Microsoft Communication Application Instance に設定されている場合は、MicrosoftTeamsBotIdentifier を指定する必要があります。 |
| 10057 | 408 | 通話が失敗し、呼び出し先が通話のセットアップを完了できなかった、呼び出し先がネットワークを失った、またはアプリケーションを突然終了した可能性が一番高いです。 クライアントが接続され、使用可能であることを確認します。 | ExpectedError | |
| 10076 | 480 | ターゲット ユーザーは登録されていましたが、通話時にオンラインではありませんでした。 ターゲット ユーザーに少なくとも 1 つのアクティブなエンドポイントがあり、それがオンラインであることを確認してください。 | ExpectedError | ターゲット ユーザーが Azure Communication Services Calling SDK を使用している場合は、そのクライアント アプリケーションで SDK が正常に初期化されていることと、そのエンドポイントがオンラインであることを確認します。 ターゲット ユーザーが Teams ユーザーの場合は、クライアントがオンラインであることを確認します。 |
| 10077 | 480 | ターゲット ユーザーは ACS やプッシュ通知に登録されていましたが、通話時にオンラインではありませんでした。 ターゲット ユーザーに少なくとも 1 つのアクティブなエンドポイントがあり、それがオンラインであることを確認してください。 | ExpectedError | ターゲット ユーザーが Azure Communication Services Calling SDK を使用している場合は、そのクライアント アプリケーションで SDK が正常に初期化されていることと、そのエンドポイントがオンラインであることを確認します。 アプリケーションでプッシュ通知を利用する場合は、正しく構成されていることを確認してください。 ターゲット ユーザーが Teams ユーザーの場合は、クライアントがオンラインであることを確認します。 |
| 10078 | 480 | リモート クライアント エンドポイントが登録されていないか、到達不能です。 リモート クライアント エンドポイントが Azure Communication Services に正常にネットワーク要求を送信していることを確認してください。 | ExpectedError | - ターゲット ユーザーが Azure Communication Services Calling SDK を使用している場合は、そのクライアント アプリケーションで SDK が正常に初期化されていることと、そのエンドポイントがオンラインであることを確認します。 アプリケーションでプッシュ通知を利用する場合は、正しく構成されていることを確認してください。 - ターゲット ユーザーが Teams ユーザーの場合は、クライアントがオンラインであることを確認します。 |
| 301004 | 410 | 参加者は、通話のセットアップ中に Azure Communication Services インフラストラクチャとのメディア接続を確立できないため、Azure Communication Services インフラストラクチャによって通話から削除されました。 ローカル ネットワーク、ファイアウォール、VPN の構成など、ユーザーのネットワーク構成を確認してから、もう一度やり直してください。 | UnexpectedClientError | ユーザーのネットワークが正しく構成されていることを確認し、公開されている「ネットワークの推奨事項」ドキュメントに従ってください。 |
| 301005 | 410 | 同じインフラストラクチャとのメディア接続が失われたため、Azure Communication Services インフラストラクチャによる通話から参加者が削除されました。 これは通常、参加者が突然通話を終了するか、ネットワーク接続を失った場合に発生します。 参加者が通話を続行する場合は、再接続できます。 | UnexpectedClientError | サポートされている環境で最新の SDK を使用していることを確認します。 |
| 540000 | 0 | 通話は、ローカルの PSTN 発信者が正常に終了しました。 | 成功 | |
| 510403 | 403 | 通話は終了し、以前はスパムとしてマークされ、現在はブロックされました。 | ExpectedError | - Communication Services トークンが有効であり、有効期限が切れていないことを確認します。 - 通話オプションで AlternateId を渡していることを確認します。 |
| 540487 | 487 | 通話は、呼び出し元が通話を取り消したために正常に終了しました。 | 成功 | |
| 560000 | 0 | 通話は、リモート PSTN 参加者によって正常に終了されました。 | 成功 | 考えられる原因: - ユーザーが通話を終了しました。 - 通話はメディア エージェントによって終了されました。 |
| 560486 | 486 | 通話は、リモート PSTN 参加者がビジー状態であったため終了しました。 呼び出された番号が既に通話中であったか、技術的な問題が発生していました。 | 成功 | - ダイレクト ルーティング通話の場合は、セッション ボーダー コントロールのログと、設定およびタイムアウトの構成を確認します。 考えられる原因: 呼び出された番号が既に通話中であったか、技術的な問題が発生していました。 |
| 404 | 通話が見つかりません。 | 通話先の番号 (または参加している通話) が存在することを確認します。 | ||
| 408 | 通話コントローラーがタイムアウトしました。 | ユーザー エンドポイントからのプロトコル メッセージの待機中に通話コントローラーがタイムアウトしました。 クライアントが接続され、使用可能であることを確認します。 | ||
| 410 | ローカル メディア スタックまたはメディア インフラストラクチャ エラー。 | サポートされている環境で最新の SDK を使用していることを確認します。 | ||
| 430 | クライアント アプリケーションにメッセージを配信できません。 | クライアント アプリケーションが実行されていて使用可能であることを確認します。 | ||
| 480 | リモート クライアント エンドポイントが登録されていません。 | リモート エンドポイントが使用可能であることを確認します。 | ||
| 481 | 着信通話の処理に失敗しました。 | Azure portal からサポート リクエストを提出します。 | ||
| 490、491、496、497、498 | ローカル エンドポイント ネットワークの問題。 | ネットワーク構成を確認し、Azure Communication Calling のネットワーク要件に従っていることを確認します。 | ||
| 500、503、504 | Communication Services インフラストラクチャ エラー。 | Azure portal からサポート リクエストを提出します。 |
Call Automation SDK のエラー コード
次のエラー コードは、Call Automation SDK によって公開されます。
| サブコード | コード | メッセージ | 結果カテゴリ | 通知 |
|---|---|---|---|---|
| 400 | Bad request | 入力要求が無効です。 エラー メッセージを調べて、正しくない入力を確認します。 | ||
| 400 | 再生に失敗しました | オーディオ ファイルが WAV、16 KHz、またはMono であることを確認し、ファイル URL がパブリックにアクセスできることを確認します。 | ||
| 400 | 認識に失敗しました | エラー メッセージをご確認ください。 この失敗がタイムアウトに達したためか、操作が取り消されたためか、メッセージで確認できます。 エラー コードとメッセージの詳細については、「ユーザーによる入力の収集」を参照してください。 | ||
| 401 | 権限がありません | HMAC 認証が失敗しました。 CallAutomationClient の作成に使われている接続文字列が正しいかどうかを確認します。 | ||
| 403 | 許可されていません | 要求は禁止されています。 アクセスしようとしているリソースへのアクセス権があることを確認します。 | ||
| 404 | リソースが見つかりません | 処理しようとしている通話は存在しません。 たとえば、以前に切断された通話を転送します。 | ||
| 429 | Too many requests | Retry-After ヘッダーで提案されている遅延の後で再試行し、エクスポネンシャル バックオフを行います。 | ||
| 500 | 内部サーバー エラー | 遅延後に再試行します。 それでも解決しない場合は、サポート チケットを提出してください。 | ||
| 500 | 再生に失敗しました | Azure portal からサポート リクエストを提出します。 | ||
| 500 | 認識に失敗しました | エラー メッセージを確認し、オーディオ ファイル形式が有効 (WAV、16 KHz、Mono) であることを確認します。 ファイル形式が有効な場合は、Azure portal を使用してサポート リクエストを提出します。 | ||
| 502 | Bad gateway | 新しい http クライアントで遅延後に再試行します。 | ||
| 503、504 | Communication Services インフラストラクチャ エラー。 | Azure portal からサポート リクエストを提出します。 |
ParticipantEndReason を伴う PSTN 通話応答コード
このセクションでは、ParticipantEndReason と ParticipantEndSubCode 応答コードのさまざまな組み合わせに関するトラブルシューティング情報を提供します。 このセクションの表では、ParticipantEndReason = コードとParticipantEndSubCode = サブコードを提供します。
ParticipantEndReason 0
通常、値 0 の応答 ParticipantEndReason は、通常の通話のクリアを意味し、エラーなしで完了した通話をマークするものです。
| サブコード | コード | メッセージ | 結果カテゴリ | 通知 |
|---|---|---|---|---|
| 0 | 0 | 通話は、ローカル参加者によって正常に終了されました。 | 成功 | |
| 560000 | 0 | 通常の PSTN 通話の終了: - ユーザーが通話を終了しました。 - 通話はメディア エージェントによって終了されました。 |
成功 | |
| 540000 | 0 | 通常の PSTN 通話の終了: - ユーザーが通話を終了しました。 - 通話はメディア エージェントによって終了されました。 |
成功 |
ParticipantEndReason 4xx
値 4xx の応答 ParticipantEndReason は、通話が接続されなかったことを意味します。
| サブコード | コード | メッセージ | 結果カテゴリ | 通知 |
|---|---|---|---|---|
| 510403 | 403 | 通話がブロックされました: - 通話に代替 ID が指定されていません。 - 電話番号は、ユーザー セッション ボーダー コントローラー (SBC) で許可されていません。 |
- 代替 ID の詳細については、「通話を管理する」を参照してください。 - 有効な代替 ID を指定したことを確認します。 使用しているリソースに属する電話番号である必要があります。 - 通話を行うために使用しているリソースを所有していることを確認します。 - ダイレクト ルーティング通話の場合は、セッション ボーダー コントローラーが通話を許可しない理由を確認します。 |
|
| 560403 | 403 | - 通話は禁止されています。 - 通話が取り消されました。 - 通話が拒否されました。 |
正しい形式で有効な電話番号に通話したことを確認します。 サポートされている数値形式の詳細については、「https://en.wikipedia.org/wiki/E.164」を参照してください。 | |
| 511532 | 403 | リソース SIP トランク構成が見つかりません。 | Azure portal でダイレクト ルーティングのセットアップを確認します。 詳細については、ダイレクト ルーティングのプロビジョニングに関するページを参照してください。 | |
| 560404 | 404 | - 電話番号が見つかりません。 - 電話番号が、どのターゲットにも割り当てられていません。 - 電話番号が、セッション ボーダー コントローラーで許可されていません。 |
- 電話番号が、使用しているリソースに属しており、リソースを所有していることを確認します。 - 通話に使用した番号が存在し、有効なターゲットに割り当てられていることを確認します。 |
|
| 511404 | 404 | - 電話番号が見つかりません。 - 通話で使用されたリソースが見つかりません。 |
- 使用した電話番号が、使用しているリソースに属しており、リソースを所有していることを確認します。 - 通話している番号が存在し、有効なターゲットに割り当てられていることを確認します。 - 通話に使用しているリソースが削除または無効になっていないことを確認します。 - Azure サブスクリプションが削除された、または無効になっていないことを確認します。 |
|
| 560408 | 408 | 通話相手は、指定された時間内に通話確立メッセージに応答しませんでした。 | - 着信側が応答しなかった理由を再確認します。 - ダイレクト ルーティング通話の場合は、セッション ボーダー コントロール (SBC) のログと設定、およびタイムアウトの構成を確認します。 |
|
| 500001 | 408 | ユーザー ゲートウェイのタイムアウト Azure Communication Services は、指定された制限時間内にクライアントから応答を受信せず、要求を終了しました。 |
- 着信側が応答しなかった理由を再確認します。 - ダイレクト ルーティング通話の場合は、SBC のログと設定、およびタイムアウトの構成を確認します。 |
|
| 531004 | 410 | 対話型接続確立 (ICE) チェックに失敗しました。 | - メディア パスを確立できませんでした。 ネットワーク構成が正しくない場合に発生する可能性があります。 ネットワーク構成を確認して、必要な IP アドレスとポートがブロックされていないことを確認します。 https://www.rfc-editor.org/rfc/rfc5245#section-7 のガイドラインをお読みください。 - ダイレクト ルーティング通話の場合は、ICE の構成とプロファイルに関する SBC のログと設定を確認します。 構成のヘルプについては、SBC ベンダーにお問い合わせください。 詳細については、「Azure Communication Services ダイレクト ルーティングの認定を受けたセッション ボーダー コントローラーの一覧」を参照してください。 |
|
| 560480 | 480 | - 通話相手のユーザーから応答がありません。 - 一時的に連絡不可のユーザーに電話しました。 |
- 着信側が応答しなかった理由を再確認します。 - 通話相手が一時的に連絡不可だった場合は、後で通話を再試行します。 - ダイレクト ルーティング通話の場合は、SBC のログと設定、およびタイムアウトの構成を確認します。 |
|
| 560484 | 484 | - 呼び出し先アドレスが不完全または無効です。 - 呼び出し先の番号形式が不完全または無効です。 |
- ユーザーが無効な番号をダイヤルしているために、これらのエラーを無視できる場合があります。 - 電話番号の形式が正しく設定されていることを確認します。 詳細については、https://en.wikipedia.org/wiki/E.164を参照してください。 - ダイレクト ルーティングの場合、通話転送シナリオで構成が見つからないため、SBC によってこれらのエラーが発生する可能性があります。 |
|
| 60486 | 486 | 通話相手の番号が通話中でした | - 通話相手の番号は、既に通話に接続されているか、技術的な問題が発生している可能性があります。 - ダイレクト ルーティング通話の場合は、SBC のログと設定、およびタイムアウトの構成を確認します。 |
|
| 540487 | 487 | 発信者が通話要求を終了しました。 | 通話をもう一度試します。 | |
| 560487 | 497 | - 発信者が通話要求を終了しました。 - 通常の通話のクリアで要求が終了しました。 |
通話をもう一度試します。 |
ParticipantEndReason 5xx
値が 5xx の応答 ParticipantEndReason は、接続を完了するために必要なソフトウェアまたはハードウェア コンポーネントの問題が原因で通話が失敗したことを意味します。
| サブコード | コード | メッセージ | 結果カテゴリ | 通知 |
|---|---|---|---|---|
| 560500 | 500 | 通話に関係するサービスのいずれかで、内部サーバー エラーが発生しました。 | - 通話をもう一度試します。 問題が解決しない場合は、電話会社または Microsoft サポートにお問い合わせください。 - ダイレクト ルーティング通話の場合は、SBC のログと設定、およびタイムアウト構成をチェックして、SBC が障害の原因であるかどうかを確認します。 |
|
| 560503 | 503 | - 通話に関係するサービスの 1 つで内部サーバー エラーが発生したため、通話に失敗しました。 - 通話の確立に使用されるネットワークに障害が発生しています。 - 通話に関係するサービスの 1 つで一時的な障害が発生しました。 |
- ネットワークとルーティングの構成で、考えられる問題を確認します。 ネットワーク ファイアウォール規則が正しいことを確認します。 - 通話をもう一度試します。 問題が解決しない場合は、電話会社または Microsoft サポートにお問い合わせください。 - ダイレクト ルーティング通話の場合は、SBC のログと設定、およびタイムアウト構成をチェックして、SBC が障害の原因であるかどうかを確認します。 |
ParticipantEndReason 603
値が 603 の応答 ParticipantEndReason は、通話が接続せずに拒否されたことを意味します。
| サブコード | コード | メッセージ | 結果カテゴリ | 通知 |
|---|---|---|---|---|
| 560603 | 603 | - 通話は受信者に拒否されました。 - 不正行為が検出されたため、通話が拒否されました。 |
- 通話が受信者によって拒否された場合は、通話をもう一度試します。 - Azure Communication Services の電話番号に対して許可されている同時通話の最大数を超えないことを確認します。 詳細については、「PSTN 通話の制限事項」を参照してください。 |
Chat SDK のエラー コード
チャット SDK では、チャットの問題のトラブルシューティングに役立つ次のエラー コードが使用されます。 エラー コードは、エラー応答の error.code プロパティを通じて公開されます。
| コード | メッセージ | 通知 |
|---|---|---|
| 401 | 権限がありません | Communication Services トークンが有効であり、有効期限が切れていないことを確認します。 |
| 403 | 許可されていません | 要求のイニシエーターがリソースへのアクセス権を持っていることを確認してください。 |
| 429 | Too many requests | クライアント側アプリケーションで、このシナリオがユーザーフレンドリな方法で処理されていることを確認してください。 エラーが解決しない場合は、サポート リクエストを提出してください。 |
| 503 | サービス利用不可 | Azure portal からサポート リクエストを提出します。 |
SMS エラー コード
SMS SDK では、SMS の問題のトラブルシューティングに役立つ次のエラー コードが使用されます。 エラー コードは、SMS 配信レポートの DeliveryStatusDetails フィールドを通じて公開されます。
| コード | メッセージ | 通知 |
|---|---|---|
| 2000 | メッセージが正常に配信されました。 | |
| 4000 | 不正行為の検出によってメッセージが拒否されました。 | 自分の番号に許可されているメッセージの最大数を超えていないことを確認します。 |
| 4001 | 送信元/差出人番号の形式が無効なため、メッセージは拒否されました | 宛先番号が E.164 形式で、差出人番号が E.164 形式またはショート コード形式であることを確認します。 |
| 4002 | 送信先/宛先番号の形式が無効なため、メッセージは拒否されました。 | 宛先番号が E.164 形式であることを確認します |
| 4003 | 送信先がサポートされていないため、メッセージを配信できませんでした。 | 送信先がサポートされているかどうかを確認します。 |
| 4004 | 送信先/宛先番号が存在しないため、メッセージを配信できませんでした。 | 送信先の番号が有効であることを確認します。 |
| 4005 | 送信先の通信事業者によってメッセージがブロックされています。 | |
| 4006 | 送信先/宛先番号に到達できません。 | 後でメッセージを再送信してください。 |
| 4007 | 送信先/宛先番号によってメッセージの受信がオプト アウトされました。 | 宛先/宛先番号をオプト アウトされたものとしてマークすることで、その後のメッセージの試行は行われません。 |
| 4008 | プロファイルで許可されているメッセージの最大数を超えました。 | 自分の数値に許可されているメッセージの最大数を超えていないことを確認するか、キューを使用してメッセージをバッチ処理します。 |
| 4009 | Microsoft エンタイトルメント システムによってメッセージが拒否されました。 | ほとんどの場合、これは不正なアクティビティが検出された場合に発生します。 詳細については、サポートにお問い合わせください。 |
| 4010 | 無料電話番号が検証されていないため、メッセージがブロックされました。 | 未検証の送信制限を確認し、できるだけ早く無料電話番号の検証を送信してください。 |
| 5000 | メッセージを配信できませんでした。 詳細については、Microsoft サポート チームにお問い合わせください。 | Azure portal からサポート リクエストを提出します。 |
| 5001 | アプリケーション/システムが一時的に利用できなくなったため、メッセージを配信できませんでした。 | |
| 5002 | 通信事業者は配信レポートをサポートしていません | ほとんどの場合、これは通信事業者が配信レポートをサポートしていない場合に発生します。 メッセージが既に配信されている可能性があるため、アクションは必要ありません。 |
| 9999 | 不明なエラーが発生したため、メッセージを配信できませんでした。 | メッセージを再送信してみてください。 |