castomFLOW
Abrir castomFLOW

Conectar cualquier cosa

HTTP de entrada, HTTP de salida, las partes incómodas resueltas

Toda herramienta de automatización anuncia un número de integraciones. El número siempre es grande y siempre es la pregunta equivocada, porque el sistema que realmente necesitas es el que se construyó internamente en 2014 por alguien que ya se fue. Lo que importa es lo bien que la herramienta habla el protocolo que hay debajo de todos ellos.

Las conexiones ya preparadas

Las aplicaciones en las que se basan la mayoría de las empresas tienen pasos preparados: tiendas y marketplaces, contabilidad y facturación, hojas de cálculo y bases de datos, calendarios y correo, almacenamiento y mensajería, CRM y helpdesks, proveedores de pago y transportistas. Autorizas la cuenta una vez y los campos se nombran en el idioma que usa la aplicación, no en el idioma de su JSON.

Cuando una aplicación tiene una particularidad del mercado polaco — un sistema de facturación que debe estar listo para KSeF, un transportista cuyas etiquetas son un estándar nacional — el paso preparado lo sabe, porque la familia vende en ese mercado y tuvo que aprenderlo.

Y luego el caso general

Todo lo demás es un paso HTTP, y un paso HTTP aquí no es un premio de consolación. Es la misma maquinaria sobre la que se construyen las conexiones preparadas, con el mismo manejo de las partes que son tediosas de escribir por ti mismo.

Las partes tediosas

Resueltas, para que no las escribas de nuevo

Autenticación

Claves de API, tokens bearer, autenticación básica, OAuth 2 con refresco, firma de peticiones HMAC, TLS mutuo. Una credencial se guarda una vez, se referencia por nombre y nunca se imprime en un registro ni en una ejecución.

Paginación

Cursores, números de página, offsets, cabeceras Link y la API que señala el final devolviendo un array vacío. Di qué forma es y el paso recorre todo el conjunto.

Límites de tasa

Un techo por conexión, respetado en todos los flujos de trabajo que la usan. Cuando un proveedor responde 429 con un Retry-After, el paso espera ese tiempo en lugar de insistir a martillazos.

Reintentos y backoff

Los fallos transitorios se reintentan con un intervalo creciente y un tope. Un paso es una función pura de sus entradas, así que un reintento vuelve a ejecutar el paso, no la ejecución entera.

Cargas incómodas

JSON, codificación de formularios, XML, texto plano, subidas multipart. Las respuestas se analizan en campos que puedes referenciar por nombre, incluidos los que están anidados cuatro niveles más abajo.

Tiempos de espera

Un límite por paso, de modo que una dependencia lenta no pueda retener a un trabajador mientras todo lo que va detrás hace cola. Qué ocurre al alcanzar el límite lo decides tú, paso a paso.

Si habla HTTP, la conversación ya ha empezado.

Webhooks entrantes, tomados en serio

Cada flujo de trabajo puede tener una URL que lo inicie. Esa URL verifica firmas — HMAC en las formas que usan los proveedores habituales, y un secreto compartido donde eso es todo lo que el remitente puede ofrecer. Una solicitud sin firma a un flujo que espera una firma se rechaza y se registra, no se procesa en silencio.

La deduplicación se basa en el identificador propio de la carga, así que un remitente que reintenta porque no vio tu 200 a tiempo obtiene una ejecución en lugar de tres. Las cargas malformadas se conservan, con el motivo del rechazo, porque la causa más común de un hueco misterioso en una automatización es un remitente que cambió de opinión sobre un campo.

Los sistemas que solo hablan CSV

Existen. Un archivo aparece en un servidor SFTP a las cuatro de la madrugada, o llega como adjunto, o se suelta en una carpeta compartida. Un flujo de trabajo puede vigilarlo, leerlo y tratar cada fila como un registro — incluido el archivo con marca de orden de bytes, separadores de punto y coma y una fila de encabezados en polaco, porque así es como es la exportación de verdad.

El camino inverso también funciona: un flujo de trabajo puede ensamblar un archivo y dejarlo donde el otro sistema espera encontrarlo, que con frecuencia es la única interfaz que tiene un software de 2006.

Feed nocturno de proveedorSFTP → HTTP
  • ⚡ActivadorNuevo archivo en el SFTP del proveedor: stock-2026-09-09.csv.
  • 2AnalizarPuntos y comas, marca de orden de bytes, encabezados en polaco. 4 118 filas.
  • 3NormalizarCódigos de moneda verificados contra datos de referencia; dos rechazados como no válidos.
  • 4SubirHTTP PATCH en lotes de 200, respetando el límite de tasa.
  • !ExcepcionesDos filas archivadas para una persona, con el número de fila y el motivo. Las otras 4 116 pasaron sin problemas.

Pasos que llamaron a un modelo: 0Coste de esta ejecución: nada

Dónde viven las credenciales

Cifradas, referenciadas por nombre, con ámbito limitado al espacio de trabajo que las posee, y nunca mostradas en un registro de ejecución, un mensaje de error o una conversación de soporte. Un registro de ejecución muestra que un paso se autenticó como supplier-sftp; no muestra qué es supplier-sftp.

Una agencia que ejecuta un flujo de trabajo para treinta clientes da a cada cliente su propio conjunto de credenciales, y el flujo se refiere al conjunto en lugar del secreto. Rotar una clave es una sola edición en un solo lugar — que es la mayor razón por la que las agencias vienen aquí.

El límite que conviene conocer: un sistema sin ninguna interfaz — sin API, sin webhook, sin depósito de archivos, nada más que una persona haciendo clic en un navegador — no puede automatizarse con esto ni con nada honesto. Aquí no hay navegador headless fingiendo ser un usuario, porque eso se rompe la primera vez que la otra parte mueve un botón, y se rompe en silencio.