O desafio

As integrações correm no n8n, mas as equipas operacionais da Administrate não deveriam precisar de aceder à interface n8n para perceber se uma sincronização teve sucesso, que registos foram rejeitados ou onde ocorreu um problema. O histórico de execução nativo, por si só, não dava a visibilidade certa aos utilizadores de negócio.

A solução

Construímos um workflow de registo externo dedicado, chamado após cada lote escrito na Administrate. Transforma dados técnicos de execução num registo operacional e publica-o através da API GraphQL da Administrate.

• Captura a integração, o sistema de origem, o tipo de objeto, o número do lote, o watermark e os totais de registos.
• Classifica cada lote como success, warning ou failed com base nos registos escritos e rejeitados.
• Publica uma mensagem concisa mais detalhes ao nível do registo, incluindo registos rejeitados e motivos.
• Liga registos escritos com sucesso quando disponível e limita as vistas de detalhe para lotes grandes.
• Usa lógica de repetição para que uma falha temporária de registo não remova silenciosamente a visibilidade operacional.

Resultados

• As equipas da Administrate podem rever a saúde das integrações a partir da sua própria plataforma, sem acesso direto ao n8n.
• Cada lote tem um registo auditável de registos escritos, rejeitados e totais.
• Registos rejeitados e watermarks fornecem o contexto necessário para investigar exceções rapidamente.