APIs e Integrações

Dois sistemas,
dois números para a
mesma pergunta

Você já esteve nessa reunião. Uma pessoa abre o relatório do ERP e diz que outubro fechou em 1.284 vendas, outra abre o CRM e vê 1.311, e os vinte minutos seguintes viram uma discussão sobre qual dos dois números está certo, em vez de uma conversa sobre o que fazer com o resultado. Integração bem feita é o que evita essa reunião: os sistemas passam a conversar entre si com uma definição só de cada coisa, e a pergunta volta a ter uma resposta.

5 mil
→ 70 mil
transações por mês no sistema de pagamentos da Vero, que foi dimensionado para 5 mil

A mesma pergunta,
três respostas

Aqui embaixo está uma pergunta de negócio feita para os três sistemas que a empresa já tem. Os três respondem na hora, os três respondem com convicção e nenhum deles concorda com o outro. Aperta o botão para ver de onde vem cada diferença.

Relatório de vendas · outubro

Quantas vendas fechamos em outubro?

ERP

conta nota fiscal emitida 1.284

CRM

conta negócio marcado como ganho 1.311

BI

conta o que veio na carga da madrugada 1.240

Quatro divergências reais, das que aparecem em quase toda empresa.

    Repara que a maior parte do trabalho não está no cabo entre os sistemas. Está no acordo: qual é a , quem é a fonte de cada informação e o que acontece quando um lado muda o dado depois que o outro já leu. Definido isso, o código que sincroniza é a parte fácil.

    Integração que aguenta
    o volume de verdade

    Integração que passa no teste com dez registros e cai no pico da segunda-feira de manhã não resolve o problema de ninguém. A gente dimensiona para volume de produção desde o começo, deixa o monitoramento ligado o tempo todo e trata falha como parte do desenho, porque o sistema do outro lado uma hora vai falhar.

    Foi dimensionado para
    5 miltransações/mês
    No segundo mês já estava em
    22 miltransações/mês
    Hoje passa de
    70 miltransações/mês

    Esse é o motor de pagamentos que fizemos para a Vero. O volume multiplicou por catorze sem reescrita e sem parada, porque a arquitetura foi feita para crescer e porque a gente enxergava a fila subindo antes de o usuário sentir.

    O que a integração faz quando o outro lado falha

    • Ficou fora do ar a mensagem entra na fila retenta em intervalos crescentes a tela de quem vendeu não trava
    • Devolveu erro separa o erro que adianta repetir o resto vai para revisão com o motivo junto alerta para o time, com o registro inteiro
    • Ficou lento o tempo limite corta em vez de pendurar a chamada volta para a fila o monitoramento avisa antes de virar represa

    Retentativa só é segura quando repetir a mesma chamada duas vezes não cobra o cliente duas vezes, e , antes de a primeira mensagem sair. O resultado prático é que uma instabilidade de quarenta minutos na operadora de cartão vira quarenta minutos de fila, com tudo processado depois, em vez de quarenta minutos de venda perdida.

    Sem custo oculto
    e sem dependência

    A gente trabalha com tecnologia open source e entrega para você todo o código desenvolvido, junto com os testes. Na prática isso quer dizer que a integração roda na infraestrutura que você escolher, que não tem licença por conector nem por volume de mensagem, e que se um dia você quiser trocar de time, você troca: outro time recebe o repositório e continua de onde parou.

    Plataforma de integração por assinatura

    • A conta é por execução ou por tarefa, então ela sobe justamente quando a integração dá certo e o volume cresce.
    • Conector novo costuma ter preço próprio, e às vezes só existe no plano de cima.
    • O fluxo mora dentro da plataforma. Saindo de lá, ele não vem junto.
    • A renovação chega com reajuste quando a operação já depende daquilo para funcionar.
    vs

    Integração feita em open source

    • Python, Linux e Node.js. O custo é o do desenvolvimento e o da máquina que roda, e ele não cresce por mensagem trocada.
    • Cada sistema novo que entra é trabalho de desenvolvimento, com prazo e preço conhecidos na hora de decidir.
    • O código é seu, entregue com os testes automatizados que provam que ele faz o que promete.
    • Sem renovação para negociar: o que está no ar continua no ar, independente de contrato com a gente.

    Sendo justo com elas: as plataformas de assinatura resolvem rápido, e para uma automação pequena entre dois sistemas populares elas costumam ser a escolha sensata. O problema aparece quando aquele fluxo vira espinha dorsal da operação. Aí o volume cresce, a conta cresce junto e a regra de negócio que mais importa para a empresa está morando num lugar que não é seu.

    Quer comparar com o que você paga hoje? Manda o número

    Você acompanha
    enquanto a gente faz

    Cada fase do projeto fica visível, com você decidindo junto. Isso importa mais em integração do que em qualquer outro tipo de projeto, porque integrar exige conhecer o processo interno de verdade: o campo de texto livre que o comercial usa como semáforo, o estágio do funil que mudou de significado ano passado, a planilha que alguém mantém porque o sistema nunca cobriu aquele caso. Nada disso está documentado, e a conversa com quem opera acontece o projeto inteiro.

    1. Dia 1 A gente senta com quem usa os dois sistemas todo dia e pergunta o que cada campo quer dizer na prática. Em geral é aqui que aparecem os combinados informais que nenhum manual registra.
    2. Dia 3 Ambiente, credenciais de homologação dos dois lados e os primeiros testes automatizados rodando, antes de o primeiro campo sincronizar.
    3. Dia 7 A primeira ponte de pé em homologação, com dado de verdade dos dois lados. As divergências aparecem aqui, na frente de vocês, e vocês decidem qual regra vale.
    4. Dia 14 Primeiro go live: um fluxo sincronizando em produção, com monitoramento e alerta ligados. Dali para frente cada sprint de duas semanas põe mais um pedaço no ar.

    No fim de cada sprint você vê o que está rodando, olha os números da sincronização e diz o que entra no sprint seguinte. E não tem gerente de conta no meio do caminho: quem responde a sua mensagem é quem está escrevendo a integração.

    Quem já ajudamos

    Três integrações que estão em produção, com os números que os clientes toparam publicar.

    Vero Internet

    Telecom · parceria desde 2019
    Não conformidade de dados
    62% → 1,5%
    Billings sob um login único
    7
    Pagamentos por mês
    5 mil → 70 mil

    Integramos o ecossistema inteiro: os CRMs, o ERP, os serviços de terceiros, o sistema de vendas, o site, a área do cliente e o app. A orquestração dos múltiplos CRMs roda em Python com FastAPI, e é ela que faz um login só funcionar por cima de sete billings diferentes, que antes nem se conheciam.

    Alper Seguros

    Seguros
    Tempo de cotação
    dias → minutos

    Com as seguradoras que têm API, a integração é por API. As que só operam por e-mail a gente integrou por RPA, com um robô fazendo o mesmo caminho que a pessoa fazia à mão. Para quem cota, as duas respondem igual.

    Whirlpool

    Indústria · Brastemp e Consul
    Chave da integração
    CPF

    O Visie Flow conversa com o CRM e com o ERP pelo CPF do consumidor, então o atendimento já começa sabendo qual produto é, quando foi comprado e o que já tinha acontecido naquele chamado.

    Qual pergunta da sua empresa
    tem duas respostas hoje?

    Pode ser o faturamento do mês, o número de clientes ativos, o estoque disponível, a quantidade de chamados em aberto. Traz essa pergunta para a primeira conversa e a gente olha junto de onde vem cada resposta, o que cada sistema está contando e quais deles precisariam conversar para sobrar um número só. Dessa conversa já dá para sair com um primeiro passo desenhado, com prazo e preço.