Por que uma integração que funcionava anteriormente parou de funcionar de repente?
Uma integração externa pode parar de funcionar mesmo que anteriormente funcionasse corretamente.
Isso pode acontecer porque as credenciais de autenticação expiram, as permissões mudam, um provedor externo sofre uma interrupção ou o serviço conectado altera sua configuração.
Causas comuns
1. Autorização expirada ou revogada.
2. Senhas ou credenciais alteradas no serviço externo.
3. Permissões removidas ou escopos de acesso modificados.
4. Interrupções ou falhas temporárias da API externa.
5. Limites de taxa ou restrições de uso impostas pelo provedor.
6. Mudanças na conta conectada.
7. Configuração do fluxo de trabalho modificada.
8. Dados obrigatórios ausentes ou inválidos.
Como investigar
Passo 1: Identifique a integração afetada.
Determine se o problema afeta um serviço conectado ou várias integrações.
Passo 2: Revise o status da conexão.
Verifique as configurações de integração disponíveis para erros, estados desconectados ou requisitos de autorização.
Passo 3: Revise as alterações recentes.
Considere se um administrador alterou permissões, credenciais ou configurações de conta externa.
Passo 4: Inspecione a operação falhada.
Se uma automação ou um funcionário de IA encontrou o problema, revise os detalhes de execução correspondentes.
Passo 5: Verifique o provedor externo.
Verifique se o serviço externo está disponível e se a conta conectada permanece ativa.
Passo 6: Reautentique, se necessário.
Se a integração exigir uma autorização renovada, siga o procedimento de conexão suportado.
Use apenas contas autorizadas e credenciais aprovadas.
Passo 7: Teste uma operação limitada.
Onde suportado, realize um teste de baixo risco para verificar se a conexão funciona novamente.
Considerações de segurança
Nunca inclua chaves de API, tokens de acesso, segredos de cliente ou senhas em tickets de suporte.
Não conceda permissões mais amplas do que o necessário apenas para contornar um erro de integração.
Quando entrar em contato com o Suporte
Forneça o nome da integração, o horário aproximado da falha, a operação afetada, a mensagem de erro relevante e se o problema começou após uma alteração de configuração.
Se o problema se originar de um provedor externo, a investigação pode exigir a verificação do status do serviço ou das configurações da conta desse provedor.