Antes de integrar
Toda integración debería responder tres preguntas: qué dispara el flujo, qué sistema es la fuente de verdad y qué pasa cuando algo falla.
Checklist mínimo
- Idempotencia para evitar duplicados.
- Logs y trazabilidad por evento.
- Reintentos controlados y alertas.
- Timeouts razonables y circuit breakers.
- Contratos claros entre servicios.
Qué evitar
No mezcles lógica de negocio con la capa de transporte. Si el webhook empieza a tomar decisiones complejas sin observabilidad, la deuda técnica aparece rápido.
Buen criterio
Si una integración no puede reconstruirse mirando logs, payloads y estado del sistema, todavía no está lista para producción.
