Como integrar dois sistemas que não conversam
Integrar começa por duas decisões que não são técnicas: descobrir o que cada ferramenta abre — API, webhook ou só exportação de arquivo — e definir quem é o dono de cada informação quando os dois discordam. Sem dono definido, os sistemas sobrescrevem um ao outro. E toda integração precisa avisar quando falha.
Comece descobrindo o que cada ferramenta abre
Antes de desenhar qualquer coisa, a pergunta é o que cada lado permite. Um sistema com API documentada é barato de ligar. Um sistema sem API e sem exportação útil pode custar mais que o resto do projeto — e às vezes a resposta honesta é que não dá.
Isso se descobre em uma tarde, lendo a documentação e pedindo uma credencial de teste. É a primeira coisa a fazer, e é o que evita descobrir no meio do projeto que a ponte não tem do outro lado.
Decida quem manda em cada informação
Esta é a decisão que define a integração, e quase nunca é técnica. Se o cadastro do cliente existe no ERP e no CRM, e alguém muda o telefone nos dois, qual valor vale?
A resposta precisa ser explícita, informação por informação:
- Um dono por dado. O sistema dono grava; os outros recebem. Sem isso, os dois sobrescrevem um ao outro em looping.
- Mão única sempre que possível. Integração nos dois sentidos custa mais e quebra mais. Só vale quando as duas pontas realmente editam.
- Uma chave estável para casar registros. Nome de empresa não serve: muda, tem acento, vem com e sem "Ltda". CNPJ, e-mail ou um identificador do próprio sistema servem.
Tempo real ou de tempos em tempos
Depende de quanto o atraso custa. Um lead de formulário precisa chegar na hora — meia hora de espera já esfria o contato. Conferência de faturamento do dia anterior pode rodar de madrugada, e vai custar menos para manter.
A pergunta que resolve: o que acontece de errado se este dado chegar uma hora depois? Se a resposta for "nada", não pague por tempo real.
Os três caminhos, do mais direto ao último recurso
Webhook
A ferramenta avisa quando algo muda. É o mais eficiente: nada de perguntar de minuto em minuto se houve novidade, e o dado chega no momento do fato. Quando existe, é por aqui.
API
Você pergunta e ela responde. Serve para buscar o que mudou desde a última vez e para gravar do outro lado. É o caminho mais comum, e o que dá mais controle sobre o que acontece quando algo falha.
Arquivo
Sem API nem webhook, resta exportação agendada. Funciona, mas é o que mais quebra: formato que muda sem aviso, acento que vira símbolo, coluna nova no meio. Se for o único caminho, vale tratar o arquivo como entrada hostil — validar antes de gravar.
O erro mais caro: falhar em silêncio
Uma integração que para de funcionar e não avisa é pior do que integração nenhuma. Sem ela, alguém confere na mão e sabe que está conferindo. Com ela quebrada, ninguém confere — todo mundo acredita que o dado passou.
O mínimo é: registro que não passou fica numa fila, a fila tenta de novo, e alguém é avisado quando a tentativa falha de novo. Se a proposta que você recebeu não fala disso, pergunte antes de assinar.
Quando não integrar
Nem toda dor de redigitação vale uma integração. Se o volume é de cinco registros por semana, o custo de construir e manter a ponte passa o custo de digitar. Se o processo ainda está mudando, integrar agora é amarrar duas coisas instáveis.
E se a ferramenta atual é a própria trava — se ela não abre nada e ainda impede o que a empresa precisa fazer —, a conversa não é de integração: é de substituir.
Um exemplo que dá para abrir
A integração mais simples que existe é a de um formulário de site com um CRM, e é a que mais se vê quebrada — o lead cai numa caixa de entrada compartilhada, ou num e-mail que ninguém lê. Deixamos a nossa aberta para teste: preencha o formulário da demonstração e veja o lead nascer no funil, com a origem junto.
É o mesmo princípio de qualquer integração maior: um dono para o dado, confirmação de que ele chegou, e nada de intermediário que possa esquecer.