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 | 3112 というサブコードで終わる通話の詳細については、こちらを参照してください。 |
| 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 からサポート リクエストを提出します。 |
通話のコードとサブコードについて
エラー コードが受信されるタイミング
通話自動化のエラー コードは、API 通話に対する同期応答として、または指定されたコールバック URI 経由の非同期応答として着信する可能性があります。 同期状況では、API 通話が行われて受け入れられない場合、API 通話が拒否された理由を説明するエラー コードを ACS が提供します。 非同期シナリオでは、API 通話が行われて受け入れられたが、問題がまだ解決しない場合、コールバック イベントとエラー コードの両方が受信されます。 通話エラーの一般的なコールバック イベントの例としては、通話が切断されるたびに表示される callDisconnected イベントがあります。 callDisconnected イベントが受信されると、その特定の通話に対するコールバック イベントはこれ以上発生しません。 コールバック イベントをシグナル通知する通話の一覧については、(このページ) を参照してください。メディア アクションのコールバック イベントの一覧については、(このページ) を参照してください。
エラー コードの構文
エラー コード、サブコード、および対応する結果カテゴリは、開発者がエラーを特定して診断するのに役立ちます。 エラー コードの詳細は次のとおりです。
コード - クライアントまたはサーバーの応答状態を表す 3 桁の整数です。 コード カテゴリ:
- 成功応答 (200 - 299)
- クライアント エラー (400 - 499)
- サーバー エラー (500 - 599)
- グローバル エラー (600-699)
Subcode: 整数として定義されており、各値はシナリオのグループまたは特定のシナリオの結果に固有の一意の理由を示します。
メッセージ: 結果について説明し、結果が失敗の場合は問題を軽減する方法のヒントを提供します。
コードとサブコードに加えて、より詳細なトラブルシューティング情報が通話ログにあります。 通話ログを有効にしてアクセスする方法の詳細については、このページで詳細なガイダンスを参照してください。
Call Automation SDK のエラー コード
次の表に、最も一般的なコードとサブコードを示します。 エラーがこの表にない場合は、汎用のコードとサブコードを参照して、特定のシナリオに関する詳細情報を取得してください。
通話自動化の最も一般的なエラー コード
| コード | サブコード | 説明 | 対応策 |
|---|---|---|---|
| 404 | 8522 | リソースが見つからないことを示す汎用エラー コード。 リソースには、通話と参加者が含まれる可能性があります。 | 通話状態を再確認: 通話が既に終了しているか、参加者が通話を終了している可能性があります。 |
| 400 | 8523 | 要求本文内の何かが無効であることを示す汎用エラー コード。 | すべてのパラメーターを調べて、有効であることを確認します。 エラー メッセージを参照して、エラーをスローしているパラメーターを確認します。 |
| 400 | 8501 | アクションがサポートされない: 通話が確立されていません | 通話がアクティブでない間に、エラー メッセージに関連付けられているアクションがアクティブ化されました。 通話が切断された後に、新しい通話アクションが開始されないようにします。 このエラーは、通話が切断された時間に近い場合、通話がアクティブな間に呼び出されたアクションによっても発生する可能性があります。 |
| 400 | 8500 | メディア ファイルが無効です | メディア操作の状態を確認して、いずれかの操作が既にアクティブになっているか、ターゲット参加者が既にメディア操作に参加しているかを確認します。 アクティブなメディア操作がある場合は、操作が完了するまで待ってから再試行します。 |
| 400 | 8559 | アクションがサポートされない: 許可されるダイヤルアウト アプリは 1 つのみです | レコーディング開始要求が重複しているか、既に開始済みであるか、進行中です。 新しいレコーディング通話の開始を送信する前に、レコーディング状態を再確認して非アクティブであることを確認します。 |
| 400 | 8528 | アクションがサポートされない: 通話が終了されました | 通話が終了されている間に、エラー メッセージに関連付けられているアクションがアクティブ化されました。 通話が切断された後に、新しい通話アクションが開始されないようにします。 このエラーは、通話が終了された時間に近い場合、通話がアクティブな間に呼び出されたアクションによっても発生する可能性があります。 |
| 409 | 8519 | 競合 | 同じリソースに対して複数のアクションが並列で実行されていないことを確認します。 競合している 2 つのアクションを特定するには、エラー メッセージを参照してください。 |
| 403 | 7507 | 呼び出し元 ID が無効です | 認証トークンからのアプリケーション ID が、呼び出し元のアプリケーション ID と一致しませんでした。 着信 Webhook が構成された ACS リソースの接続文字列を使用していることを確認します (電話番号は、呼び出しに応答する同じ ACS リソースによって所有されている必要があります)。 |
| 403 | 7504 | アプリケーションのアクセス許可が不足しています | 不十分なアクセス許可の汎用コード。アクセス許可が不足しているリソースについて、エラー メッセージでコンテキストを確認してください。 |
| 400 | 8585 | 現在の通話状態ではアクションは無効です | 通話が確立されていないか、切断されている: メディア アクションを再試行する前に、通話が確立されるまで待ちます。 |
| 405 | 8520 | 現時点では機能がサポートされていません | 予期されるエラー: ワークフローは現在サポートされていません。 これらの機能を有効にするように更新された SDK があるかどうかを確認するには、リリース ブログを参照してください。 サポートされていないワークフローの一覧については、通話自動化の既知の制限事項に関する記事を参照してください。 |
| 412 | 8583 | Precondition Failed | 互換性のないメディア アクションを一覧表示しているこのページを参照して、互換性のないアクションの実行やキュー登録をしていないことを確認します。 |
| 400 | 8567 | ACS リソースのサービス プリンシパルが有効になっていません | Azure Cognitive Service リソースが正しく構成されていません。 Azure Cognitive Service リソースの設定に関するガイドについては、このページを参照してください。 |
| 405 | 8522 | Missing configuration (構成の欠落) | 構成を確立する必要があるその他のコンテキストについては、エラー メッセージを確認してください。 この構成は、AnswerCall API を呼び出すときに行う必要があります。 |
汎用エラー コード
2xx コード
2xx コードは、成功した応答を表します。 成功した応答のサブコードは 0 になります。
4xx コード
4xx コードは、クライアント エラーを表します。
| 状態コード | 説明 |
|---|---|
| 400 | Bad request |
| 401 | 権限がありません |
| 403 | 許可されていません |
| 404 | 見つかりません |
| 405 | Method not allowed |
| 406 | 受け入れ不可です |
| 408 | タイムアウト |
| 409 | Conflict |
| 412 | Precondition failed |
| 413 | 要求のエンティティが大きすぎます |
| 426 | アップグレードが必要です |
| 429 | Too many requests |
| 481 | トランザクションが存在しません |
| 487 | 取り消し済み |
5xx コード
5xx コードは、サーバー エラーを表します。
| 状態コード | 説明 |
|---|---|
| 500 | 内部サーバー エラー |
| 501 | 実装されていません |
| 502 | Bad gateway |
| 503 | サービス利用不可 |
| 504 | ゲートウェイのタイムアウト |
6xx コード
6xx コードは、グローバル エラーを表します。
| 状態コード | 説明 |
|---|---|
| 603 | 却下済み |
汎用サブコード
| サブコード | 説明 |
|---|---|
| 0 | 成功 |
| 7000 | グレースフル |
| 7500 | AAD ID がサポートされていません |
| 7501 | 無効なトークン |
| 7502 | アクセスが有効になっていません |
| 7504 | アプリケーションのアクセス許可が不足しています |
| 7505 | エンタープライズ テナントが一致しません |
| 7506 | 証明書が信頼されていません |
| 7507 | 通話元 ID が無効です |
| 7508 | ACS ID がサポートされていません |
| 7509 | HMAC 検証エラー |
| 7510 | マネージド ID 検証エラー |
| 7600 | リソース アクセスが有効になっていません |
| 7601 | ACS ソース ID が無効です |
| 7602 | ACS ターゲット ID が無効です |
| 7603 | ACS ID が無効です |
| 7604 | Teams 相互運用シナリオが承認されていません |
| 7605 | Teams レコーディング相互運用シナリオが承認されていません |
| 7606 | Cognitive Actions 用の ACS リソースが承認されていません |
| 8500 | メディア ファイルが無効です |
| 8501 | 通話が確立されていません |
| 8502 | 参加者 ID が利用できません |
| 8503 | 通話のメディア状態: オーディオが非アクティブです |
| 8504 | メディア ストリームを使用できません |
| 8505 | 複数の参加者 (重複あり) |
| 8506 | コンプライアンス違反のレコーディング通話です |
| 8508 | 操作は取り消されました |
| 8509 | 最大無音タイムアウトに達しました |
| 8510 | 初期無音タイムアウトに達しました |
| 8511 | 再生プロンプトが失敗しました |
| 8512 | ビープ音の再生に失敗しました |
| 8513 | メディア受信がタイムアウトになりました |
| 8514 | 停止トーンが検出されました |
| 8515 | 最大記録期間に達しました |
| 8516 | 通話が調整されました |
| 8517 | 通話テナント ID が一致しません |
| 8518 | 通話例外 |
| 8519 | 競合 |
| 8520 | Not Implemented |
| 8521 | ホップが多すぎます |
| 8522 | Not Found |
| 8523 | 引数が無効です |
| 8524 | コンプライアンス レコーディングの参加者数が無効です |
| 8525 | 非記録パーティー |
| 8526 | 参加トークンが無効です |
| 8527 | 参加 URL が無効です |
| 8528 | 通話が終了しました |
| 8529 | 調整された通話の月次制限に達しました |
| 8530 | 調整された通話のアクティブな通話制限に達しました |
| 8531 | 最大桁数を受信しました |
| 8532 | 桁間タイムアウトに達しました |
| 8533 | Dtmf オプションが一致しました |
| 8534 | 正しくないトーンが入力されました |
| 8535 | ファイル形式が無効です |
| 8536 | ファイルのダウンロードに失敗しました |
| 8537 | キープ アライブ タイムアウトに達しました |
| 8538 | 呼び出し先が拒否しました |
| 8539 | 呼び出し先が通話中です |
| 8,540 | すべての呼び出し先が通話中です |
| 8541 | 呼び出し先を使用できません |
| 8542 | 通話が取り消されました |
| 8543 | 通話が存在しません |
| 8544 | 呼び出し先に到達できません |
| 8545 | 音声オプションが一致しました |
| 8546 | 呼び出し先が無効な要求を送信しました |
| 8547 | 音声オプションが一致しませんでした |
| 8548 | 通話がグループ通話ではありません |
| 8549 | 会話の作成の再ターゲットに失敗しました |
| 8550 | メディア ネゴシエーションの再ターゲットに失敗しました |
| 8551 | 再ターゲットはサポートされていません |
| 8552 | 開催者は削除できません |
| 8553 | レコーディングが重複しています |
| 8554 | 会議外の参加者の音声が混線しています |
| 8555 | 再ターゲットは既に進行中です |
| 8556 | CR 通話ではアクションがサポートされません |
| 8557 | 形式の種類が正しくありません |
| 8558 | 参加者が存在しません |
| 8559 | 単一ダイヤルアウトが重複しています |
| 8560 | 会議がロックされているために会話への参加がブロックされました |
| 8561 | 会議への参加 ID が無効です |
| 8562 | レコーディング モードがサポートされていません |
| 8563 | 音声が認識されません |
| 8564 | 音声サービスの接続エラー |
| 8565 | Cognitive Services エラー |
| 8566 | ミュート解除操作は許可されていません |
| 8567 | ACS リソースのサービス プリンシパルが有効になっていません |
| 8568 | Cognitive Service のマネージド ID 要求が失敗しました |
| 8571 | レコーディング操作が競合しています |
| 8569 | 音声が認識されました |
| 8570 | Cognitive Services の音声認識エラー |
| 8572 | 再生サービスのシャットダウン |
| 8573 | Resume メソッドの一時停止は許可されていません |
| 8578 | 文字起こしに失敗しました |
| 8579 | 文字起こしが取り消されました |
| 8580 | 文字起こしサービスのシャットダウン |
| 8581 | ストリーム URL が無効です |
| 8582 | 再生ソース テキストまたは SSML が空です |
| 8583 | Precondition Failed |
| 8585 | 現在の通話状態ではアクションは無効です |
| 8586 | 着信がボットによって受信確認されません |
| 8587 | 着信が時間内に応答されません |
| 8588 | 記録が完了し、メディアがタイムアウトを受信しました |
| 8589 | 記録が調整されました |
| 8594 | 会議の状態の更新に失敗しました |
| 8603 | メディア ストリーミングに失敗しました |
| 8604 | メディア ストリーミングが取り消されました |
| 8605 | 文字起こしのカスタム音声モデルはサポートされません |
| 8,606 | 通信識別子の作成に失敗しました |
| 8607 | 転送操作が競合しています |
| 8608 | 参加者クライアント エラーを記録しています |
| 8609 | ボットからの参加応答が無効です |
| 8610 | 通知時にボットからの応答がありません |
| 8613 | 調整された通話のライブ キャプションの制限に達しました |
| 9001 | 基になるサービスからの不明なエラー |
| 9002 | 基になるサービスからのタイムアウト エラー |
| 9003 | 操作が取り消されたエラー |
| 9998 | 致命的なエラー |
| 9999 | Unknown |
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 | 不明なエラーが発生したため、メッセージを配信できませんでした。 | メッセージを再送信してみてください。 |