A integração que avisa
quando quebra.
ERP, CRM, pagamentos, emissão fiscal, WhatsApp, telefonia e legado. Com fila, retentativa com recuo, idempotência e monitoramento — porque integração que falha em silêncio é pior que integração que não existe.
A integração roda há oito meses. Ninguém olha. Um dia o time descobre que ela parou há três semanas, e agora existem três semanas de divergência para reconciliar à mão — sem saber ao certo o que passou e o que não passou.
Faz sentido quando
- Existe integração em produção que ninguém monitora
- O mesmo dado é digitado em dois sistemas
- O legado não tem API e hoje se resolve com exportação manual
- É preciso conectar pagamento, emissão fiscal ou WhatsApp com garantia de entrega
Não faz sentido quando
- Os dois sistemas serão substituídos nos próximos meses
- O volume é tão baixo que exportação manual mensal resolve
- Não existe quem defina qual sistema é a fonte de verdade
Cada projeto pode incluir, conforme o contrato:
- Fila com retentativa, recuo exponencial e fila de descarte
- Idempotência: o mesmo evento processado duas vezes não duplica
- Contrato de API versionado e documentado
- Servidor Model Context Protocol quando o consumidor for agente de IA
- Reprocessamento de janela sem intervenção manual
- Monitoramento com alerta antes de o negócio perceber
- Camada de anticorrupção para o legado sem API
- Painel de eventos: o que entrou, o que saiu, o que falhou
Fonte de verdade
Para cada entidade, qual sistema manda. Sem isso, integração vira loop.
Contrato
O formato do evento, versionado, antes de escrever o conector.
Entrega e reentrega
Fila, idempotência e descarte desenhados para o pior caso, não para o feliz.
Observabilidade
Painel e alerta entram junto com o conector, não depois.
Corte
Convivência com o processo manual até o número bater.
| Script agendado | iPaaS | ALL MAX | |
|---|---|---|---|
| Avisa quando falha | Não | Sim | Sim, antes do negócio ver |
| Idempotente | Raro | Depende | Por desenho |
| Reprocessa janela | Manual | Parcial | Sem intervenção |
| Legado sem API | Gambiarra | Difícil | Camada anticorrupção |
| Custo por evento | Zero | Cresce com volume | Infraestrutura própria |
Integração é onde o dado atravessa fronteira:
- Credencial em cofre, rotacionada, nunca em código
- Webhook só com assinatura verificada
- Valor financeiro nunca aceito do cliente sem validação na origem
- Registro do que trafegou, sem gravar dado sensível em log
- Menor privilégio em cada conexão
Projeção modelada · não é medição
Operação com 15 a 60 mil eventos por mês entre ERP, CRM e emissão fiscal, com conciliação manual de 2 a 3 pessoas.
Números projetados a partir do perfil descrito acima, para dar ordem de grandeza. Não são resultado medido em cliente. O diagnóstico substitui esta projeção pelos seus números.
E se o sistema do outro lado mudar?
O contrato de API é versionado e a camada anticorrupção isola a mudança. Quando o outro lado quebra o contrato, quem falha é o conector — não a sua operação.
Dá para integrar sistema legado sem API?
Na maioria dos casos sim: banco, arquivo, tela ou fila. A escolha muda o risco, e a gente diz qual é antes de começar.
O que é Model Context Protocol e por que importa?
Model Context Protocol é o padrão para expor ferramenta e dado a agentes de IA de forma contratada. Quando o consumidor da integração é um agente, o protocolo evita que a regra vire prompt.
Descubra quantas integrações estão paradas agora.
O diagnóstico levanta o que existe, o que monitora e o que falha em silêncio. Costuma ser a parte mais desconfortável e a mais útil.
Agendar diagnóstico