Gestión de cobranzas multicanal: arquitectura técnica
Gestión de cobranzas multicanal: arquitectura técnica
La cobranza es uno de los procesos críticos en cualquier institución financiera o empresa con modelo de suscripciones. Un sistema de cobranzas efectivo no se trata solo de enviar recordatorios de pago, sino de orquestar comunicaciones inteligentes a través de múltiples canales con la frecuencia y el timing correctos. En este artículo exploraremos la arquitectura técnica que permite operar cobranzas multicanal a escala, con énfasis en WhatsApp, email y SMS.
El problema de la orquestación
Construir un sistema de cobranzas no trivial implica resolver varios desafíos concurrentes: gestionar estados de deuda con diferentes niveles de morosidad, aplicar estrategias diferenciadas por segmento de cliente, respetar regulaciones de horarios y frecuencia de contacto, evitar saturar a los clientes, y medir efectividad por canal.
Un error común es construir canales aislados. El equipo de email desarrolla su propia lógica, el de WhatsApp otra, y SMS queda como un sistema legacy sin integración. Esto genera incoherencia: un cliente puede recibir tres comunicaciones distintas el mismo día sin coordinación alguna.
La solución requiere una capa de orquestación centralizada que defina qué comunicación enviar, por qué canal, en qué momento, y con qué contenido.
Arquitectura de referencia
Proponemos una arquitectura en capas con los siguientes componentes:
- Core de cobranzas: gestiona deudas, planes de pago, promesas y recibos.
- Motor de decisiones: determina estrategia, canal, timing y contenido.
- Adaptadores de canal: abstraen la integración con WhatsApp, email y SMS.
- Cola de priorización: gestiona la ventana de envío y throttling.
- Analytics y feedback loop: mide efectividad y alimenta el motor de decisiones.
Diseño del motor de decisiones
El motor de decisiones es el cerebro del sistema. Recibe eventos de negocio (pago vencido, promesa incumplida, acercamiento a fecha de vencimiento) y emite órdenes de comunicación.
Implementamos este motor como una máquina de estados con reglas configurables. Cada deuda transita por estados de morosidad, y cada estado tiene una estrategia asociada:
public enum Morosidad {
PRE_VENCIMIENTO, // -3 a 0 días
TEMPRANA, // 1 a 15 días
MODERADA, // 16 a 60 días
AVANZADA, // 61 a 120 días
RECUPERO_EXTERNO // > 120 días
}
public record EstrategiaComunicacion(
List<PasoCobranza> pasos,
SegmentoCliente segmento,
RegulacionHorario horarioPermitido
) {}
public record PasoCobranza(
int diasDesdeVencimiento,
Canal canal,
int maxReintentos,
Duration esperaEntreReintentos,
MensajeTemplatizado mensaje
) {}
La selección de canal considera múltiples factores: preferencia declarada del cliente, efectividad histórica por canal para ese segmento, costo del canal, y disponibilidad técnica. Un cliente con WhatsApp verificado y alto engagement histórico será contactado primero por ese canal. Si no hay respuesta en 24 horas, el sistema escala a SMS, y finalmente a email con mayor detalle.
La implementación del selector de canal:
public class SelectorCanal {
private final Map<Canal, ProveedorCanal> proveedores;
private final RepositorioEfectividad efectividad;
public Canal seleccionar(Deuda deuda, Cliente cliente) {
List<Canal> candidatos = Arrays.asList(Canal.WHATSAPP, Canal.SMS, Canal.EMAIL);
return candidatos.stream()
.filter(c -> proveedores.get(c).estaDisponible())
.filter(c -> cliente.aceptaCanal(c))
.max(Comparator.comparingDouble(c ->
efectividad.tasaRespuesta(cliente.segmento(), c) * 0.6
+ (1.0 / costoNormalizado(c)) * 0.3
+ disponibilidadTecnica(cliente, c) * 0.1
))
.orElse(Canal.EMAIL); // fallback siempre disponible
}
private double disponibilidadTecnica(Cliente c, Canal canal) {
return switch (canal) {
case WHATSAPP -> c.telefonoVerificado() && c.whatsappActivo() ? 1.0 : 0.0;
case SMS -> c.telefonoVerificado() ? 1.0 : 0.0;
case EMAIL -> c.emailVerificado() ? 1.0 : 0.0;
};
}
}
Integración con WhatsApp Business API
WhatsApp requiere uso de la API oficial de Meta o partners BSP (Business Solution Provider). La integración presenta particularidades importantes: los mensajes de cobranza generalmente caen en la categoría de utility o requieren template precargado y aprobado por Meta.
El flujo de una comunicación de cobranza por WhatsApp:
- Verificar que el número del cliente tiene cuenta de WhatsApp (HSM lookup).
- Utilizar template aprobado con placeholders para personalización.
- Enviar mensaje con botones de acción (pagar ahora, solicitar plan, contactar).
- Procesar webhooks de estado (enviado, entregado, leído, fallido).
- Capturar respuestas del cliente para enrutamiento a agente o sistema automatizado.
Implementación del adaptador:
@Service
public class WhatsAppAdapter implements ProveedorCanal {
private final WhatsAppBusinessApiClient apiClient;
private final WebhookProcessor webhookProcessor;
private final TemplateRepository templates;
@Override
public ResultadoEnvio enviar(OrdenComunicacion orden) {
TemplateCobranza template = templates.buscar(
orden.tipoMensaje(),
orden.idioma()
);
// Construcción del mensaje con template aprobado
MessageRequest request = MessageRequest.builder()
.to(orden.telefonoDestino())
.template(TemplateMessage.builder()
.name(template.nombreMeta())
.language(Language.of(orden.idioma()))
.components(ComponentUtils.reemplazarPlaceholders(
template.componentes(),
orden.parametros()
))
.build())
.build();
try {
MessageResponse response = apiClient.enviar(request);
return ResultadoEnvio.exitoso(
response.messageId(),
Instant.now()
);
} catch (TemplateNoAprobadoException e) {
// Fallback inmediato a SMS si el template está en revisión
return ResultadoEnvio.fallido(
ErrorCanal.TEMPLATE_NO_DISPONIBLE,
Canal.SMS
);
}
}
public void procesarWebhook(WebhookEvent evento) {
switch (evento.status()) {
case READ -> webhookProcessor
.registrarLectura(evento.messageId(), evento.timestamp());
case FAILED -> webhookProcessor
.programarReintento(evento.messageId(), evento.error());
case REPLIED -> webhookProcessor
.procesarRespuestaInteractiva(evento);
}
}
}
Un aspecto crítico es la gestión de templates. Meta aprueba templates con delay, y rechaza contenido que presione excesivamente. Recomendamos mantener un catálogo de templates por escenario: primer recordatorio, segundo recordatorio con oferta de plan, ultimátum antes de castigo crediticio.
Cola de priorización y throttling
Un sistema de cobranzas puede generar picos masivos: el primer día del mes, todas las suscripciones vencen simultáneamente. Sin control, esto satura proveedores de SMS, genera bloqueos de IP en email, o alcanza rate limits de WhatsApp.
Implementamos una cola priorizada con backpressure:
@Component
public class ColaCobranzas {
private final PriorityBlockingQueue<ComunicacionProgramada> cola;
private final Map<Canal, Semaphore> rateLimiters;
public void encolar(ComunicacionProgramada comunicacion) {
int prioridad = calcularPrioridad(comunicacion);
cola.put(comunicacion.withPrioridad(prioridad));
}
@Scheduled(fixedRate = 1000)
public void despachar() {
int maxPorTick = 100;
for (int i = 0; i < maxPorTick; i++) {
ComunicacionProgramada siguiente = cola.poll();
if (siguiente == null) break;
if (!dentroVentanaHoraria(siguiente)) {
// Reprogramar para próxima ventana permitida
cola.put(siguiente.reprogramar(siguiente.proximaVentana()));
continue;
}
Semaphore limiter = rateLimiters.get(siguiente.canal());
if (!limiter.tryAcquire()) {
// Canal saturado, intentar fallback o reprogramar
Canal alternativo = buscarCanalAlternativo(siguiente);
if (alternativo != null) {
cola.put(siguiente.withCanal(alternativo));
} else {
cola.put(siguiente.reprogramar(Instant.now().plusMinutes(5)));
}
continue;
}
ejecutarEnvio(segurizar(siguiente))
.whenComplete((resultado, ex) -> limiter.release());
}
}
private boolean dentroVentanaHoraria(ComunicacionProgramada c) {
ZonedDateTime horaLocal = c.horaClienteZoned();
RegulacionHorario reglas = c.regulacionAplicable();
return reglas.permiteEnvio(
horaLocal.getHour(),
c.canal(),
c.tipoMensaje()
);
}
}
La ventana horaria es configurable por jurisdicción. En Argentina, la ley de defensa del consumidor restringe contactos de cobranza a horarios de 8 a 20hs. Adaptamos dinámicamente según timezone del cliente.
Email: más allá del envío básico
El email en cobranzas cumple funciones diferentes a WhatsApp o SMS: permite mayor detalle (estado de cuenta completo), adjuntos, y links de pago enriquecidos. Pero enfrenta desafíos de deliverability severos.
Aspectos técnicos críticos:
- IP warming: para dominios nuevos, ramp-up progresivo de volumen.
- DKIM, SPF, DMARC: configuración obligatoria para inbox placement.
- Segmentación por engagement: restringir frecuencia a quienes no abren emails.
- Feedback loops: procesar spam complaints para limpieza de lista.
Implementamos un sistema de seguimiento de interacción que alimenta el motor de decisiones:
public class EmailTracker {
public String generarPixelTracking(OrdenComunicacion orden) {
String trackingId = generarIdUnico(orden);
return "<img src='https://track.ejemplo.com/p/"
+ trackingId
+ "' width='1' height='1' />";
}
public String generarLinkRastreado(String urlDestino, OrdenComunicacion orden) {
String clickId = generarIdUnico(orden);
return "https://track.ejemplo.com/c/"
+ clickId
+ "?d=" + urlEncode(urlDestino);
}
@GetMapping("/c/{clickId}")
public ResponseEntity<Void> registrarClick(@PathVariable String clickId) {
EventoClick evento = repositorio.buscarPorClickId(clickId);
// Publicar evento para actualización en tiempo real del perfil del cliente
eventBus.publicar(new InteraccionEmailEvent(
evento.clienteId(),
evento.deudaId(),
TipoInteraccion.CLICK_LINK_PAGO,
Instant.now()
));
return ResponseEntity.status(302)
.header("Location", evento.urlDestino())
.build();
}
}
SMS: canal de última milla
El SMS mantiene relevancia por su universalidad y alta tasa de lectura. Técnicamente, integramos múltiples proveedores (Twilio, MessageBird, proveedores locales) con failover automático.
public class SmsRouter {
private final List<ProveedorSms> proveedores;
private final CircuitBreakerRegistry circuitBreakers;
public ResultadoEnvio enviarConFailover(SmsMessage mensaje) {
for (ProveedorSms proveedor : proveedoresOrdenadosPorCosto()) {
CircuitBreaker cb = circuitBreakers.circuitBreaker(
proveedor.nombre()
);
try {
return cb.executeSupplier(() -> proveedor.enviar(mensaje));
} catch (CallNotPermittedException e) {
// Circuit breaker abierto, intentar siguiente proveedor
continue;
} catch (ProveedorSmsException e) {
// Error transitorio, registrar para retry
metricas.registrarError(proveedor.nombre(), e.getCodigo());
continue;
}
}
throw new SinProveedorDisponibleException(mensaje);
}
}
Métricas y feedback loop
El sistema debe medir efectividad de manera granular: tasa de apertura por canal, tasa de pago post-comunicación, costo por recupero, tiempo medio de respuesta. Estas métricas alimentan A/B testing de estrategias y reentrenamiento del selector de canal.
public class MetricasCobranza {
public void registrarResultado(OrdenComunicacion orden, ResultadoPago resultado) {
MeterRegistry registry = getRegistry();
registry.counter("cobranza.comunicaciones.enviadas",
"canal", orden.canal().name(),
"estado_morosidad", orden.deuda().morosidad().name()
).increment();
if (resultado.tuvoPago()) {
registry.timer("cobranza.tiempo_a_pago",
"canal", orden.canal().name()
).record(Duration.between(orden.enviadoEn(), resultado.fechaPago()));
registry.distributionSummary("cobranza.monto_recuperado",
"canal", orden.canal().name()
).record(resultado.monto());
}
}
}
Consideraciones de compliance y seguridad
Los datos de cobranza son sensibles. Implementamos encriptación en tránsito (TLS 1.3) y en reposo (AES-256). Los tokens de acceso a APIs de WhatsApp se gestionan via HashiCorp Vault con rotación automática. Las conversaciones se almacenan con retención definida por regulación, con capacidad de exportación para requerimientos judiciales.
El consentimiento del cliente se rastrea explícitamente: qué canales autorizó, en qué fecha, y con qué propósito. Un endpoint de autogestión permite al cliente modificar preferencias, con propagación inmediata al motor de decisiones.
Cierre
Construir cobranzas multicanal escalable requiere pensar en orquestación antes que en canales aislados. La arquitectura presentada prioriza: decisión inteligente de canal, abstracción de proveedores, control de frecuencia, y medición continua. Las tecnologías específicas evolucionan —hoy es WhatsApp, mañana puede ser otro canal— pero los principios de diseño perduran.