O que é uma API e para que ela serve numa automação

A palavra aparece em toda proposta de automação, em toda reunião com fornecedor de software e em toda conversa sobre integração. Quase sempre sem tradução. O dono da empresa concorda com a cabeça, aprova o orçamento e segue sem saber exatamente o que comprou.

Vale gastar dez minutos entendendo, porque a existência ou não de uma API decide o que a sua automação vai conseguir fazer, quanto ela vai custar e quais promessas você deve recusar.

Um controle remoto do sistema

API é um conjunto de comandos que um sistema aceita receber de outro sistema.

Pense num controle remoto. Ele tem um número fixo de botões. Cada botão faz uma coisa específica: aumentar volume, trocar de canal, desligar. Você não consegue fazer nada que não esteja nos botões, e não precisa saber nada sobre a eletrônica da televisão para usar. O fabricante decidiu quais botões existem.

Uma API funciona assim. O fornecedor do seu sistema de gestão decide quais comandos ficam disponíveis: consultar cliente por CPF, listar pedidos do dia, criar uma ordem de serviço. Quem tem a credencial certa aperta esses botões por software, sem abrir tela nenhuma.

Isso muda a natureza da automação. Sem API, um robô precisa imitar uma pessoa: abrir o programa, clicar, digitar, ler a tela. Com API, o pedido vai direto, em milissegundos, sem depender de nada visual.

As cinco partes que aparecem em qualquer integração

Quando um técnico fala de integração, ele está falando destas cinco coisas.

O endereço. Cada comando tem um endereço próprio, o que o pessoal chama de endpoint. Um endereço para consultar pedido, outro para criar pedido, outro para cancelar. É por isso que "o sistema tem API" nunca é resposta suficiente: a pergunta certa é se existe endereço para o comando específico que o seu projeto precisa.

A chave. Toda chamada carrega uma credencial que identifica quem está pedindo. Essa chave define permissão, e é a peça que quase nunca é discutida na venda e sempre deveria ser. A chave da sua automação não precisa poder tudo o que o seu usuário administrador pode.

O pedido e a resposta. A automação manda um pedido curto e recebe de volta um pacote de dados padronizado. Não vem uma tela bonita, vem informação bruta que outro programa lê. Esse padrão é o que permite montar fluxo em cima.

O limite. Quase toda API tem teto de chamadas por minuto, e várias cobram por volume. Isso não inviabiliza projeto de PME, mas explica por que um relatório que consulta o sistema a cada dez segundos é uma péssima ideia.

O aviso de volta. Existe o caminho inverso, chamado webhook: em vez da sua automação ficar perguntando "já pagou? já pagou?", o outro sistema avisa no instante em que o pagamento cai. Trocar pergunta repetida por aviso é uma das mudanças que mais reduz custo e atraso num fluxo, e é a que menos gente pede.

Seis usos que realmente agregam valor

Integração por integração não serve para nada. O que justifica o trabalho é uma destas seis situações.

1. Responder dado atual dentro da conversa. O cliente pergunta no WhatsApp se o carro dele já ficou pronto. A automação consulta a ordem de serviço e responde na hora, com a informação que estava no sistema um segundo atrás.

2. Gravar sem digitação dupla. O que foi combinado na conversa entra direto no sistema, sem alguém depois transcrever de um lugar para outro. A digitação dupla é onde nasce a maior parte dos erros de cadastro numa PME.

3. Preencher cadastro sozinho. CNPJ, endereço por CEP, dados públicos de empresa. Campo que uma pessoa levaria três minutos preenchendo à mão vem completo e sem erro de digitação.

4. Transformar evento em ação. Pagamento confirmado dispara a emissão da nota. Peça recebida dispara o aviso ao cliente. Aqui o ganho não é velocidade, é deixar de depender de alguém lembrar.

5. Cruzar duas fontes que ninguém cruza. Pedidos de um lado, pagamentos do outro, conferência batendo os dois todo dia de manhã. É um trabalho que ninguém gosta de fazer e que quase sempre está atrasado.

6. Levar o dado até onde a decisão acontece. Número que mora dentro do sistema e ninguém abre vale pouco. O mesmo número chegando num painel ou numa mensagem de segunda-feira muda comportamento.

Numa oficina mecânica com seis elevadores, esses seis usos viram algo bem concreto: consulta de status pelo WhatsApp, orçamento aprovado virando ordem de serviço sem redigitação, cadastro de cliente novo preenchido pela placa, aviso automático quando a peça chega, conferência diária entre serviço entregue e pagamento recebido, e um resumo de segunda com os carros parados há mais de três dias esperando peça.

O que não vale integrar

Nem toda ligação entre sistemas se paga. Três casos onde costumamos recomendar deixar como está.

Quando o volume é baixo. Integrar um processo que acontece duas vezes por semana e leva cinco minutos custa mais em manutenção do que economiza em tempo.

Quando o dado tolera atraso. Se uma exportação diária resolve, não construa uma integração ao vivo. A versão simples quebra menos.

Quando ninguém é dono do processo do outro lado. Automação conectada a um processo que muda toda semana, sem responsável definido, vira manutenção infinita.

Três perguntas antes de aprovar uma integração

Existe endereço na API para o comando exato que esse fluxo precisa, ou só para os vizinhos dele.

Quais permissões a chave da automação vai ter, e quem revoga essa chave se for preciso.

Quando o outro sistema estiver fora do ar, o que a automação faz: espera, avisa alguém ou finge que deu certo.

A terceira pergunta é a que mais separa integração bem feita de integração que funciona só nos dias bons.