Solução de problemas com códigos de resposta de término de chamadas para SDK de Chamada, SDK de Automação de Chamadas, PSTN, SDK de Chat e SDK de SMS

Dicas de solução de problemas

Considere as seguintes dicas ao solucionar problemas:

• Seu aplicativo não está recebendo um evento IncomingCall Event Grid: verifique se o ponto de extremidade do aplicativo é validado com a Grade de Eventos ao criar uma assinatura de evento. O status de provisionamento da sua assinatura de evento será marcado como bem-sucedido se a validação for bem-sucedida.
• Por erro The field CallbackUri is invalid: a Automação de Chamadas não dá suporte a pontos de extremidade HTTP. Verifique se a URL de retorno de chamada fornecida dá suporte a HTTPS.
• A ação PlayAudio não reproduz tudo: atualmente, somente o formato Wave file (.wav) tem suporte para arquivos de áudio. O conteúdo de áudio no arquivo wave deve ser mono (canal único), amostras de 16 bits com uma taxa de amostragem de 16.000 (16 KHz).
• As ações em pontos de extremidade PSTN não estão funcionando: para CreateCall, Transfer, AddParticipant e Redirect para números de telefone, defina a SourceCallerId na solicitação na ação. A menos que você esteja usando o roteamento direto, a identificação de chamadas de origem deve ser um número de telefone pertencente ao recurso dos Serviços de Comunicação para que a ação seja bem-sucedida.

Para obter mais informações sobre os problemas acompanhados pela equipe de produtos, consulte Problemas conhecidos.

Noções básicas sobre códigos de chamada e erros de subcódigos

Códigos de erro, subcódigos e categorias de resultados correspondentes ajudam os desenvolvedores a identificar e diagnosticar erros. Esses códigos de erro são expostos por meio da propriedade call.callEndReason depois que uma chamada é encerrada.

Os detalhes do código de erro incluem:

Código: são inteiros de 3 dígitos que representam o status de resposta do cliente ou do servidor. As categorias de código:

• Respostas bem-sucedidas (200-299)
• Erro do cliente (400-499)
• Erro do servidor (500-599)
• Erro global (600-699)

Subcódigo: é definido como um inteiro, em que cada número indica um motivo exclusivo, específico para um grupo de cenários ou um resultado de cenário específico.

Mensagem: descreve o resultado e fornece dicas de como atenuar o problema se um resultado for uma falha.

ResultCategory – indica o tipo do erro. Dependendo do contexto, o valor pode ser Success, ExpectedError, UnexpectedClientError ou UnexpectedServerError.

Códigos de erro e subcódigos do cliente do SDK de chamada dos Serviços de Comunicação do Azure

Para erros do cliente, se a propriedade resultCategories for ExpectedError, o erro será esperado da perspectiva do SDK. Esses erros são comumente encontrados em falhas de pré-condição, como argumentos incorretos passados pelo aplicativo ou quando o estado atual do sistema não permite a chamada de API. A aplicação deve verificar o motivo do erro e a lógica para invocar a API.

Noções básicas sobre códigos de chamada e erros de subcódigos

Códigos de erro, subcódigos e categorias de resultados correspondentes ajudam os desenvolvedores a identificar e diagnosticar erros. Esses códigos de erro são expostos por meio da propriedade call.callEndReason depois que uma chamada é encerrada.

Os detalhes do código de erro incluem:

Código: são inteiros de 3 dígitos que representam o status de resposta do cliente ou do servidor. As categorias de código:

• Respostas bem-sucedidas (200-299)
• Erro do cliente (400-499)
• Erro do servidor (500-599)
• Erro global (600-699)

Subcódigo: é definido como um inteiro, em que cada número indica um motivo exclusivo, específico para um grupo de cenários ou um resultado de cenário específico.

Mensagem: descreve o resultado e fornece dicas de como atenuar o problema se um resultado for uma falha.

ResultCategory – indica o tipo do erro. Dependendo do contexto, o valor pode ser Success, ExpectedError, UnexpectedClientError ou UnexpectedServerError.

Códigos e subcódigos de fim de chamada

Há explicações diferentes sobre os motivos para uma chamada terminar. Aqui estão os significados dos códigos e subcódigos de fim de chamada que mostram como uma chamada pode terminar.

Noções básicas sobre códigos de chamada e subcódigos

Quando os códigos de erro são recebidos?

Os códigos de erro para a Automação de Chamadas podem vir como respostas síncronas a chamadas à API ou respostas assíncronas por meio do URI de retorno de chamada fornecido. Na situação síncrona, se uma chamada à API for feita e não for aceita, o ACS fornecerá um código de erro que descreve por que a chamada à API foi rejeitada. Em cenários assíncronos, se uma chamada à API for feita e aceita, mas algo ainda der errado, um evento de retorno de chamada e um código de erro serão recebidos. Um exemplo de um evento de retorno de chamada comum para falhas de chamada seria o evento callDisconnected que é exibido sempre que uma chamada é desconectada. Após receber o evento callDisconnected, não haverá mais eventos de retorno de chamada para essa chamada fornecida. Para obter uma lista de eventos de retorno de chamada de sinalização de chamada, consulte (esta página) e para obter uma lista de eventos de retorno de chamada para ações de mídia, consulte (esta página).

Sintaxe de código de erro

Códigos de erro, subcódigos e categorias de resultados correspondentes ajudam os desenvolvedores a identificar e diagnosticar erros. Os detalhes do código de erro incluem:

Código: são inteiros de 3 dígitos que representam o status de resposta do cliente ou do servidor. As categorias de código:

• Respostas bem-sucedidas (200-299)
• Erro do cliente (400-499)
• Erro do servidor (500-599)
• Erro global (600-699)

Subcódigo: é definido como um inteiro, em que cada número indica um motivo exclusivo, específico para um grupo de cenários ou um resultado de cenário específico.

Mensagem: descreve o resultado e fornece dicas de como atenuar o problema se um resultado for uma falha.

Além do código e do subcódigo, informações mais detalhadas de solução de problemas podem ser encontradas nos logs de chamadas. Para saber mais sobre como habilitar e acessar logs de chamadas, consulte esta página para obter diretrizes detalhadas.

Códigos de erro do SDK de Automação de Chamadas

A tabela a seguir contém os códigos e subcódigos mais comuns. Se o erro não estiver nesta tabela, consulte os códigos genéricos e os subcódigos para obter mais informações sobre seu cenário específico.

Códigos de erro de Automação de Chamadas

Códigos de erro genéricos

Códigos 2xx

Um código 2xx representa uma resposta bem-sucedida. O subcódigo para respostas bem-sucedidas será 0.

Códigos 4xx

Um código 4xx representa um erro do cliente.

Códigos 5xx

Um código 5xx representa um erro de servidor.

Códigos 6xx

Um código 6xx representa um erro global.

Subcódigos genéricos

Códigos de diagnóstico SIP e Q.850 nos eventos de retorno de chamada

Agora, os eventos de retorno de chamada da Automação de Chamadas dão suporte aos dados de diagnóstico de baixo nível pelos campos SipDetails e Q850Details, adicionados ao objeto ResultInformation existente.
Esses insights no nível do protocolo de superfície de diagnóstico da camada de sinalização de telecomunicações, ajudando a solucionar problemas como quedas de chamadas, destinos inacessíveis ou rejeições inesperadas nos cenários PSTN e SIP/VoIP.

Disponibilidade

Eventos afetados

Os seguintes eventos podem incluir SipDiagnosticInfo nos seus ResultInformation:

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

Na prática, qualquer evento de retorno de chamada que contenha ResultInformation pode levar esses diagnósticos quando fornecidos pelo SBC/operadora.

Estrutura

Cada diagnóstico é representado como um objeto:

Esses campos são opcionais e aparecem somente quando fornecidos pelo SBC/operadora.

Example

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

Códigos de resposta de chamada PSTN com ParticipantEndReason

Esta seção fornece informações de solução de problemas para várias combinações de códigos de resposta ParticipantEndReason e ParticipantEndSubCode. Para as tabelas nesta seção, ParticipantEndReason = Código e ParticipantEndSubCode = SubCódigo.

Como diretriz geral, se o ParticipantEndSubCode valor começa com 560 ou 540, indica que o SBC do usuário/operador gerou o código de resposta. Isso é útil para solucionar problemas de chamadas de Roteamento Direto, pois o subcódigo pode ajudar a determinar se o erro é do seu SBC ou do serviço da Microsoft. Um subcodificado começando com 560 representa uma chamada de saída, enquanto um subcodificado começando com 540 representa uma chamada de entrada. Em ambos os casos, verifique os logs SBC.

Por exemplo, se o valor ParticipantEndSubCode for 560403, significa que foi uma chamada de saída, o SBC gerou o código de resposta final e o código de resposta SIP do SBC foi 403. Inicie a solução de problemas das chamadas verificando seus logs SBC.

Para ParticipantEndSubCode respostas que não começam com 560 ou 540, o serviço da Microsoft gerou o código de resposta final.

ParticipantEndReason 0

A resposta ParticipantEndReason com o valor 0 geralmente significa limpeza normal de chamadas e marca chamadas que foram concluídas sem erros.

ParticipantEndReason 4xx

A resposta ParticipantEndReason com o valor 4xx significa que a chamada não se conectou.

ParticipantEndReason 5xx

A resposta ParticipantEndReason com o valor 5xx significa que a chamada falhou devido a um problema com um componente de software ou hardware necessário para concluir a conexão.

ParticipantEndReason 603

A resposta ParticipantEndReason com o valor 603 significa que a chamada foi rejeitada sem conexão.

Chat de códigos de erro do SDK

O SDK de Chat usa os seguintes códigos de erro para ajudar você a solucionar problemas de chat. Os códigos de erro são expostos por meio da propriedade error.code na resposta de erro.

Códigos de erro de SMS

O SDK de SMS usa os seguintes códigos de erro para ajudar você a solucionar problemas de SMS. Os códigos de erro são expostos por meio do campo DeliveryStatusDetails no relatório de entrega de SMS.