Ligar qualquer coisa

HTTP a entrar, HTTP a sair, as partes difíceis tratadas

Todas as ferramentas de automação anunciam um número de integrações. O número é sempre grande e é sempre a pergunta errada, porque o sistema de que realmente precisas é aquele construído internamente em 2014 por alguém que já saiu. O que importa é quão bem a ferramenta fala o protocolo por baixo de todas elas.

As ligações prontas a usar

As aplicações em que a maioria das empresas trabalha já têm passos preparados: lojas e marketplaces, contabilidade e faturação, folhas de cálculo e bases de dados, calendários e e-mail, armazenamento e mensageria, CRMs e helpdesks, provedores de pagamento e transportadoras. Autorizas a conta uma vez e os campos têm os nomes que a aplicação usa, não os do seu JSON.

Quando uma aplicação tem uma particularidade do mercado polaco — um sistema de faturação que tem de estar pronto para o KSeF, uma transportadora cujas etiquetas são uma norma nacional —, o passo preparado já sabe disso, porque a família vende nesse mercado e teve de aprender.

E depois o caso geral

Tudo o resto é um passo HTTP, e um passo HTTP aqui não é um prémio de consolação. É a mesma maquinaria sobre a qual as ligações preparadas são construídas, com o mesmo tratamento das partes tediosas de escrever à mão.

As partes tediosas

Tratadas, para não as teres de escrever outra vez

Autenticação

Chaves de API, bearer tokens, autenticação básica, OAuth 2 com refresh, assinatura HMAC de pedidos, TLS mútuo. Uma credencial é guardada uma vez, referenciada pelo nome, e nunca impressa num log ou num registo de execução.

Paginação

Cursores, números de página, offsets, cabeçalhos Link, e a API que sinaliza o fim devolvendo um array vazio. Dizes qual é o formato e o passo percorre o conjunto inteiro.

Limites de taxa

Um teto por ligação, respeitado em todos os fluxos de trabalho que a usam. Quando um provedor responde 429 com um Retry-After, o passo espera esse tempo em vez de martelar.

Tentativas e backoff

Falhas transitórias repetidas com um intervalo crescente e um limite. Um passo é uma função pura das suas entradas, por isso uma repetição volta a executar o passo, não a execução inteira.

Payloads complicados

JSON, codificação de formulários, XML, texto simples, uploads multipart. Respostas analisadas em campos que podes referenciar pelo nome, incluindo os que estão aninhados quatro níveis abaixo.

Tempos limite

Um limite por passo, para que uma dependência lenta não possa ocupar um worker enquanto tudo o que vem depois fica em fila. O que acontece quando o limite é atingido é decisão tua, passo a passo.

Se fala HTTP, a conversa já começou.

Webhooks de entrada, a sério

Todos os fluxos de trabalho podem ter um URL que os inicia. Esse URL verifica assinaturas — HMAC nos formatos que os provedores comuns usam, e um segredo partilhado quando é tudo o que o remetente consegue. Um pedido não assinado a um fluxo que espera uma assinatura é rejeitado e registado, não processado em silêncio.

A desduplicação usa o identificador do próprio payload, por isso um remetente que repita o envio porque não viu o teu 200 a tempo obtém uma execução em vez de três. Payloads malformados são guardados, com o motivo da rejeição, porque a causa mais comum de uma lacuna misteriosa numa automação é um remetente que mudou de ideias sobre um campo.

Os sistemas que só falam CSV

Existem. Um ficheiro aparece num servidor SFTP às quatro da manhã, ou chega como anexo, ou é largado numa pasta partilhada. Um fluxo de trabalho pode vigiá-lo, lê-lo e tratar cada linha como um registo — incluindo o ficheiro com byte-order mark, separadores de ponto e vírgula e uma linha de cabeçalho em polaco, porque é assim que a exportação realmente aparece.

No sentido contrário também funciona: um fluxo de trabalho pode montar um ficheiro e colocá-lo onde o outro sistema espera encontrá-lo, o que é frequentemente a única interface que um software de 2006 tem.

Feed noturno de fornecedorSFTP → HTTP

⚡Gatilho04:02Novo ficheiro no SFTP do fornecedor: stock-2026-09-09.csv.
2AnalisarPonto e vírgula, byte-order mark, cabeçalhos em polaco. 4 118 linhas.
3NormalizarCódigos de moeda verificados contra dados de referência; dois rejeitados como inválidos.
4Push2.9 sHTTP PATCH em lotes de 200, limite de taxa respeitado.
!ExceçõesDuas linhas arquivadas para uma pessoa, com o número da linha e o motivo. As outras 4 116 passaram.

Passos que chamaram um modelo: 0Custo desta execução: nada

Onde vivem as credenciais

Encriptadas, referenciadas pelo nome, delimitadas ao workspace que as possui, e nunca apresentadas num log de execução, numa mensagem de erro ou numa conversa de suporte. Um registo de execução mostra que um passo se autenticou como supplier-sftp; não mostra o que é o supplier-sftp.

Uma agência que executa um fluxo de trabalho para trinta clientes dá a cada cliente o seu próprio conjunto de credenciais, e o fluxo refere o conjunto em vez do segredo. Rodar uma chave é uma edição num único sítio — o que é a maior razão pela qual as agências vêm para aqui.

O limite que vale a pena conhecer: um sistema sem qualquer interface — sem API, sem webhook, sem ficheiro, nada além de uma pessoa a clicar num browser — não pode ser automatizado por isto nem por mais nada honesto. Aqui não há browser headless a fingir ser um utilizador, porque isso parte-se da primeira vez que o outro lado muda um botão de sítio, e parte-se em silêncio.