Integração de sistemas: como fazer ferramentas diferentes trabalharem como uma única operação
O que é integrar de verdade (e o que é só conectar), os três padrões que usamos — API, evento e sincronização —, o papel da camada própria entre você e cada fornecedor, e os erros que transformam integração em nova fonte de problema.
por Baruk Connect · publicado em · 6 min de leitura
Toda empresa que cresceu acumulou ferramentas: um ERP, uma planilha de comissão, um WhatsApp para atendimento, uma plataforma de anúncios, um sistema de cobrança. Cada uma resolve o seu pedaço e nenhuma conversa com a outra. O resultado é o retrabalho mais comum que existe: alguém copia dado de uma tela para outra, todo dia, e confere à mão o que já estava no computador.
Integrar é resolver isso — mas 'integrar' virou palavra tão usada que perdeu o sentido. Este artigo explica o que é integração de verdade, os três padrões que usamos, por que colocamos uma camada nossa entre a operação e cada fornecedor, e como uma integração mal feita vira o próximo problema.
Conectar não é integrar
Conectar é transportar dado de A para B. Integrar é garantir que o dado chegue com o mesmo significado (o 'cliente' de um sistema é o mesmo 'cliente' do outro), no momento certo (antes de a próxima etapa precisar dele), com registro (dá para saber o que passou, quando, e o que falhou) e com regra (o que fazer quando o dado vem incompleto ou duplicado).
Um conector genérico resolve o transporte. O significado, o tempo, o registro e a regra continuam sendo problema seu — e é neles que a operação quebra.
Os três padrões — sem virar tutorial
Praticamente toda integração cai em um de três padrões. Entender qual usar evita metade dos erros.
| Padrão | O que é, em português | Quando usar | Exemplo na nossa operação |
|---|---|---|---|
| Chamada de API | Um sistema pergunta, o outro responde, na hora | Quando a resposta precisa vir agora e a pergunta é pontual | Durante uma ligação, o agente de voz consulta o pedido e o histórico do cliente no sistema |
| Evento (webhook) | Um sistema avisa 'aconteceu isto'; quem quiser reage | Quando várias coisas precisam acontecer depois de um fato, sem que o primeiro sistema saiba quais | Pagamento confirmado → o gateway avisa → o sistema dá baixa, avisa o cliente e atualiza a régua |
| Sincronização | Manter duas cópias do mesmo dado iguais, de tempos em tempos | Quando o outro sistema não avisa e não responde na hora (ou você não controla ele) | Verificar a caixa de e-mail a cada 30 minutos e importar os pedidos novos, com quatro camadas contra duplicidade |
A camada própria: o que fica entre você e cada fornecedor
Esta é a decisão que mais separa uma integração que dura de uma que vira dívida. Em vez de espalhar chamadas ao fornecedor por todo o sistema, colocamos uma camada nossa — um contrato — entre a operação e cada serviço externo. A operação fala com a camada; a camada fala com o fornecedor.
Três consequências práticas. Trocar de fornecedor vira configuração, não reescrita: a telefonia pode mudar sem que a lógica de campanha mude. A falha de um fornecedor fica contida: a camada sabe tentar de novo, esperar, ou parar. E a segurança fica num lugar só: o aviso que chega do fornecedor tem a assinatura conferida antes de a operação agir — um guard.
No nosso ecossistema são vinte e cinco provedores externos — telefonia, voz, mensagem, pagamento, banco, arquivos, modelos de IA, hospedagem — e vinte e cinco camadas de integração, uma para cada. Usar um fornecedor não significa possuir a tecnologia dele; construir em cima dele política, roteamento, retry, guards e integração com dado próprio — isso é propriedade tecnológica.
Teste: se para trocar de fornecedor de mensagem você precisaria mexer em mais de um lugar do seu sistema, você não tem uma camada. Tem acoplamento.
O dado precisa de um dono
Toda integração precisa responder: qual sistema é a fonte de verdade de cada dado? O cadastro do cliente mora onde? O status do pedido é decidido por quem? Sem essa resposta, dois sistemas passam a discordar e alguém volta a conferir à mão — exatamente o que a integração devia eliminar.
A regra simples: um dado, um dono, e os outros sistemas recebem cópia. Quando dois sistemas precisam escrever o mesmo dado, é sinal de que o processo não foi desenhado.
Erros que transformam integração em problema
- Integrar sem regra de duplicidade: o mesmo pedido entra duas vezes e ninguém percebe até a comissão sair errada.
- Integrar sem registro: quando falha, não dá para saber o que passou e o que ficou para trás.
- Confiar no aviso do fornecedor sem conferir a assinatura: qualquer um que descubra a URL dispara ação no seu sistema.
- Responder 'recebido' antes de gravar: o fornecedor acha que entregou, você não gravou, e não existe segunda tentativa.
- Espalhar a chamada ao fornecedor pelo sistema inteiro, em vez de uma camada só.
- Sincronizar tudo a cada minuto 'por segurança' — e derrubar o sistema do outro lado.
Por onde começar
Liste as ferramentas que a sua operação usa e, para cada par que troca dado, responda: quem é o dono desse dado? Como o dado passa hoje (alguém digita)? O que acontece quando falha? A integração mais valiosa é a que elimina a digitação mais frequente — e ela costuma ser uma sincronização simples, com regra de duplicidade e registro, não um projeto de meses.
Perguntas frequentes
API, webhook e sincronização — qual é o melhor?
Nenhum é melhor em geral. API quando a resposta precisa vir na hora; webhook quando um fato dispara várias reações; sincronização quando o outro sistema não avisa nem responde e você não o controla. A maior parte das operações usa os três.
Preciso trocar minhas ferramentas para integrá-las?
Normalmente não. Integração existe justamente para manter o que funciona e fazer as peças conversarem. Trocar ferramenta é decisão separada, que só faz sentido quando ela é o gargalo.
Integração é segura?
É tão segura quanto a camada que fica entre você e o fornecedor. Assinatura conferida antes de agir, registro de tudo que passa, e uma política de retry e parada — isso é o mínimo. Sem isso, uma integração é uma porta aberta.
Tem uma operação que deveria virar sistema?
Já fizemos isso com a nossa. Veja o que construímos e operamos.