Por que minha integração está conectada, mas não está funcionando corretamente?
Uma integração pode parecer conectada enquanto operações individuais falham ou produzem resultados inesperados.
Uma conexão bem-sucedida confirma que uma etapa de autorização ou configuração foi concluída. Não garante necessariamente que cada operação suportada tenha as permissões necessárias, uma configuração válida ou acesso aos recursos externos desejados.
Por que isso pode acontecer?
As causas possíveis incluem:
1. Permissões ausentes para uma operação específica.
2. Registros externos que não estão disponíveis ou são inacessíveis.
3. Identificadores de recursos ou valores de configuração incorretos.
4. Credenciais de autorização expiradas ou revogadas.
5. Restrições de API do lado do provedor.
6. Limites de taxa ou cotas de uso.
7. Falhas temporárias de rede ou do provedor.
8. Alterações na conta externa ou suas permissões.
9. Dados inválidos enviados ao serviço externo.
10. Uma operação que não é suportada pela integração.
Como identificar o problema
Passo 1: Determine qual operação está falhando.
Identifique se o problema afeta a recuperação de informações, a criação de registros, a atualização de dados ou outra ação suportada.
Passo 2: Verifique se outras operações funcionam.
Se algumas operações têm sucesso enquanto outras falham, o problema pode envolver permissões ou configurações específicas da operação.
Passo 3: Verifique o recurso externo.
Confirme que o registro, calendário, conta ou outro recurso existe e é acessível à conta externa autorizada.
Passo 4: Revise a configuração da integração.
Verifique as configurações relevantes e os identificadores de recursos para valores incorretos ou desatualizados.
Passo 5: Revise as permissões da conta externa.
A conexão pode estar autorizada sem ter acesso a cada recurso ou ação.
Passo 6: Inspecione os detalhes de erro disponíveis.
Procure por erros de autenticação, falhas de permissão, solicitações inválidas ou mensagens específicas do provedor.
Passo 7: Verifique a disponibilidade do serviço externo.
Algumas operações podem estar temporariamente indisponíveis durante incidentes do provedor.
Passo 8: Teste com uma operação controlada.
Use um teste de baixo risco que não modifique registros comerciais importantes.
Passo 9: Revise o resultado.
Confirme que o serviço externo recebeu e processou a operação pretendida.
Um status conectado garante que os dados estão se sincronizando?
Não.
O status de conexão e a troca de dados bem-sucedida são condições diferentes.
Reconectar sempre resolve o problema?
Não.
A reautorização pode ajudar quando as credenciais estão expiradas ou as permissões mudaram, mas não resolverá necessariamente configurações inválidas, recursos ausentes ou operações não suportadas.
E se apenas um processo de negócios for afetado?
Investigue a configuração e as dependências externas desse processo antes de alterar toda a integração.
Abordagem recomendada
Resolva a operação específica que está falhando, em vez de presumir que toda a conexão está quebrada.