Por que minha integração se desconectou ou parou de funcionar após ter funcionado anteriormente?
Uma integração que funcionou anteriormente pode parar de funcionar quando sua autorização, permissões de conta externa, configuração do provedor ou disponibilidade do serviço mudam.
Isso pode acontecer mesmo quando nenhuma alteração foi feita diretamente dentro do Polyosync.
Razões comuns
1. Um token de acesso expirou.
2. Um token de atualização foi revogado ou se tornou inválido.
3. A senha da conta externa ou as configurações de segurança mudaram.
4. Um administrador revogou o acesso ao aplicativo.
5. A conta externa foi desativada ou suspensa.
6. As permissões necessárias foram removidas.
7. O provedor mudou sua API ou requisitos de autorização.
8. Uma assinatura externa ou direito de serviço mudou.
9. O recurso conectado foi removido.
10. O provedor externo está enfrentando uma interrupção de serviço.
O que é um token de acesso?
Um token de acesso é uma credencial que permite que um aplicativo autorizado execute operações permitidas contra um serviço externo.
Tokens de acesso geralmente têm períodos de validade limitados.
O que é um token de atualização?
Alguns provedores emitem tokens de atualização que permitem que um aplicativo solicite acesso renovado sem exigir que o usuário complete a autorização toda vez.
Nem todos os provedores ou integrações usam o mesmo mecanismo de renovação.
Um token de acesso expirado sempre requer reconexão manual?
Não.
Alguns mecanismos de autorização suportam renovação automática.
A reautorização manual pode ser necessária quando a renovação não está disponível, falha ou não é mais permitida.
Como restaurar a conexão
Passo 1: Identifique a integração afetada.
Determine qual serviço externo e operações não estão mais funcionando.
Passo 2: Revise o status da conexão disponível e as informações de erro.
Procure falhas de autenticação ou mensagens relacionadas à autorização.
Passo 3: Verifique a conta externa.
Confirme que a conta continua ativa e acessível.
Passo 4: Verifique se o acesso foi revogado.
Revise as configurações do aplicativo autorizado do provedor, onde disponível.
Passo 5: Confirme as permissões necessárias.
Certifique-se de que a conta externa ainda tenha acesso aos recursos desejados.
Passo 6: Reautorize a integração, se necessário.
Use o procedimento de gerenciamento de conexão suportado.
Passo 7: Teste a integração.
Realize uma operação controlada e verifique o resultado.
Passo 8: Revise as operações comerciais dependentes.
Verifique se há fluxos de trabalho ou processos afetados que precisam de atenção após a interrupção.
A reconexão recuperará automaticamente as operações perdidas?
Não necessariamente.
A recuperação depende da integração, da operação e se a funcionalidade de repetição ou reprodução é suportada.
Não presuma que as ações perdidas serão repetidas automaticamente.
A reconexão pode causar operações duplicadas?
Potencialmente, se uma operação interrompida for repetida manualmente após já ter sido processada pelo serviço externo.
Verifique o resultado externo antes de tentar novamente ações que criam ou modificam registros.
Abordagem recomendada
Investigue por que a autorização parou de funcionar antes de reconectar e verifique se houve interrupções nas operações comerciais durante a interrupção.