La peor falla de una integración no es la que hace ruido: es la que no avisa. Un pago confirmado que nunca llega a contabilidad, una inscripción que no pasa de un formulario a la hoja de cálculo, un boletín que no sale por correo. Nadie ve un error en pantalla; el problema aparece semanas después, cuando una familia reclama o cuando no cuadra el cierre del mes.
Hoy casi todo está conectado con todo: la pasarela de pagos con la facturación, el formulario con la plataforma académica, la tienda con el correo. Cada conexión (una API, un webhook, un archivo programado) es un punto donde la información puede perderse, duplicarse o llegar tarde. Este artículo explica cómo diseñar integraciones que fallen a la vista, con un ejemplo en código que ejecuté, un inventario de integraciones en Excel y la demostración en Python. Fuentes verificadas el 9 de octubre de 2026.
Resumen. Una integración confiable hace cinco cosas: verifica de dónde viene el mensaje, confirma rápido, no duplica aunque el mensaje llegue dos veces, reintenta los fallos temporales y avisa a una persona cuando algo no se pudo procesar. Lo demás es inventariar y asignar responsables.
Cómo fallan en silencio
Seis formas típicas, ninguna con mensaje de error visible:
- El destino estuvo caído un rato y el mensaje se perdió, porque nadie reintentó.
- El mensaje llegó dos veces y se registró dos pagos o dos matrículas.
- Los mensajes llegaron en otro orden y un estado "pagado" fue pisado por uno más viejo.
- Cambió un campo en la API del proveedor y la integración sigue "funcionando", pero con datos vacíos.
- Venció una credencial o un certificado y desde ese día todo falla sin avisar.
- Quien la hizo se fue y nadie sabe que existe.
Lo que ya advierte un proveedor serio
La documentación de webhooks de Stripe, que cito como ejemplo de buenas prácticas (otros proveedores tienen reglas propias), dice varias cosas que aplican a casi cualquier integración: en modo real reintenta la entrega hasta por tres días con espera exponencial; el mismo evento puede llegar más de una vez y se recomienda registrar los identificadores de los eventos ya procesados; no garantiza el orden de entrega; el endpoint debe responder 2xx rápido, antes de la lógica pesada, y procesar en una cola; y hay que verificar la firma de cada mensaje para evitar eventos falsos.

Traduzco: si tu sistema depende de un mensaje que llega una sola vez, en orden y sin fallas, está mal diseñado, sin importar quién sea el proveedor.
El flujo en cinco pasos

- Verifica. Comprueba la firma, el secreto compartido o el origen antes de actuar. Sin esto, cualquiera podría enviar un "pago confirmado" falso.
- Guarda y confirma. Registra el evento y responde 2xx de inmediato; si haces el trabajo pesado antes de responder, el proveedor puede dar el envío por fallido y reenviarlo.
- Procesa sin duplicar (idempotencia). Usa el identificador del evento: si ya lo viste, no lo apliques otra vez.
- Reintenta lo temporal. Con espera creciente y un poco de azar, para no golpear al destino todos a la vez. No reintentes errores permanentes (un pedido que no existe no va a existir mañana).
- Alerta y guarda lo fallido. Lo que no se pudo procesar va a una cola y avisa a una persona con nombre.
Un ejemplo ejecutado
Escribí una demostración de unas 90 líneas en Python (solo biblioteca estándar) que simula un proveedor enviando seis eventos: dos repetidos, uno con un fallo temporal del sistema contable y uno con un error permanente. Estas son las partes clave:
def recibir(evento):
"""Punto de entrada del webhook: idempotente."""
try:
db.execute("INSERT INTO procesados VALUES (?,?)", (evento["id"], time.time()))
except sqlite3.IntegrityError:
print(f"{evento['id']}: duplicado, se ignora (ya procesado)")
return
con_reintentos(evento)
def con_reintentos(evento, maximo=4, base=0.01):
for n in range(1, maximo + 1):
try:
aplicar_pago(evento)
return True
except ConnectionError as e: # temporal: reintentar
espera = base * (2 ** (n - 1)) + random.uniform(0, base)
time.sleep(espera)
except ValueError as e: # permanente: a la cola y alertar
db.execute("INSERT INTO fallidos VALUES (?,?,?)", (evento["id"], str(e), n))
alertar(f"evento {evento['id']} a cola de fallidos: {e}")
return False
alertar(f"evento {evento['id']} agotó {maximo} intentos")
return False
Y esta es la salida real al ejecutarla:
evt_1: nuevo, se procesa
evt_2: nuevo, se procesa
evt_1: duplicado, se ignora (ya procesado)
evt_3: nuevo, se procesa
intento 1 falló (el sistema contable no respondió); espero 0.013 s
intento 2 falló (el sistema contable no respondió); espero 0.022 s
evt_2: duplicado, se ignora (ya procesado)
evt_5: nuevo, se procesa
ALERTA: evento evt_5 a cola de fallidos: pedido inexistente en el sistema (error permanente)
Pagos aplicados: (3, 250000)
Eventos fallidos: [('evt_5', 'pedido inexistente en el sistema (error permanente)')]
Alertas enviadas: 1
Los dos eventos repetidos se ignoraron; el que falló dos veces de forma temporal se aplicó al tercer intento (los 3 pagos suman 250.000, no 450.000); y el error permanente quedó en la cola de fallidos con una alerta. Una advertencia honesta: esta demostración marca el evento como procesado al recibirlo, para que se vea con claridad la idempotencia. En producción es mejor guardar un estado por evento (recibido, procesado, fallido) y marcarlo "procesado" solo cuando el trabajo termina, para no perder un evento que falló a mitad de camino.
Inventaria tus integraciones
Antes de mejorar el código, haz una lista. El libro descargable trae un inventario con columnas para el responsable, si hay alerta, si reintenta, si evita duplicados, si verifica el origen y la fecha de la última revisión; calcula un riesgo por integración. Con los datos de ejemplo, 3 de las 6 integraciones quedan en riesgo alto: una sin alerta ni reintentos, otra sin ningún control y otra sin responsable. La hoja "Plan_de_falla" trae nueve preguntas para cada integración crítica, como "¿cuánto tardaríamos en enterarnos?" y "¿cómo reprocesamos lo perdido?".
Un detalle: la columna de días desde la revisión usa la fecha de hoy, así que el riesgo cambia con el tiempo; es intencional, para que una integración que nadie revisa suba de riesgo sola.
Qué monitorear
| Señal | Qué indica | Acción |
|---|---|---|
| Eventos recibidos por día | Si cae a cero o se dispara, algo cambió | Alerta por desviación frente al promedio |
| Eventos en cola de fallidos | Trabajo que nadie ha atendido | Revisión diaria y responsable |
| Tiempo desde el último evento | Una integración "muda" | Alerta si pasa más de lo esperable |
| Vencimiento de credenciales | Una caída anunciada | Calendario de renovación |
| Conciliación diaria | Diferencias entre origen y destino | Compara totales de ambos lados |
La conciliación es la red de seguridad final: aunque todo lo anterior falle, comparar cada día el total de pagos de la pasarela con el de la contabilidad te dice si algo se perdió (ver el artículo sobre controles en Excel para hacerlo con una fórmula).
Colombia, Latinoamérica y el mundo
En el mundo, las integraciones entre servicios en la nube se volvieron la columna vertebral de casi cualquier operación. En Colombia y Latinoamérica el riesgo se agrava por dos razones frecuentes: muchas integraciones las armó un proveedor externo o una persona que ya no está, y no hay presupuesto para monitoreo, así que se descubren las fallas cuando un cliente reclama. En un colegio, la integración que falla es un boletín que no llega, una matrícula que no se refleja o un cobro que no se aplica. Para los directivos, la pregunta es quién responde por cada integración; para el personal administrativo y docente, tener un procedimiento manual de respaldo; y para las familias, que un error técnico no se convierta en un cobro indebido o un dato perdido (ver errores básicos de seguridad y agentes de IA con acceso a tus sistemas, que también conectan sistemas entre sí).
Herramientas para empezar con orden
Si tu necesidad es facturar y enviar documentos a clientes por correo sin armar una integración compleja, esta plantilla en Excel resuelve el proceso completo en tu equipo. Y si en tu colegio manejas documentos sensibles de estudiantes, PIAR con IA los guarda en una cuenta con acceso controlado, en vez de moverlos entre correos y hojas.
Sigue leyendo: comprar, suscribirse o desarrollar, cuándo Excel deja de ser la solución y la nube no es un respaldo.
Preguntas frecuentes
¿Qué es un webhook?
Es un aviso que un servicio envía automáticamente a una dirección tuya cuando ocurre algo (por ejemplo, un pago confirmado), en lugar de que tu sistema pregunte una y otra vez.
¿Qué significa que una operación sea idempotente?
Que repetirla no cambia el resultado: aplicar dos veces el mismo evento deja el sistema igual que aplicarlo una vez. Se logra, por ejemplo, registrando el identificador de cada evento procesado.
¿Cuántas veces debo reintentar?
Depende del caso; en la demostración son 4 intentos con espera creciente. Lo importante es que los errores temporales se reintenten, los permanentes no, y que el agotamiento de intentos genere una alerta.
¿Cómo sé si una integración dejó de funcionar?
Con alertas por inactividad (tiempo sin eventos), una cola de fallidos revisada a diario y una conciliación periódica de los totales entre el origen y el destino.
¿Necesito programar para esto?
Para el código, sí o con apoyo técnico; pero el inventario, los responsables y el plan de falla no requieren programación, y son lo que más evita sorpresas.
Esta semana: descarga el inventario de integraciones, lista las tuyas, asigna un responsable a cada una y responde la hoja "Plan_de_falla" para las críticas. Si quieres ver las defensas en código, ejecuta la demostración en Python.
Para pensar
Una integración que funciona el 99 % del tiempo y falla en silencio el otro 1 % puede ser peor que una que falla a gritos, porque nadie sabe que debe corregir. ¿Es aceptable que un colegio o una empresa dependa de conexiones que nadie vigila, cuando de ellas dependen los pagos, las notas o los datos de las personas? Y cuando una falla silenciosa perjudica a alguien (un cobro duplicado, una matrícula perdida), ¿quién responde: quien programó la integración, quien la contrató o quien debía vigilarla?
¿Te sirvió este artículo?
Reacciona y compártelo con alguien a quien le pueda servir.
- Me gusta 0
- Útil 0
- Aplausos 0
- Me encanta 0
- Me hizo pensar 0
¿Prefieres tenerlo listo?
Más guías en IA y tecnología para docentes