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 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.

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 stateChanged 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.

Artigos relacionados

• Solução de problemas nos Serviços de Comunicação do Azure
• Solução de problemas de falhas de chamadas PSTN do Serviços de Comunicação do Azure