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
Este artigo descreve a solução de problemas de códigos de resposta de término de chamada para SDK de Chamada, Automação de Chamadas e Chamada PSTN.
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
eRedirect
para números de telefone, defina aSourceCallerId
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.
Observação
As Categorias de Mensagens e Resultados listados nas tabelas a seguir estão em versão prévia pública. Para obter mais informações, consulte Termos de Uso Complementares de Versões Prévias do Microsoft Azure.
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 de cliente do SDK de Chamada dos Serviços de Comunicação do Azure
Para erros de 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.
Subcódigo | Código | Mensagem | Categoria de resultado | Advice |
---|---|---|---|---|
40101 | 408 | Falha ao criar CallAgent. Tente novamente. Se o problema persistir, colete os logs de console do navegador, o arquivo .HAR e entre em contato com o suporte dos Serviços de Comunicação do Azure. |
UnexpectedClientError | |
40104 | 408 | Falha ao criar CallAgent. Tente novamente. Se o problema persistir, colete os logs de console do navegador, o arquivo .HAR e entre em contato com o suporte dos Serviços de Comunicação do Azure. |
UnexpectedClientError | |
40114 | 408 | Falha ao conectar-se à infraestrutura dos Serviços de Comunicação do Azure. Tente novamente e verifique as solicitações de rede do navegador. Se os pedidos continuarem a falhar, reúna os registos do console do navegador, o arquivo .HAR e contate o suporte dos Serviços de Comunicação do Azure. |
UnexpectedClientError | Para obter mais informações, consulte requisitos de rede. |
40115 | 412 | Falha ao criar o CallAgent, não foi possível inicializar a conexão com a infraestrutura dos Serviços de Comunicação do Azure. Tente novamente e verifique as solicitações de rede do navegador. Se os pedidos continuarem a falhar, reúna os registos do console do navegador, o arquivo .HAR e contate o suporte dos Serviços de Comunicação do Azure. |
UnexpectedClientError | Para obter mais informações, consulte requisitos de rede. |
40216 | 500 | Falha ao criar CallAgent. Tente novamente. Se o problema persistir, colete os logs do console do navegador e entre em contato com o suporte dos Serviços de Comunicação do Azure. | UnexpectedClientError | |
40228 | 409 | Falha ao criar CallAgent, já existe uma instância de CallAgent associada a esta identidade. Descarte o CallAgent existente ou crie um novo com uma identidade diferente. | ExpectedError | |
40230 | 409 | Falha ao criar TeamsCallAgent, já existe uma instância de TeamsCallAgent associada a esta identidade. Descarte o TeamsCallAgent existente antes de criar um novo. | ExpectedError | |
40606 | 405 | Falha ao enumerar alto-falantes, não há suporte para enumerar/selecionar alto-falantes no Android Chrome, no iOS Safari nem no macOS Safari. | ExpectedError | Não há suporte para enumeração/seleção do locutor no Android Chrome, no iOS Safari nem no macOS Safari. O sistema operacional seleciona automaticamente o viva-voz (dispositivo de saída). Saiba mais sobre gerenciamento de dispositivos e como mitigar melhor esses problemas. |
40613 | 400 | Falha ao obter permissão para uso do microfone e/ou câmera, foi negada ou falhou. Certifique-se de conceder as permissões nas configurações do navegador e do sistema operacional. | ExpectedError | Saiba mais sobre como lidar melhor com as permissões do dispositivo. |
40614 | 500 | Falha ao solicitar permissões do dispositivo. Certifique-se de conceder as permissões nas configurações do navegador e do sistema operacional e tente novamente. Se o problema persistir, reúna os registos da consola do navegador e contacte o suporte dos Serviços de Comunicação do Azure. | UnexpectedClientError | Saiba mais sobre como lidar melhor com as permissões do dispositivo. |
41006 | 400 | Falha ao aceitar a chamada recebida, ela não está no estado Tocando. Assine o evento incomingCall do CallAgent para aceitar a chamada recebida. |
ExpectedError | Consulte os artigos a seguir para identificar a causa raiz do problema - Receber uma chamada - Assine eventos do SDK |
41007 | 400 | Falha ao rejeitar a chamada recebida, ela não está no estado Tocando. Assine o evento incomingCall do CallAgent para rejeitar a chamada recebida. |
ExpectedError | Consulte os artigos a seguir para identificar a causa raiz do problema - Receber uma chamada - Assine eventos do SDK |
41015 | 500 | Falha ao silenciar o microfone. Tente novamente. Se o problema persistir, colete os logs do console do navegador e entre em contato com suporte dos Serviços de Comunicação do Azure. | UnexpectedClientError | |
41016 | 400 | Falha ao ativar o microfone. Tente novamente. Se o problema persistir, colete os logs do console do navegador e entre em contato com suporte dos Serviços de Comunicação do Azure. | UnexpectedClientError | |
41025 | 400 | Falha ao iniciar o vídeo, a instância LocalVideoStream é inválida ou está vazia. Passe em uma instância LocalVideoStream. | ExpectedError | Certifique-se de que o objeto passado para iniciar o vídeo seja uma instância de LocalVideoStream. Construa um LocalVideoStream usando um objeto VideoDeviceInfo ou um objeto MediaStream . Consulte os seguintes artigos para identificar a causa raiz do problema: - Faça uma chamada com câmera de vídeo - Inicie e pare de enviar vídeo local durante uma chamada - Acesse o vídeo bruto |
41027 | 400 | Falha ao iniciar o vídeo, o vídeo já foi iniciado. | ExpectedError | Links úteis: - Faça uma chamada com câmera de vídeo - Inicie e pare de enviar vídeo local durante uma chamada |
41030 | 400 | Falha ao parar o vídeo, o vídeo já está parado. | ExpectedError | Links úteis: - Faça uma chamada com câmera de vídeo - Inicie e pare de enviar vídeo local durante uma chamada |
41032 | 400 | Falha ao interromper o vídeo. Argumento inválido. LocalVideoStream usado como entrada não está sendo enviado no momento. | ExpectedError | O LocalVideoStream que está sendo enviado na chamada é armazenado na matriz Call.localVideoStreams[] e é do tipo Video ou RawMedia . Consulte os seguintes artigos para identificar a causa raiz do problema: - Faça uma chamada com câmera de vídeo - Inicie e pare de enviar vídeo local durante uma chamada - Acesse o vídeo bruto |
41033 | 500 | Falha ao reter a chamada. Tente novamente. Se o problema persistir, colete os logs do console do navegador e entre em contato com suporte dos Serviços de Comunicação do Azure. | UnexpectedClientError | |
41034 | 500 | Falha ao retomar a chamada. Tente novamente. Se o problema persistir, colete os logs do console do navegador e entre em contato com suporte dos Serviços de Comunicação do Azure. | UnexpectedClientError | |
41035 | 400 | Falha ao iniciar o compartilhamento de tela, o compartilhamento de tela já foi iniciado. | ExpectedError | Saiba mais sobre como iniciar e interromper o compartilhamento de tela durante uma chamada |
41041 | 400 | Falha ao interromper o compartilhamento de tela. O compartilhamento de tela já foi interrompido. | ExpectedError | Saiba mais sobre como iniciar e interromper o compartilhamento de tela durante uma chamada |
41048 | 410 | Falha ao iniciar o vídeo durante o processo de configuração da chamada. Certifique-se de conceder permissões de vídeo nas configurações do navegador e do sistema operacional. Verifique se o dispositivo da câmera não está sendo usado por outro processo. | UnexpectedClientError | – O dispositivo da câmera pode estar desabilitado no sistema. – A câmera está sendo usada por outro processo. |
41056 | 412 | Falha ao iniciar ou ingressar na chamada, a política de voz do Teams Enterprise não está habilitada para este recurso dos Serviços de Comunicação do Azure. Siga o tutorial online para habilitá-lo. | ExpectedError | Veja em como habilitar usuários do Enterprise Voice online e do correio de voz do sistema telefônico para habilitar a política de voz do Teams Enterprise |
41071 | 412 | Falha ao iniciar o compartilhamento de tela. A chamada não está no estado Conectado. Assine o evento statteChanged da chamada para saber quando a chamada for conectada. |
ExpectedError | Links úteis: - Verifique as propriedades da chamada - Assine eventos do SDK |
41073 | 412 | Falha ao obter ou definir MediaStream personalizado, essa funcionalidade está atualmente desabilitada pelos Serviços de Comunicação do Azure. | ExpectedError | |
43000 | 412 | Falha ao iniciar o vídeo, o dispositivo de vídeo está sendo usado por outro processo/aplicativo. Impeça que sua câmera seja usada em outro processo/aplicativo e tente novamente. | ExpectedError | Entenda mais sobre como lidar melhor com uma câmera sendo usada por outro processo |
43001 | 403 | Falha ao iniciar o vídeo. Não foi concedida permissão para usar o dispositivo de vídeo selecionado. Certifique-se de que as permissões do dispositivo de vídeo sejam permitidas nas configurações do navegador e nas configurações do sistema. | ExpectedError | Certifique-se de que as permissões da câmera sejam permitidas nas configurações do navegador e nas configurações do sistema do dispositivo. Certifique-se de que as câmeras não estejam desabilitadas nas configurações do sistema do dispositivo. No macOS, certifique-se de que a gravação de tela seja permitida nas configurações do sistema. Links úteis: - Solicitar permissões do dispositivo- Permissões de compartilhamento de tela no macOS - Enumerando ou acessando dispositivos para Safari no macOS e iOS |
43002 | 500 | Falha ao iniciar o vídeo, erro desconhecido. Tente novamente. Se o problema persistir, contacte o suporte dos Serviços de Comunicação do Azure. | UnexpectedClientError | |
43004 | 400 | Falha ao trocar o dispositivo de vídeo, entrada inválida. A entrada deve ser do tipo VideoDeviceInfo. | ExpectedError | Use o gerenciador de dispositivos para obter uma lista de objetos VideoDeviceInfo e, em seguida, use o objeto VideoDeviceInfo para alternar a fonte. Saiba mais em como iniciar e parar de enviar vídeo local durante uma chamada |
43005 | 400 | Falha ao mudar de dispositivo de vídeo, não é possível mudar para o mesmo dispositivo de vídeo, ele já está selecionado. | ExpectedError | |
43013 | 412 | Falha ao iniciar o vídeo, nenhum dispositivo de vídeo encontrado. Certifique-se de que os dispositivos de vídeo estejam conectados e habilitados nas configurações do sistema. | ExpectedError | Certifique-se de ter uma câmera conectada e instalada no seu dispositivo. |
43014 | 412 | Falha ao iniciar o vídeo, erro ao solicitar fluxo de mídia. Tente novamente. Se o problema persistir, entre em contato com o suporte dos Serviços de Comunicação do Azure. | UnexpectedClientError | |
43015 | 412 | Falha ao iniciar o vídeo, a solicitação de fluxo de mídia expirou. Conceda permissão no prompt do navegador para acessar a câmera e tente novamente. | ExpectedError | Esse erro pode ocorrer se o usuário não executar nenhuma ação no prompt de permissão do navegador para permitir o acesso à câmera. |
43016 | 412 | Falha ao iniciar o vídeo, permissões negadas pelo sistema. Certifique-se de que as permissões do dispositivo de vídeo sejam permitidas nas configurações do navegador e nas configurações do sistema. | ExpectedError | – Certifique-se de que as permissões da câmera sejam permitidas nas configurações do navegador e nas configurações do sistema do dispositivo. – Certifique-se de que as câmeras não estejam desabilitadas nas configurações do sistema do dispositivo. – No macOS, certifique-se de que a gravação de tela seja permitida nas configurações do sistema. Links úteis: - Solicitar permissões do dispositivo -Permissões de compartilhamento de tela no macOS - Enumerando ou acessando dispositivos para Safari no macOS e iOS |
43017 | 412 | Falha ao iniciar o vídeo, transmissão não suportada. Tente novamente. Se o problema persistir, entre em contato com o suporte dos Serviços de Comunicação do Azure. | UnexpectedClientError | |
43018 | 412 | Falha ao iniciar o vídeo, falha ao definir restrições. Tente novamente. Se o problema persistir, entre em contato com o suporte dos Serviços de Comunicação do Azure. | UnexpectedClientError | Saiba mais sobre como definir restrições de vídeo |
43019 | 412 | Falha ao iniciar o vídeo, nenhum dispositivo selecionado. Certifique-se de passar um LocalVideoStream construído com um VideoDeviceInfo e tente novamente. Se o problema persistir, contacte o suporte dos Serviços de Comunicação do Azure. | UnexpectedClientError | Links úteis: - Faça uma chamada com câmera de vídeo - Inicie e pare de enviar vídeo local durante uma chamada |
43200 | 412 | Falha ao renderizar o stream de vídeo. Esse stream não está disponível. Assine a propriedade isAvailable do stream para ser notificado quando o participante remoto estiver com o vídeo ligado e o stream estiver disponível para renderização. | ExpectedError | Links úteis: - Renderizar fluxos de vídeo/compartilhamento de tela de participantes remotos - Adicione videochamadas 1:1 ao seu aplicativo - Assine eventos do SDK |
43202 | 404 | Falha ao renderizar o stream de vídeo. Esse stream não está mais disponível. O participante remoto desligou o vídeo. | ExpectedError | O participante remoto desligou o vídeo ao tentar criar uma visualização para ele. |
43203 | 408 | Falha ao renderizar o stream de vídeo. A renderização expirou enquanto aguardava os quadros de vídeo. Tente novamente. Se o problema persistir, entre em contato com o suporte dos Serviços de Comunicação do Azure. | UnexpectedClientError | |
43204 | 500 | Falha ao renderizar o stream de vídeo, falha ao assinar o vídeo na infraestrutura dos Serviços de Comunicação do Azure. Tente novamente. Se o problema persistir, entre em contato com o suporte dos Serviços de Comunicação do Azure. | UnexpectedClientError | |
43209 | 405 | Falha ao renderizar o stream de vídeo, o VideoStreamRenderer foi descartado durante o processo de inicialização. | ExpectedError | |
43210 | 400 | Falha ao descartar o VideoStreamRenderer, porque ele já foi descartado. | ExpectedError | |
43220 | 400 | Falha ao criar o modo de exibição, número máximo de exibições ativas RemoteVideoStream já alcançadas. Você pode descartar um anterior para criar um novo. |
ExpectedError | Saiba mais sobre como oferecer suporte adequado ao melhor número de fluxos de vídeo recebidos |
480 | Ponto de extremidade de cliente remoto não registrado. | Verifique se o ponto de extremidade remoto está disponível. | ||
481 | Falha na manipulação da chamada de entrada. | Abra uma solicitação de suporte por meio do portal do Azure. | ||
487 | Chamada cancelada, recusada localmente, encerrada devido a um problema de incompatibilidade de ponto de extremidade ou com falha na geração da oferta de mídia. | Comportamento esperado. | ||
490, 491, 496, 497, 498 | Problemas de rede do ponto de extremidade local. | Verifique sua rede. | ||
503, 504 | Erro de infraestrutura dos Serviços de Comunicação. | Abra uma solicitação de suporte por meio do portal do Azure. | ||
600 | Ocupado em todos os lugares. O participante entrou em contato com êxito, mas recebeu o sinal ocupado. | Comportamento esperado. | ||
603 | Chamada globalmente recusada pelo participante remoto dos Serviços de Comunicação. | Comportamento esperado. | ||
604 | Não existe em lugar nenhum. O URI solicitado não existe. | Comportamento esperado. | ||
606 | Não é aceitável. O participante entrou em contato com êxito, mas não pode dar suporte à sessão descrita. | Comportamento esperado. |
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
.
Chamar códigos de chamada final e subcódigos
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.
Subcódigo | Código | Mensagem | Categorias de resultados | Advice |
---|---|---|---|---|
0 | 0 | A chamada foi encerrada com sucesso pelo participante local. | Sucesso | |
0 | 487 | A chamada foi encerrada com êxito quando o chamador cancelou a chamada. | Sucesso | |
0 | 603 | A chamada foi encerrada com sucesso, pois foi recusada pelo destinatário. | Êxito | A chamada foi encerrada porque ela foi recusada pelo usuário de destino por meio da função de rejeição do SDK do cliente, da Automação de Chamadas, do Graph, da PSTN ou do Teams. |
7 | 496 | A chamada foi encerrada como conexão de rede perdida pelo cliente abruptamente e, apesar de várias tentativas, não foi possível se conectar | ExpectedError | O navegador está offline ou tem problemas de rede. Verifique a conexão de rede do navegador e tente novamente. |
3100 | 410 | Falha na configuração da chamada devido a um problema de rede inesperado no cliente. Verifique a rede do cliente e tente novamente. | UnxpectedClientError | Verifique a configuração de rede, verifique se ela segue os requisitos de rede de Chamada de Comunicação do Azure. |
3101 | 410 | Chamada perdida devido a um problema de rede inesperado no cliente. Verifique a rede do cliente e tente novamente. | UnxpectedClientError | Verifique a configuração de rede, verifique se ela segue os requisitos de rede de Chamada de Comunicação do Azure. |
3111 | 410 | Falha na configuração de chamada, não é possível processar a oferta de mídia ao conectar a chamada. | UnxpectedClientError | Tente novamente. Se o problema persistir, colete as informações de chamada, os logs do cliente, os logs do console do navegador e entre em contato com o suporte dos Serviços de Comunicação do Azure. |
3112 | 410 | A configuração da chamada falhou devido a um problema de configuração de rede no lado do cliente. Verifique a configuração de rede do cliente e tente novamente. | ExpectedError | Saiba mais detalhes sobre uma chamada que termina com um subcodificado 3112 aqui. |
4097 | 0 | A chamada foi encerrada para todos os usuários pelo organizador da reunião. | Êxito | |
4502 | 490 | Falha na chamada devido a problemas de conectividade de rede, o navegador não pôde concluir a solicitação HTTP de rede. | UnexpectedClientError | Falha do cliente ao concluir a solicitação e a resposta HTTP. Tente novamente. Se o problema persistir, colete as informações de chamada, os logs do cliente, os logs do console do navegador e entre em contato com o suporte dos Serviços de Comunicação do Azure. |
4506 | 408 | Chamada expirada. Verifique se o destinatário da chamada recebeu e aceitou a chamada. | UnexpectedClientError | Tente novamente. Se o problema persistir, colete as informações de chamada, os logs do cliente, os logs do console do navegador e entre em contato com o suporte dos Serviços de Comunicação do Azure. |
4507 | 495 | A chamada foi encerrada porque o aplicativo não forneceu um token válido dos Serviços de Comunicação do Azure. | UnexpectedClientError | Certifique-se de que o aplicativo implemente o mecanismo de atualização de token corretamente. |
4521 | 0 | A chamada foi encerrada porque o usuário se desconectou da chamada abruptamente. Isso pode ser causado por um usuário que fechou o aplicativo que hospedava a chamada, por exemplo, um usuário encerrou o aplicativo fechando a guia do navegador sem desligar adequadamente. | ExpectedError | |
5.000 | 0 | A chamada terminou para este participante. Participante removido da conversa por outro participante. | Êxito | |
5003 | 0 | A chamada terminou com êxito, pois todos os pontos de extremidade do receptor recusaram a chamada. | Êxito | |
5300 | 0 | A chamada terminou para este participante, pois foi removido da conversa por outro participante. | Êxito | A chamada foi encerrada para esse participante quando outro participante o removeu, pode ser outro cliente, a API de Automação de Chamadas, a API do Graph. |
5,317 | 0 | O participante de destino foi removido devido à atualização da função do participante. | ExpectedError | |
5828 | 403 | O ingresso nas salas de reuniões não está autorizado, pois o usuário não faz parte da lista de convidados. | UnexpectedClientError | |
5829 | 403 | Não é permitido ingressar nas salas de reunião após o horário de término ou antes do horário de início da reunião. | UnexpectedClientError | |
5830 | 403 | Somente o usuário dos Serviços de Comunicação tem permissão para participar da reunião no Salas. | ExpectedError | |
7000 | 0 | A chamada foi encerrada pela API de Automação de Chamadas do Serviço de Comunicação do Azure ou por um bot de servidor. | Êxito | A chamada foi encerrada pela API de Automação de Chamadas do ACS ou pelo bot do Graph. |
10003 | 487 | A chamada foi cancelada para esse ponto de extremidade de usuário, pois foi aceita em outro lugar, por outro ponto de extremidade. | Êxito | Uma chamada foi iniciada para o usuário de destino (chamada inicial, adicionar participante, transferência), o usuário de destino tinha vários pontos de extremidade ativos ao mesmo tempo, em um dos pontos de extremidade que o usuário aceitou a chamada. Esse é um comportamento normal, apenas um ponto de extremidade pode aceitar e se conectar a uma chamada. Todos os outros pontos de extremidade recebem o subcódigo 10003 para indicar que a chamada já foi aceita. |
10004 | 487 | A chamada foi cancelada no tempo limite, pois o usuário de destino não a aceitou nem rejeitou a tempo. Verifique se o usuário visualizou a notificação e/ou o aplicativo pode lidar com ela automaticamente e tentar iniciar essa chamada novamente. | ExpectedError | A chamada foi cancelada após a quantidade predefinida de tempo (geralmente 2 minutos) como o usuário de destino não aceitou ou rejeitou. |
10009 | 401 | Identidade não autenticada. Verifique se o token dos Serviços de Comunicação do Azure é válido e não expirou. | UnexpectedClientError | |
10024 | 487 | A chamada terminou com êxito. Chamada recusada por todos os pontos de extremidade do receptor. | Êxito | Tente fazer a chamada novamente. |
10037 | 480 | O usuário de destino não tinha nenhum ponto de extremidade registrado no ACS. Verifique se o usuário de destino tem pelo menos um ponto de extremidade ativo e está online. | ExpectedError | Se o usuário de destino estiver usando o SDK de Chamada dos Serviços de Comunicação do Azure, verifique se o SDK foi inicializado com êxito em seu aplicativo cliente. Se o usuário de destino for um usuário do Teams, verifique se o cliente está online. Verifique se o identificador do usuário de destino (CommunicationUserIdentifier, MicrosoftTeamsUserIdentifier ou MicrosoftTeamsBotIdentifier) está correto. Se a API do Graph user tiver a propriedade department definida Microsoft Communication Application Instance como o MicrosoftTeamsBotIdentifier deve ser especificada. |
10057 | 408 | A chamada falhou; o destinatário não conseguiu finalizar a configuração da chamada, provavelmente porque o destinatário perdeu a rede ou encerrou o aplicativo repentinamente. Verifique se os clientes estão conectados e disponíveis. | ExpectedError | |
10076 | 480 | O usuário de destino foi registrado, mas não estava online no momento da chamada. Verifique se o usuário de destino tem pelo menos um ponto de extremidade ativo e está online. | ExpectedError | Se o usuário de destino estiver usando o SDK de Chamada dos Serviços de Comunicação do Azure, verifique se o SDK foi inicializado com êxito no aplicativo cliente e se o ponto de extremidade está online. Se o usuário de destino for um usuário do Teams, verifique se o cliente está online. |
10077 | 480 | O usuário de destino foi registrado no ACS e/ou para notificações por push, mas não estava online no momento da chamada. Verifique se o usuário de destino tem pelo menos um ponto de extremidade ativo e está online. | ExpectedError | Se o usuário de destino estiver usando o SDK de Chamada dos Serviços de Comunicação do Azure, verifique se o SDK foi inicializado com êxito no aplicativo cliente e se o ponto de extremidade está online. Se o aplicativo aproveitar as Notificações por push, verifique se elas estão configuradas corretamente. Se o usuário de destino for um usuário do Teams, verifique se o cliente está online. |
10.078 | 480 | Ponto de extremidade do cliente remoto não registrado ou não acessível. Verifique se o ponto de extremidade do cliente remoto está enviando solicitações de rede com êxito para os Serviços de Comunicação do Azure. | ExpectedError | – Se o usuário de destino estiver usando o SDK de Chamada dos Serviços de Comunicação do Azure, verifique se o SDK foi inicializado com êxito em seu aplicativo cliente e seu ponto de extremidade estará online. Se o aplicativo aproveitar as Notificações por push, verifique se elas estão configuradas corretamente. – Se o usuário de destino for um usuário do Teams, verifique se o cliente está online. |
301004 | 410 | O participante foi removido da chamada pela infraestrutura dos Serviços de Comunicação do Azure devido à incapacidade de estabelecer conectividade de mídia com a infraestrutura dos Serviços de Comunicação do Azure durante a instalação da chamada. Verifique a configuração de rede do usuário, inclusive a rede local, os firewalls, a configuração de VPNs e tente novamente. | UnexpectedClientError | Verifique se a rede do usuário está configurada corretamente, siga a documentação pública "Recomendações de Rede". |
301005 | 410 | Participante removido da chamada pela infraestrutura dos Serviços de Comunicação do Azure devido à perda de conectividade de mídia com a mesma infraestrutura. Isso geralmente acontece se o participante deixa a chamada abruptamente ou perde a conectividade de rede. Se o participante quiser continuar a chamada, ele poderá se reconectar. | UnexpectedClientError | Verifique se você está usando o SDK mais recente em um ambiente com suporte. |
540000 | 0 | A chamada foi encerrada com sucesso pelo chamador de PSTN local. | Êxito | |
510403 | 403 | A chamada terminou, marcada anteriormente como spam e agora bloqueada. | ExpectedError | – Certifique-se de que o token dos Serviços de Comunicação seja válido e não tenha expirado. – Certifique-se de passar em AlternateId nas opções de chamada. |
540487 | 487 | A chamada foi encerrada com êxito quando o chamador cancelou a chamada. | Êxito | |
560000 | 0 | A chamada foi encerrada com êxito pelo participante PSTN remoto. | Êxito | Possíveis causas: – O usuário encerrou a chamada. – Chamada encerrada pelo agente de mídia. |
560486 | 486 | A chamada foi encerrada porque o participante PSTN remoto estava ocupado. O número chamado já estava em uma chamada ou estava tendo problemas técnicos. | Êxito | - Para chamadas de Roteamento Direto, verifique os logs e configurações do seu Controle de Borda de Sessão e as configurações de tempos limite. Causas possíveis: o número chamado já estava em uma chamada ou tendo problemas técnicos. |
404 | Chamada não encontrada. | Verifique se o número que você está chamando (ou a chamada em que está ingressando) existe. | ||
408 | O controlador de chamada atingiu o tempo limite. | O controlador de chamada atingiu o tempo limite aguardando as mensagens de protocolo dos pontos de extremidade do usuário. Verifique se os clientes estão conectados e disponíveis. | ||
410 | Erro de pilha de mídia local ou infraestrutura de mídia. | Verifique se você está usando o SDK mais recente em um ambiente com suporte. | ||
430 | Não foi possível entregar a mensagem ao aplicativo cliente. | Verifique se o aplicativo cliente está em execução e disponível. | ||
480 | Ponto de extremidade de cliente remoto não registrado. | Verifique se o ponto de extremidade remoto está disponível. | ||
481 | Falha na manipulação da chamada de entrada. | Abra uma solicitação de suporte por meio do portal do Azure. | ||
490, 491, 496, 497, 498 | Problemas de rede do ponto de extremidade local. | Verifique a configuração de rede, verifique se ela segue os requisitos de rede de Chamada de Comunicação do Azure. | ||
500, 503, 504 | Erro de infraestrutura dos Serviços de Comunicação. | Abra uma solicitação de suporte por meio do portal do Azure. |
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 mais comuns da Automação de Chamadas
Código | Subcódigo | Descrição | Mitigação |
---|---|---|---|
404 | 8522 | Um código de erro genérico que indica que o recurso não foi encontrado. Os recursos podem incluir chamadas e participantes. | Verificar o status da chamada dupla: a chamada pode já ter terminado ou o participante deixou a chamada. |
400 | 8523 | Um código de erro genérico que indica que algo no corpo da solicitação é inválido. | Verifique se todos os parâmetros são válidos. Consulte a mensagem de erro para determinar qual parâmetro está lançando o erro. |
400 | 8501 | Ação sem suporte para chamada não estabelecida | A ação associada à mensagem de erro foi ativada enquanto a chamada não estava ativa. Certifique-se de que novas ações de chamada não sejam iniciadas após a chamada ter sido desconectada. Esse erro também poderá resultar de ações invocadas enquanto a chamada estiver ativa se ela estiver perto do tempo desconectado da chamada. |
400 | 8500 | Modo de Mídia Inválido | Verifique o status das operações de mídia para visualizar se alguma delas já está ativa ou se o participante de destino já está em uma operação de mídia. Se houver uma operação de mídia ativa, aguarde até que a operação seja concluída e tente novamente. |
400 | 8559 | Ação sem suporte apenas para um único aplicativo de discagem permitido | Solicitação de gravação de início duplicada, gravação já iniciada ou em andamento. Verifique o status da gravação duas vezes para garantir que ela esteja inativa antes de enviar uma nova chamada de início de gravação. |
400 | 8528 | Ação sem suporte para chamada encerrada | A ação associada à mensagem de erro foi ativada enquanto a chamada foi encerrada. Verifique se as novas ações de chamada não são iniciadas depois que a chamada é encerrada. Esse erro também poderá resultar de ações invocadas enquanto a chamada estiver ativa se ela estiver próxima da hora de término da chamada. |
409 | 8519 | Conflito | Verifique se várias ações não estão sendo executadas no mesmo recurso em paralelo. Consulte a mensagem de erro para identificar quais duas ações estão em conflito. |
403 | 7507 | Identidade de origem da chamada inválida | A identidade do aplicativo do token de autorização não correspondeu à identidade do aplicativo na origem da chamada. Verifique se você está usando a cadeia de conexão do recurso de ACS no qual o webhook de chamada de entrada foi configurado (o número de telefone deve pertencer ao mesmo recurso de ACS que atende à chamada). |
403 | 7504 | Permissões de aplicativo insuficientes | Código genérico para permissões insuficientes, verifique a mensagem de erro para obter contexto sobre qual recurso está sem permissões. |
400 | 8585 | Ação não válida no estado de chamada atual | A chamada não está estabelecida ou está desconectada: aguarde até que a chamada seja estabelecida antes de tentar novamente a ação de mídia. |
405 | 8520 | Funcionalidade sem suporte no momento | Erro esperado: o fluxo de trabalho não tem suporte no momento. Verifique nosso blog de lançamento para visualizar se há um SDK atualizado que habilitou essas funcionalidades. Consulte a página de limitações conhecidas da Automação de Chamadas para obter uma lista de fluxos de trabalho sem suporte. |
412 | 8583 | Falha na Pré-condição | Faça referência a esta página listando ações de mídia incompatíveis para garantir que você não esteja executando ou enfileirando ações incompatíveis. |
400 | 8567 | Entidade de serviço de recurso de ACS não habilitada | O Recurso de Serviço Cognitivo do Azure não está configurado corretamente. Consulte esta página para obter um guia sobre como configurar o Recurso de Serviço Cognitivo do Azure. |
405 | 8522 | Configuração ausente | Verifique a mensagem de erro para obter mais contexto sobre qual configuração precisa ser estabelecida. Essa configuração precisa acontecer ao invocar a API do AnswerCall. |
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ódigo de status | Descrição |
---|---|
400 | Solicitação inválida |
401 | Não Autorizado |
403 | Proibido |
404 | Não encontrada |
405 | Método não permitido |
406 | Não é aceitável |
408 | Tempo limite atingido |
409 | Conflito |
412 | Falha na Pré-condição |
413 | A entidade da solicitação é grande demais |
426 | Atualização necessária |
429 | Número excessivo de solicitações |
481 | A transação não existe |
487 | Canceled |
Códigos 5xx
Um código 5xx representa um erro de servidor.
Código de status | Descrição |
---|---|
500 | Erro interno do servidor |
501 | Não implementado |
502 | Gateway inválido |
503 | Serviço indisponível |
504 | Tempo Limite do Gateway |
Códigos 6xx
Um código 6xx representa um erro global.
Código de status | Descrição |
---|---|
603 | Recusado |
Subcódigos genéricos
Subcódigo | Descrição |
---|---|
0 | Êxito |
7000 | Normal |
7500 | Identidade do AAD sem suporte |
7501 | token inválido |
7502 | Acesso não habilitado |
7504 | Permissões de aplicativo insuficientes |
7505 | Incompatibilidade do locatário da empresa |
7506 | Certificado Não Confiável |
7507 | Identidade de origem da chamada inválida |
7508 | Identidade ACS sem suporte |
7509 | Erro de validação do Hmac |
7510 | Erro de validação de identidade gerenciada |
7600 | Acesso a recursos não habilitado |
7601 | Identidade de origem do ACS inválida |
7602 | Identidade de destino inválida do ACS |
7603 | Identidade do ACS inválida |
7604 | Cenário de interoperabilidade não autorizado do Teams |
7605 | Cenário de interoperabilidade de gravação de equipes não autorizadas |
7606 | Recurso de ACS não autorizado para ações cognitivas |
8500 | Modo de Mídia Inválido |
8501 | Chamada não estabelecida |
8502 | Minha ID do participante não está disponível |
8503 | Chamada inativa de áudio de estado de mídia |
8504 | Fluxos de mídia indisponíveis |
8505 | Vários participantes com substituição |
8506 | Chamada de gravação de não conformidade |
8508 | Operação cancelada |
8509 | Tempo limite máximo de silêncio atingido |
8510 | Tempo limite de silêncio inicial atingido |
8511 | Falha no prompt de reprodução |
8512 | Falha na reprodução do bipe |
8513 | Tempo limite de recebimento de mídia |
8514 | Tom de parada detectado |
8515 | Duração máxima do registro atingida |
8516 | Chamada limitada |
8517 | Incompatibilidade de ID do locatário de chamada |
8518 | Exceção de chamada |
8519 | Conflito |
8520 | Não Implementado |
8521 | Muitos saltos |
8522 | Não encontrado |
8523 | Argumento inválido |
8524 | Contagem de participantes inválidos para gravação de conformidade |
8525 | Parte não gravada |
8526 | Token de junção inválido |
8527 | URL de junção inválida |
8528 | Chamadas terminadas |
8529 | Limite mensal limitado de chamadas atingido |
8530 | Limite de chamadas ativas limitadas por chamada atingido |
8531 | Dígitos máximos recebidos |
8532 | Tempo limite entre dígitos atingido |
8,533 | Opção Dtmf correspondida |
8534 | Tom incorreto inserido |
8535 | Formato de arquivo inválido |
8536 | Falha ao baixar arquivo |
8537 | Manter o tempo limite vivo atingido |
8538 | Receptor de chamada recusado |
8539 | Destinatário da chamada ocupado |
8,540 | Destinatário da chamada ocupado em todos os lugares |
8541 | Destinatário da chamada não disponível |
8542 | Chamada cancelada |
8543 | A chamada não existe |
8544 | Dispositivo de chamada inacessível |
8545 | Opção de fala correspondente |
8546 | Solicitação inválida enviada pelo destinatário |
8547 | Opção de fala não correspondida |
8548 | Chamada não é chamada de grupo |
8549 | Falha na criação da conversa de redirecionamento |
8550 | Falha na negociação de mídia de redirecionamento |
8551 | Não há suporte para o redirecionamento |
8552 | Não é possível remover o organizador |
8553 | Gravação duplicada |
8554 | Participante fora da combinação de áudio da reunião |
8555 | Redirecionar já em andamento |
8556 | Ação sem suporte para chamada de CR |
8557 | Tipo de formato incorreto |
8558 | Participante não presente |
8559 | Discagem única duplicada |
8560 | Ingressar na conversa bloqueada devido a uma reunião bloqueada |
8561 | ID de reunião de ingresso inválida |
8562 | Modo de gravação sem suporte |
8563 | Fala não reconhecida |
8564 | Erro de conexão do serviço de fala |
8565 | Erro dos serviços cognitivos |
8566 | Operação de ativação de som não permitida |
8567 | Entidade de serviço de recurso de ACS não habilitada |
8568 | Falha na identidade gerenciada da solicitação de serviço cognitivo |
8571 | Conflito de operação de gravação |
8569 | Fala reconhecida |
8570 | Erro de reconhecimento de fala dos Serviços Cognitivos |
8572 | Desligamento do serviço de reprodução |
8573 | Pausar método de retomada não permitido |
8578 | Falha na transcrição |
8579 | Transcrição cancelada |
8580 | Desligamento do serviço de transcrição |
8581 | URL de transmissão inválida |
8582 | Reproduzir texto de origem ou Ssml vazio |
8583 | Falha na Pré-condição |
8585 | Ação não válida no estado de chamada atual |
8586 | Chamada de entrada não confirmada pelo bot |
8587 | Chamada de entrada não atendida dentro do tempo |
8588 | Tempo limite de recebimento do registro concluído e da mídia |
8589 | Registro limitado |
8594 | Falha no estado da reunião de atualização |
8603 | Falha no streaming de mídia |
8604 | Streaming de mídia cancelado |
8605 | Modelo de fala personalizada de transcrição sem suporte |
8,606 | Falha na criação do identificador de comunicação |
8607 | Conflito de operação de transferência |
8608 | Erro de cliente participante de gravação |
8609 | Resposta de junção inválida do bot |
8610 | Nenhuma resposta do bot na notificação |
8613 | Limite de legendas dinâmicas limitadas por chamada atingido |
9001 | Erro desconhecido do serviço subjacente |
9002 | Erro de tempo limite do serviço subjacente |
9003 | Erro de operação cancelada |
9998 | Erro fatal |
9999 | Desconhecido |
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.
ParticipantEndReason 0
A resposta ParticipantEndReason
com o valor 0 geralmente significa limpeza normal de chamadas e marca chamadas que foram concluídas sem erros.
Subcódigo | Código | Mensagem | Categorias de resultados | Advice |
---|---|---|---|---|
0 | 0 | A chamada foi encerrada com sucesso pelo participante local. | Êxito | |
560000 | 0 | Fim normal da chamada PSTN: – O usuário encerrou a chamada. – Chamada encerrada pelo agente de mídia. |
Êxito | |
540000 | 0 | Fim normal da chamada PSTN: – O usuário encerrou a chamada. – Chamada encerrada pelo agente de mídia. |
Êxito |
ParticipantEndReason 4xx
A resposta ParticipantEndReason
com o valor 4xx significa que a chamada não se conectou.
Subcódigo | Código | Mensagem | Categorias de resultados | Advice |
---|---|---|---|---|
510403 | 403 | Chamada bloqueada: – ID alternativa não fornecida para a chamada. – Número de telefone não permitido pelos usuários do SBC (Controlador de borda da sessão). |
– Para obter mais informações sobre a ID alternativa, consulte Gerenciar chamadas. – Verifique se você especificou uma ID alternativa válida. Ela deve ser um número de telefone que pertença ao recurso que você está usando. – Verifique se você é o proprietário do recurso que está usando para fazer uma chamada. – Para chamadas de roteamento direto, verifique por que o Controlador de borda da sessão não permitiu a chamada. |
|
560403 | 403 | – Chamada proibida. – Chamada cancelada. – Chamada rejeitada. |
Verifique se você chamou um número de telefone válido no formato correto. Para obter mais informações sobre formatos de número com suporte, consulte https://en.wikipedia.org/wiki/E.164. | |
511532 | 403 | Configuração do tronco SIP de recurso não encontrada. | Verifique a configuração de roteamento direto no portal do Azure. Para obter mais informações, consulte Provisionamento de roteamento direto. | |
560404 | 404 | – Número de telefone não encontrado. – Número de telefone não atribuído a nenhum destino. – Número de telefone não permitido pelo Controlador de borda da sessão. |
– Verifique se o número de telefone pertence ao recurso que você está usando e se é o proprietário do Recurso. – Verifique se o número que você está chamando existe e se está atribuído ao destino válido. |
|
511404 | 404 | – Número de telefone não encontrado. – Recurso usado na chamada não encontrada. |
– Verifique se você usou um número de telefone que pertence ao Recurso que está usando e que é o proprietário do Recurso. – Verifique se o número que você está chamando existe e se está atribuído a um destino válido. – Verifique se o recurso que você está usando para a chamada não está excluído ou desabilitado. – Verifique se suas assinaturas do Azure não estão excluídas ou desabilitadas. |
|
560408 | 408 | O participante chamado não respondeu a uma mensagem de estabelecimento de chamada dentro do período de tempo prescrito. | – Verifique novamente por que o participante chamado não respondeu. - Para chamadas de roteamento direto, verifique os registros e as configurações do Controle de Borda de Sessão (SBC) e a configuração de tempos limite. |
|
500001 | 408 | Tempo limite do gateway do usuário Os Serviços de Comunicação do Azure não receberam uma resposta do cliente dentro de um limite de tempo especificado e encerraram a solicitação. |
– Verifique novamente por que o participante chamado não respondeu. - Para chamadas de roteamento direto, verifique os registros, as definições e a configuração de tempo limite do SBC. |
|
531004 | 410 | Falha nas verificações do ICE (Estabelecimento interativo de conectividade). | – O caminho da mídia não pôde ser estabelecido. Pode ser causado por uma configuração de rede incorreta. Verifique a configuração de rede para verificar se as portas e os endereços IP necessários não estão bloqueados. Leia as diretrizes em https://www.rfc-editor.org/rfc/rfc5245#section-7. - Para chamadas de roteamento direto, verifique os registros e as configurações do SBC quanto à configuração e ao perfil do ICE. Entre em contato com seu fornecedor do SBC para obter ajuda de configuração. Para mais informações, consulte Lista de Controladores de borda de sessão certificados para roteamento direto dos Serviços de Comunicação do Azure. |
|
560480 | 480 | – Nenhuma resposta do usuário chamado. – Usuário chamado temporariamente indisponível. |
– Verifique novamente por que o participante chamado não respondeu. – Tente novamente a chamada mais tarde, caso o participante chamado não esteja disponível temporariamente. - Para chamadas de roteamento direto, verifique os registros, as definições e a configuração de tempo limite do SBC. |
|
560484 | 484 | – Endereço de destinatário da chamada incompleto ou inválido. – Formato de número de destinatário da chamada incompleto ou inválido. |
– Em alguns casos, você poderá ignorar essas falhas porque o usuário está discando um número inválido. – Verifique se os números de telefone estão formatados corretamente. Para obter mais informações, consulte https://en.wikipedia.org/wiki/E.164. – Para roteamento direto, o SBC pode causar essas falhas devido a uma configuração ausente em um cenário de transferência de chamada. |
|
60486 | 486 | O número chamado estava ocupado | – O número chamado pode estar conectado a uma chamada existente ou ter um problema técnico. - Para chamadas de roteamento direto, verifique os registros, as definições e a configuração de tempo limite do SBC. |
|
540487 | 487 | O autor da chamada encerrou a solicitação de chamada. | Tente novamente a chamada. | |
560487 | 497 | – O autor da chamada encerrou a solicitação de chamada. – Solicitação encerrada com a compensação de chamada normal. |
Tente novamente a chamada. |
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.
Subcódigo | Código | Mensagem | Categorias de resultados | Advice |
---|---|---|---|---|
560500 | 500 | Ocorreu um erro interno do servidor em um dos serviços envolvidos na chamada. | – Tente novamente a chamada. Se o problema persistir, entre em contato com seu provedor de telecomunicações ou com o suporte da Microsoft. - Para chamadas de roteamento direto, verifique os registros e as configurações do SBC e a configuração de tempo limite, para ver se o SBC causou a falha. |
|
560503 | 503 | – Falha na chamada devido a um erro interno do servidor em um dos serviços envolvidos na chamada. – A rede usada para estabelecer a chamada está fora de ordem. – Uma falha temporária em um dos serviços envolvidos na chamada. |
– Verifique a configuração de roteamento e rede para possíveis problemas. Verifique se as regras de firewall de rede estão corretas. – Tente novamente a chamada. Se o problema persistir, entre em contato com o provedor de telecomunicações ou com o suporte da Microsoft. - Para chamadas de roteamento direto, verifique os registros e as configurações do SBC e a configuração de tempo limite, para ver se o SBC causou a falha. |
ParticipantEndReason 603
A resposta ParticipantEndReason
com o valor 603 significa que a chamada foi rejeitada sem conexão.
Subcódigo | Código | Mensagem | Categorias de resultados | Advice |
---|---|---|---|---|
560603 | 603 | – Chamada recusada pelo destinatário. – Chamada recusada devido à detecção de fraude. |
– Se for recusado pelo destinatário, repita a chamada. – Verifique se você não está excedendo o número máximo de chamadas simultâneas permitidas para o número de telefone dos Serviços de Comunicação do Azure. Para obter mais informações, consulte Limitações de chamada PSTN. |
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ódigo | Mensagem | Advice |
---|---|---|
401 | Não Autorizado | Verifique se o token dos Serviços de Comunicação é válido e se não expirou. |
403 | Proibido | Verifique se o iniciador da solicitação tem acesso ao recurso. |
429 | Número excessivo de solicitações | Verifique se o aplicativo do lado do cliente lida com esse cenário de maneira amigável. Se o erro persistir, envie uma solicitação de suporte. |
503 | Serviço indisponível | Abra uma solicitação de suporte por meio do portal do Azure. |
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.
Código | Mensagem | Advice |
---|---|---|
2000 | Mensagem entregue com êxito. | |
4000 | A mensagem foi rejeitada devido à detecção de fraudes. | Verifique se você não está excedendo o número máximo de mensagens permitido para seu número. |
4001 | A mensagem foi rejeitada devido ao formato de número de origem inválido | Verifique se o número Para está no formato E.164 e o formato do número De está no formato E.164 ou no formato de Código curto. |
4002 | A mensagem foi rejeitada devido ao formato de número de Destino/para inválido. | Verifique se o número Para está no formato E.164 |
4003 | Falha ao entregar a mensagem devido a um destino sem suporte. | Verifique se o destino que você está tentando enviar tem suporte. |
4004 | Falha ao entregar a mensagem, pois o número de Destino/para não existe. | Verifique se o número Para o qual você está enviando é válido. |
4005 | Mensagem bloqueada pela operadora de Destino. | |
4006 | O número de Destino/para não está acessível. | Tente enviar novamente a mensagem mais tarde. |
4007 | O número de Destino/para recusou o recebimento de mensagens vindas de você. | Marque o número de Destino/para como recusado a fim de que nenhuma outra tentativa de mensagem seja feita ao número. |
4008 | Você excedeu o número máximo de mensagens permitidas para seu perfil. | Verifique se você não está excedendo o número máximo de mensagens permitidas para seu número ou use filas para enviar as mensagens em lote. |
4009 | Mensagem rejeitada pelo Sistema de Direitos da Microsoft. | Na maioria das vezes, isso acontece se for detectada atividade fraudulenta. Entre em contato com o suporte para obter mais detalhes. |
4010 | A mensagem foi bloqueada devido ao número de chamada gratuita não ter sido verificado. | Examine os limites de envio não verificados e envie a verificação de chamada gratuita assim que possível. |
5.000 | Falha na entrega da mensagem. Entre em contato com a equipe de suporte da Microsoft para obter mais detalhes. | Abra uma solicitação de suporte por meio do portal do Azure. |
5001 | Falha na entrega da mensagem devido à indisponibilidade temporária do aplicativo/sistema. | |
5002 | Transportadora não suporta relatório de entrega | Na maioria das vezes, isso acontece se uma transportadora não oferecer suporte a relatórios de entrega. Nenhuma ação é necessária, pois a mensagem pode já ter sido entregue. |
9999 | Falha ao entregar a mensagem devido a um erro/falha desconhecido. | Tente enviar a mensagem novamente. |