对通话 SDK、通话自动化 SDK、PSTN、聊天 SDK 和短信 SDK 的通话结束响应代码进行故障排除

故障排除提示

进行故障排除时，请考虑以下提示：

• 应用程序未收到 IncomingCall Event Grid 事件：确保在创建事件订阅时应用程序终结点已通过事件网格进行验证。 如果验证成功，事件订阅的预配状态将被标记为成功。
• 对于错误 The field CallbackUri is invalid：通话自动化不支持 HTTP 终结点。 请确保提供的回调 URL 支持 HTTPS。
• PlayAudio 操作不播放任何内容：音频文件目前仅支持 Wave 文件 (.wav) 格式。 Wave 文件中的音频内容必须是单声道、16 位采样，采样率为 16,000 (16 KHz)。
• PSTN 终结点上的操作不起作用：对于针对电话号码执行的 CreateCall、Transfer、AddParticipant 和 Redirect，需要在操作请求中设置 SourceCallerId。 除非使用的是直接路由，否则源调用方 ID 必须是通信服务资源拥有的电话号码，这样操作才能成功。

有关产品小组跟踪的问题的详细信息，请参阅已知问题。

了解呼叫代码和子代码错误

错误代码、子代码和相应的结果类别可帮助开发人员识别和诊断错误。 呼叫结束后，这些错误代码通过 call.callEndReason 属性公开。

错误代码详细信息包括：

代码 - 是表示客户端或服务器响应状态的 3 位整数。 代码类别：

• 成功响应 (200-299)
• 客户端错误 (400-499)
• 服务器错误 (500-599)
• 全局错误 (600-699)

子代码 - 定义为整数，其中每个数字表示特定于一组方案或特定方案结果的唯一原因。

消息 - 描述结果，并提供在结果失败时如何缓解问题的提示。

ResultCategory - 指示错误的类型。 根据上下文，该值可以是 Success、ExpectedError、UnexpectedClientError 或 UnexpectedServerError。

Azure 通信服务呼叫 SDK 客户端错误代码和子代码

对于客户端错误，如果 resultCategories 属性为 ExpectedError，则从 SDK 的角度看，该错误是意料之中的。 此类错误通常在前提条件失败时（例如在应用传递的参数不正确时，或者当前系统状态不允许 API 调用时）遇到。 应用程序应检查错误原因以及调用 API 的逻辑。

了解呼叫代码和子代码错误

错误代码、子代码和相应的结果类别可帮助开发人员识别和诊断错误。 呼叫结束后，这些错误代码通过 call.callEndReason 属性公开。

错误代码详细信息包括：

代码 - 是表示客户端或服务器响应状态的 3 位整数。 代码类别：

• 成功响应 (200-299)
• 客户端错误 (400-499)
• 服务器错误 (500-599)
• 全局错误 (600-699)

子代码 - 定义为整数，其中每个数字表示特定于一组方案或特定方案结果的唯一原因。

消息 - 描述结果，并提供在结果失败时如何缓解问题的提示。

ResultCategory - 指示错误的类型。 根据上下文，该值可以是 Success、ExpectedError、UnexpectedClientError 或 UnexpectedServerError。

呼叫结束通话代码和子代码

呼叫结束的原因有不同的解释。 这些是呼叫结束代码和子代码的含义，显示呼叫如何结束。

了解调用代码和子代码

何时收到错误代码？

调用自动化的错误代码可以作为 API 调用的同步响应或通过提供的回调 URI 进行异步响应。 在同步情况下，如果进行了 API 调用且该调用不被接受，ACS 将提供错误代码，描述 API 调用被拒绝的原因。 在异步情况下，如果发出 API 调用并接受，但仍出错，则同时收到回调事件和错误代码。 调用失败的常见回调事件的示例是每当调用断开连接时显示的 callDisconnected 事件。 收到 callDisconnected 事件后，该给定调用将不再有回调事件。 有关呼叫信号回调事件的列表，请参阅（本页面），有关媒体操作的回调事件列表，请参阅（本页面）。

错误代码语法

错误代码、子代码和相应的结果类别可帮助开发人员识别和诊断错误。 错误代码详细信息包括：

代码 - 是表示客户端或服务器响应状态的 3 位整数。 代码类别：

• 成功响应 (200-299)
• 客户端错误 (400-499)
• 服务器错误 (500-599)
• 全局错误 (600-699)

子代码 - 定义为整数，其中每个数字表示特定于一组方案或特定方案结果的唯一原因。

消息 - 描述结果，并提供在结果失败时如何缓解问题的提示。

除了代码和子代码，还可以在调用日志中找到更详细的故障排除信息。 若要详细了解如何启用和访问通话日志，请参阅本页面以获取详细的指导。

调用自动化 SDK 错误代码

下表包含最常见的代码和子代码。 如果错误不在此表中，请参阅通用代码和子代码，获取有关特定方案的详细信息。

调用自动化错误代码

通用错误代码

2xx 代码

2xx 代码表示成功的响应。 成功响应的子代码将为 0。

4xx 代码

4xx 代码表示客户端错误。

5xx 代码

5xx 代码表示服务器错误。

6xx 代码

6xx 代码表示全局错误。

通用子代码

回调事件中的 SIP 和 Q.850 诊断代码

通话自动化回调事件现在通过已添加到 对象的 SipDetails 和 Q850Details 字段支持低级别诊断数据ResultInformation。
这些诊断信息可呈现来自电信信令层的协议级见解，有助于排查 PSTN 与 SIP/VoIP 场景中的通话掉线、无法到达目标或意外拒绝等问题。

可用性

受影响的事件

以下事件可能会在 SipDiagnosticInfo 中包括 ResultInformation：

• RemoveParticipantsFailed
• AddParticipantsFailed
• CreateCallFailed
• AnswerFailed
• CallDisconnected
• TransferFailed
• CanAddParticipantFailed

实际上，当 SBC/运营商提供这些诊断信息时，任何包含 ResultInformation 的回调事件都可以携带这些信息。

结构

每个诊断信息都表示为一个对象：

这些字段是可选的，仅在 SBC/运营商提供时才显示。

Example

{
  "ResultInformation": {
    "Code": 500,
    "SubCode": 560503,
    "Message": "Unexpected server error",
    "SipDetails": {
      "Code": 486,
      "Message": "Busy Here"
    },
    "Q850Details": {
      "Code": 17,
      "Message": "User busy"
    }
  }
}

包含 ParticipantEndReason 的 PSTN 通话响应代码

本部分提供针对 ParticipantEndReason 和 ParticipantEndSubCode 响应代码的各种组合的故障排除信息。 对于本部分中的表，ParticipantEndReason = 代码和 ParticipantEndSubCode = 子代码。

作为一般准则，如果 ParticipantEndSubCode 值以 560 或 540 开头，则表示用户的 SBC 生成了响应代码。 这可用于排查直接路由调用问题，因为子代码可以帮助确定错误来自 SBC 还是 Microsoft 服务。 以 560 开头的子代码表示出站呼叫，而以 540 开头的子代码表示入站呼叫。 在任一情况下，检查 SBC 日志。

例如，如果 ParticipantEndSubCode 值为 560403，则表示它是出站调用，SBC 生成了最终响应代码，SBC 中的 SIP 响应代码为 403。 通过检查 SBC 日志开始对调用进行故障排除。

对于不以 560 或 540 开头的 ParticipantEndSubCode 响应，最终相应代码则是由 Microsoft 生成的。

ParticipantEndReason 0

响应 ParticipantEndReason 的值为 0 通常表示正常通话清除，会标记完成时无错误的通话。

ParticipantEndReason 4xx

响应 ParticipantEndReason 的值为 4xx 表示通话未接通。

ParticipantEndReason 5xx

响应 ParticipantEndReason 的值为 5xx 表示由于完成连接所需的软件或硬件组件出现问题，导致通话失败。

ParticipantEndReason 603

响应 ParticipantEndReason 的值为 603 表示通话被拒绝，未进行连接。

聊天 SDK 错误代码

聊天 SDK 使用以下错误代码，你可以通过这些错误代码来排查聊天问题。 错误代码通过错误响应中的 error.code 属性公开。

SMS 错误代码

短信 SDK 使用以下错误代码，你可以通过这些错误代码来排查短信问题。 错误代码通过短信发送报告中的 DeliveryStatusDetails 字段公开。