Solucionar erros do Amazon Connect no Salesforce Voice
Verifique mensagens de erro de softphone e erros de registro de console em nossa lista de referência para ver qual ação realizar para que as chamadas dos representantes sejam bem-sucedidas. Esses erros e mensagens se originam no Amazon Connect, mas estão disponíveis no Salesforce Voice.
Edições obrigatórias
Edições necessárias
| Exibir edições com suporte. |
Este artigo se aplica a:
- Salesforce Voice com Amazon Connect
- Salesforce Voice com Telefonia do parceiro do Amazon Connect
Erros de softphone para problemas de configuração e acesso
Esses erros de configuração e mensagens estão visíveis aos representantes no softphone do Omni-Channel. Os rótulos de registro do console correspondentes aparecem no console do navegador quando os erros são acionados.
| Erro de softphone | Rótulo de registro do console | Por que isso aparece | Ação a realizar |
|---|---|---|---|
| Não foi possível autenticá-lo por meio de SSO. Tente atualizar seu navegador ou peça ajuda ao administrador do Salesforce. | AUTH_RETRIES_EXHAUSTED |
O representante efetuou login anteriormente com êxito. O login único (SSO) foi bem-sucedido com o Painel de controle de contato (CCP) do Amazon Connect em execução em segundo plano. Porém, a conexão ou a sessão falhou repetidamente e o sistema parou de tentar autenticar essa sessão. Essa situação pode ocorrer se houver uma sessão ou token expirado ou inválido ou se a atualização do token tiver falhado. Isso também pode ocorrer devido a falha de login de SAML ou SSO. Consulte a entrada de |
Peça para o representante atualizar o navegador. Peça para o representante fazer login no Omni-Channel novamente selecionando um status de presença de disponível. Siga as recomendações em Como solucionar problemas de login e SSO do Omni-Channel? seção de Solução de problemas do Salesforce Voice. Se você validar a configuração, mas o problema persistir, peça para o administrador do provedor de identidade (IdP) entrar em contato com o suporte do Salesforce ou com o suporte da Amazon, dependendo do modelo de telefonia. |
| Sua sessão de autenticação de SSO expirou. Tente atualizar seu navegador. Se o problema persistir, faça logout do Omni-Channel atualizando seu status de presença e faça login novamente conforme disponível. | AUTH_SESSION_EXPIRED |
O representante efetuou login anteriormente com êxito. O SSO foi bem-sucedido com o Painel de controle de contato (CCP) do Amazon Connect em execução em segundo plano. Porém, a conexão ou a sessão expirou. Essa situação pode ocorrer se houver uma sessão ou token expirado ou inválido ou se a atualização do token tiver falhado. Isso também pode ocorrer devido a falha de login de SAML ou SSO. Consulte a entrada de |
Peça para o representante atualizar o navegador. Peça para o representante fazer login no Omni-Channel novamente selecionando um status de presença de disponível. Siga as recomendações em Como solucionar problemas de login e SSO do Omni-Channel? seção de Solução de problemas do Salesforce Voice. Se você validar a configuração, mas o problema persistir, peça para o administrador do provedor de identidade entrar em contato com o suporte do Salesforce ou da Amazon, dependendo do seu modelo de telefonia. |
| Sua autenticação de SSO não forneceu o acesso necessário. Peça para o administrador do Salesforce verificar sua configuração de usuário no Amazon Connect. | CONNECTOR_ACCESS_DENIED |
O Amazon Connect respondeu com um código de status 403 proibido ou semelhante. O usuário é autenticado, mas não tem permissão para realizar a ação solicitada. Esse erro se deve a falha de autorização, não falha de autenticação. Essa situação pode ocorrer se um representante não tiver permissões do IAM ou do Amazon Connect para a operação ou se tiver um perfil de segurança ou uma configuração incorreta do perfil de roteamento. |
Tente estas dicas de solução de problemas e consulte a documentação de permissões e perfis de segurança do Amazon Connect para obter mais informações.
Se o problema persistir após a validação da rede, peça para sua equipe de rede entrar em contato com o suporte do Salesforce ou da Amazon, dependendo do modelo de telefonia. |
| Habilite o microfone no navegador. | microphone_not_shared |
O representante não tem o microfone ativado nas configurações do navegador do site que está executando o softphone do Salesforce Voice. | Para o Chrome, consulte Usar sua câmera e microfone no Chrome. Se estiver usando o Firefox, consulte a janela Informações da página do Firefox. Depois de atualizar a configuração de permissão de microfone, recarregue o aplicativo Salesforce. |
| Há um problema de rede. Peça para o administrador do Salesforce verificar a configuração de rede. (E-1016) | signalling_handshake_failure |
O softphone do Amazon Connect não pode estabelecer uma conexão de sinalização inicial para o WebRTC. Essa situação pode ocorrer devido a um firewall bloqueando conexões do WebSocket, problemas de proxy de rede, políticas de segurança restritivas ou outros problemas de configuração de rede. |
Tente estas etapas de solução de problemas e consulte Requisitos de rede do Amazon Connect para obter mais informações.
Se o problema persistir após a validação da rede, peça para sua equipe de rede entrar em contato com o suporte do Salesforce ou da Amazon, dependendo do modelo de telefonia. |
| Há um problema de rede. Peça para o administrador do Salesforce verificar a configuração de rede. (E-1017) | signalling_connection_failure |
O softphone do Amazon Connect não pode estabelecer uma conexão de sinalização inicial para WebRTC devido a um erro de conexão interna. Essa situação pode ocorrer devido a um firewall bloqueando conexões do WebSocket, problemas de proxy de rede, políticas de segurança restritivas ou outros problemas de configuração de rede. |
Tente estas etapas de solução de problemas e consulte Requisitos de rede do Amazon Connect para obter mais informações.
Se o problema persistir após a validação da rede, peça para sua equipe de rede entrar em contato com o suporte do Salesforce ou da Amazon, dependendo do modelo de telefonia. |
| Não há suporte para esse navegador. Tente novamente com outro navegador. | unsupported_browser |
O representante está usando um navegador sem suporte. O Voice oferece suporte apenas à versão mais recente do navegador estável Google Chrome, Mozilla Firefox e Microsoft Edge (Chromium). | Peça para o representante alterar ou atualizar o navegador. |
| Parece que você está conectado em navegadores diferentes, como o Chrome e o Firefox. Acesse o Salesforce Voice de um navegador por vez. | user_busy_error |
O representante tem o Painel de controle de contato (CCP) do Amazon Connect em execução em dois navegadores distintos ao mesmo tempo. Quando um representante faz login no Omni-Channel, o Salesforce carrega o CCP em segundo plano. | Peça para o representante usar um navegador por vez para fazer login no Omni-Channel. |
| Parece haver um problema com a configuração do VDI de chamada de voz. Tente atualizar seu navegador e peça ajuda ao administrador do Salesforce com o código E-1019. | vdi_redir_not_supported |
O representante está tentando usar o redirecionamento de áudio do Citrix, mas seu ambiente do Citrix não oferece suporte a esse recurso. O redirecionamento de áudio permite que a voz de um representante vá diretamente do dispositivo local para o Amazon Connect (iludindo o desktop virtual), o que melhora a qualidade da chamada. | Para verificar se seu ambiente do Citrix atende aos requisitos, consulte Otimizar áudio do Amazon Connect para desktops do Citrix Cloud no Guia do administrador do Amazon Connect. |
| Parece haver um problema com a configuração do VDI de chamada de voz. Tente atualizar seu navegador e peça ajuda ao administrador do Salesforce com o código E-1018. | vdi_strategy_not_supported |
A plataforma de Infraestrutura de área de trabalho virtual (VDI) que você está usando não tem suporte no momento no Amazon Connect para redirecionamento de áudio. O Amazon Connect oferece suporte apenas a plataformas VDI específicas. | Para confirmar as plataformas VDI compatíveis com o Amazon Connect, consulte as plataformas VDI compatíveis na documentação Amazon-connect-streams (valores de enumeração de Configure a configuração do VDI com Configurar áudio de chamada de voz para usuários de desktop virtual. |
| Há um problema de rede. Peça para o administrador do Salesforce verificar a configuração de rede. (E-1015) | webrtc_error |
Ocorreu um problema porque o representante está usando um navegador sem suporte ou porque uma porta ou um protocolo obrigatório não está aberto. Por exemplo, UDP na porta 443 não é permitido. Há suporte apenas para as três versões mais recentes do Chrome ou do Firefox. | Confirme se o representante está usando um navegador compatível. O Voice oferece suporte apenas à versão mais recente do navegador estável Google Chrome, Mozilla Firefox e Microsoft Edge (Chromium). Verifique se todo o tráfego é permitido para portas e protocolos necessários. Consulte Configurações de rede de CCP e Telefone para obter mais informações. Se o problema persistir depois de verificar o navegador e as configurações de portas e protocolos, entre em contato com o suporte da Salesforce ou com o suporte da Amazon, dependendo do seu modelo de telefonia. |
Erros e mensagens de registro do console do navegador
Esses erros e mensagens estão disponíveis apenas no registro do console do navegador e não aparecem no softphone do Omni-Channel.
| Rótulo de registro do console | Por que isso aparece | Ação a realizar |
|---|---|---|
AgentHungUp |
O representante encerrou voluntariamente o contato ou se desconectou da chamada, geralmente antes de uma conexão bem-sucedida ser totalmente estabelecida. Essa mensagem também mostra quando o sistema registra uma desconexão inesperada. Quando esse erro é exibido, o Salesforce registra uma métrica de |
Se houver pendências prematuras recorrentes, instrua os representantes a evitar esse comportamento. |
BadAddressAgent |
Esse erro de configuração é exibido quando o número de telefone do softphone ou dispositivo externo do representante é inválido, inacessível ou malformado. Quando esse erro é exibido, o Salesforce registra uma métrica de |
Corrija a configuração do número de telefone para o softphone ou dispositivo externo. Consulte a seção Reivindicar um número de telefone no Amazon Connect em Configurar sua instância do Amazon Connect. Para telefones de mesa, consulte Configurar telefones de mesa para a Central de contato. |
BadAddressCustomer |
Esse erro de infraestrutura é exibido quando o número de telefone de destino do cliente é inválido, inacessível ou malformado. Esse erro geralmente ocorre durante uma chamada de saída ou uma tentativa de transferência. Quando esse erro é exibido, o Salesforce registra uma métrica de |
Se o problema persistir e afetar vários números, entre em contato com o suporte da Salesforce ou com o suporte da Amazon, dependendo do seu modelo de telefonia. |
Default |
Esse erro de infraestrutura é usado para estados de erro não classificados ou inesperados relatados pelo Amazon Connect. Quando esse erro é exibido, o Salesforce registra uma métrica de |
Entre em contato com o suporte da Salesforce ou da Amazon, dependendo do seu modelo de telefonia. |
Error |
Esse erro de infraestrutura para a Camada de serviço do Amazon Connect é um erro genérico não classificado que ocorre durante uma ação de representante ou transição de estado no Amazon Connect. Quando esse erro é exibido, o Salesforce registra uma métrica de falha de aceitação de chamada ( |
Entre em contato com o suporte da Salesforce ou da Amazon, dependendo do seu modelo de telefonia. |
FailedConnectAgent |
Esse erro de infraestrutura é exibido quando o Amazon Connect não consegue estabelecer o representante de uma chamada. Quando esse erro é exibido, o Salesforce registra uma métrica de falha de aceitação de chamada ( |
Entre em contato com o suporte da Salesforce ou da Amazon, dependendo do seu modelo de telefonia. |
FailedConnectCustomer |
Esse erro de infraestrutura é exibido quando o Amazon Connect não consegue estabelecer a parte do cliente de uma chamada. Por exemplo, o cliente não responde, a linha está ocupada ou há uma falha de infraestrutura no lado do cliente. Quando esse erro é exibido, o Salesforce registra uma métrica de |
Entre em contato com o suporte da Salesforce ou da Amazon, dependendo do seu modelo de telefonia. |
ice_collection_timeout |
O softphone do Amazon Connect não conseguiu se comunicar com o ponto de extremidade do softphone do Salesforce. Essa situação pode ocorrer devido a um firewall bloqueando conexões do WebSocket, problemas de proxy de rede ou políticas de segurança restritivas. |
Tente estas etapas de solução de problemas e consulte Requisitos de rede do Amazon Connect para obter mais informações.
Se o problema persistir após a validação da rede, peça para sua equipe de rede entrar em contato com o suporte do Salesforce ou da Amazon, dependendo do modelo de telefonia. |
LineEngagedAgent |
Essa mensagem é exibida em registros quando o representante não está gerenciando adequadamente a disponibilidade da linha. A linha externa do representante está ocupada quando o Amazon Connect tenta rotear um novo contato. Quando esse erro é exibido, o Salesforce registra uma métrica de |
Nenhuma ação necessária. Somente mensagem informativa. |
LineEngagedCustomer |
Essa mensagem será exibida se a linha do cliente estiver ocupada quando o representante ou o sistema tentar uma chamada ou transferência de saída. Quando essa mensagem é exibida, o Salesforce registra uma métrica de |
Nenhuma ação necessária. Somente mensagem informativa. |
MissedCallAgent |
Essa mensagem será exibida se o representante não aceitar uma chamada roteada dentro do período de tempo limite configurado. Quando essa mensagem é exibida, o Salesforce registra uma métrica de |
Peça para o representante aceitar a chamada dentro do período de tempo limite. |
MultipleCcpWindows |
Essa mensagem será exibida se o representante estiver conectado ao Painel de controle de contato (CCP) em várias guias ou janelas do navegador simultaneamente. Essa situação pode ocorrer quando eles estão conectados ao Omni-Channel em várias guias ou janelas do navegador. Quando essa mensagem é exibida, o Salesforce registra uma métrica de |
Peça para o representante usar o Omni-Channel em uma guia ou janela do navegador por vez. Consulte Limites e limitações do Salesforce Voice. |
Other |
Ocorreu um erro interno na Amazon. | Tente atualizar o navegador. Se o problema persistir, entre em contato com o suporte da Salesforce ou da Amazon, dependendo do seu modelo de telefonia. Consulte Requisitos de rede do Amazon Connect para obter mais informações. |
RealtimeCommunicationError |
Esse erro de infraestrutura será exibido se ocorrer um erro persistente e não recuperável no WebRTC ou na comunicação de mídia em tempo real entre o navegador do representante e o Amazon Connect. Quando essa mensagem é exibida, o Salesforce registra uma |
Se o problema não for resolvido, entre em contato com o suporte da Salesforce ou da Amazon, dependendo do seu modelo de telefonia. Consulte Requisitos de rede do Amazon Connect para obter mais informações. |
SSOLogin Failed |
A autenticação de Single Sign On (SSO) do representante não foi bem-sucedida, impedindo que ele efetuasse login com segurança no Painel de controle de contato (CCP) ou no serviço subjacente do Amazon Connect. Causas comuns:
|
Siga as recomendações em Como solucionar problemas de login e SSO do Omni-Channel? seção de Solução de problemas do Salesforce Voice. Se você validar a configuração, mas o erro persistir, peça para o administrador do provedor de identidade entrar em contato com o suporte do Salesforce ou da Amazon, dependendo do seu modelo de telefonia. |

