Integração entre sistemas sem perder dado no caminho

Fernando · Fundador, FlowIQ.Work · 2026-06-11

Integrações quebram nas bordas: timeout, retry duplicando registro, webhook perdido. O padrão que usamos — adapters reativos com dedup persistente, retries com recursão em fila e estado de entrega explícito — elimina as três classes de perda sem plataforma de integração cara.

A maioria das integrações nasce como um script que chama uma API. Funciona até a primeira instabilidade — e aí ou perde dado, ou duplica.

Os três modos de falha

1) O destino caiu e o evento sumiu. 2) O retry reprocessou e duplicou. 3) Ninguém sabe o que já foi entregue. Cada um exige um mecanismo: fila durável, deduplicação persistente e estado de entrega por registro.

Adapter reativo como unidade

Cada destino vira um adapter isolado que consome eventos, entrega com retry e devolve o resultado como evento. O sistema de origem guarda o estado (entregue, falhou, re-tentando) — visível na tela de operação, não num log de servidor.

Precisa de Kafka para isso?

Precisa de uma fila durável com consumer groups. Kafka/Redpanda resolvem bem, mas o padrão importa mais que a ferramenta.