Automatiza la Firma de Documentos con Notificaciones por WhatsApp y Correo

Tener un documento "firmable" no resuelve el problema real de una empresa. El cuello de botella casi siempre está en el seguimiento: alguien tiene que acordarse de escribirle a cada persona, preguntar si ya firmó, reenviar el enlace y anotar en una hoja de Excel quién falta. Si ese seguimiento sigue siendo manual, la firma electrónica termina siendo apenas una mejora cosmética. La diferencia real aparece cuando el propio sistema notifica, recuerda y confirma por su cuenta.

El verdadero cuello de botella: perseguir firmas, no conseguirlas

Enviar un documento para firmar es la parte fácil. Lo difícil es lo que viene después: saber si la persona lo abrió, si lo está ignorando, si hay que recordárselo, y tener una vista clara de cuántos documentos siguen pendientes en un momento dado. Cuando esto se resuelve con mensajes sueltos de WhatsApp escritos a mano por alguien del equipo, el proceso sigue dependiendo de la memoria y la disponibilidad de esa persona.

Arquitectura de un flujo de firma con notificaciones automáticas

• 1. Carga y firma inicial: el documento se sube y el dueño o representante legal firma primero.
• 2. Solicitudes encoladas con reintentos: por cada destinatario se genera una solicitud de firma, procesada de forma asíncrona en un sistema de colas (tipo Redis/BullMQ) para no depender de que el envío sea inmediato ni bloquear el resto del proceso si algo falla.
• 3. Notificación en paralelo por dos canales: correo transaccional (por ejemplo con Resend) y WhatsApp Business API, cada uno con un enlace único y seguro al documento.
• 4. Firma autenticada: el firmante abre el enlace, valida su identidad y firma con captura biométrica.
• 5. Webhook de estado: el sistema actualiza en tiempo real si el documento quedó pendiente, firmado o rechazado.
• 6. Recordatorio automático: si pasan X horas sin firma, se reenvía un recordatorio por el mismo canal sin intervención humana.
• 7. Trazabilidad completa: todo queda registrado en logs (quién, cuándo, desde qué dispositivo).

// Job de cola simplificado: se dispara al crear una solicitud de firma
import { sendTransactionalEmail } from './notifications/email';
import { sendWhatsappMessage } from './notifications/whatsapp';
import { generateSigningLink } from './signature/links';

interface SignatureRequestJob {
  documentId: string;
  signerId: string;
  signerEmail: string;
  signerPhone: string;
  documentTitle: string;
}

export async function processSignatureRequest(job: SignatureRequestJob) {
  const signingUrl = await generateSigningLink(job.documentId, job.signerId);

  // Notificación en paralelo: si un canal falla, el otro igual llega
  const results = await Promise.allSettled([
    sendTransactionalEmail({
      to: job.signerEmail,
      template: 'solicitud-firma',
      data: { documentTitle: job.documentTitle, signingUrl },
    }),
    sendWhatsappMessage({
      to: job.signerPhone,
      template: 'solicitud_firma',
      params: [job.documentTitle, signingUrl],
    }),
  ]);

  const failedChannels = results.filter((r) => r.status === 'rejected');
  if (failedChannels.length === results.length) {
    // Si ambos canales fallaron, la cola reintenta automáticamente
    throw new Error(`No se pudo notificar al firmante ${job.signerId}`);
  }
}

Por qué colas con reintentos, y no solo un envío directo

Un envío directo y síncrono funciona bien en una demo, pero falla en producción: la API de WhatsApp puede estar caída un momento, el proveedor de correo puede tener latencia, o simplemente el firmante número 40 de 200 puede fallar sin que eso detenga a los otros 199. Con un sistema de colas y reintentos exponenciales, cada notificación se procesa de forma independiente, se reintenta automáticamente si falla y nunca bloquea al resto del flujo.

Seguridad: enlaces únicos, autenticación y almacenamiento cifrado

Cada enlace de firma debe ser único, de un solo uso o con expiración, y exigir que el firmante valide su identidad antes de poder firmar; nunca basta con "quien tenga el enlace, firma". Una vez firmado, el documento final debe almacenarse cifrado, con acceso controlado por autenticación centralizada, y quedar disponible para auditoría en cualquier momento. Esa combinación —colas asíncronas, notificaciones redundantes y almacenamiento seguro— es lo que separa una automatización real de un simple envío de PDFs por correo.