Integracion con Automatizacion

Las solicitudes de documentos se integran con el sistema de automatizacion para crear flujos eficientes.

Eventos Disponibles

DOCUMENT_UPLOADED

Evento emitido cuando:

• Candidato sube un documento
• Para cualquier item de la solicitud
• Independiente del estado de revision

Datos del evento:

DOCUMENT_REQUEST_COMPLETED

Evento emitido cuando:

• Todos los documentos requeridos aprobados
• Solicitud cambia a estado "completed"
• Una sola vez por solicitud

Datos del evento:

Usar en Automatizacion

Trigger: Documento Subido

Configuracion:

Acciones posibles:

• Enviar notificacion al reclutador
• Mover tarea en proceso
• Enviar email de confirmacion

Trigger: Solicitud Completada

Configuracion:

Acciones posibles:

• Mover candidato a siguiente etapa
• Notificar al equipo de RH
• Enviar email de bienvenida
• Crear tarea de onboarding

Flujos de Ejemplo

Flujo de Contratacion

1. Candidato acepta oferta
2. Automatizacion crea solicitud de docs
3. Candidato sube documentos
4. Evento: DOCUMENT_UPLOADED
5. Notificacion a reclutador
6. Reclutador revisa y aprueba
7. Todos aprobados?
   • No: Esperar mas documentos
   • Si: Evento: DOCUMENT_REQUEST_COMPLETED
8. Candidato movido a "Onboarding"
9. Email de bienvenida enviado

Flujo de Verificacion Rapida

1. Candidato llega a etapa "Verificacion"
2. Plantilla de paso crea solicitud
3. Candidato sube INE
4. Evento: DOCUMENT_UPLOADED (tipo: id_card)
5. Si tipo es INE: Notificar a verificador
6. Verificador aprueba
7. Evento: DOCUMENT_REQUEST_COMPLETED
8. Candidato avanza automaticamente

Crear Solicitud por Automatizacion

Desde Plantilla de Pasos

En configuracion de etapa:

Ejemplo:

• Plantilla: Documentos de Contratacion
• Mensaje: "Por favor sube los documentos para continuar con tu proceso."
• Fecha limite: 7 dias

Via Bot/Agente

El bot puede crear solicitudes:

ReclutadorAIService:

• Detecta necesidad de documentos
• Selecciona plantilla apropiada
• Crea solicitud automaticamente
• Notifica al candidato
• Registra accion en conversacion

DocumentRequestService

Metodo Principal

createDocumentRequest({
  jobApplicationId: number,    // Aplicacion del candidato
  requestedById: number,       // Usuario que crea
  templateId?: number,         // Plantilla a usar
  items?: ItemConfig[],        // O items manuales
  dueDate?: Date,              // Fecha limite
  dueDays?: number,            // O dias desde hoy
  message?: string,            // Mensaje personalizado
  consentText?: string,        // Aviso de privacidad
  consentPurpose?: string      // Proposito
})

Ejemplo de Uso

// Desde automatizacion
await documentRequestService.createDocumentRequest({
  jobApplicationId: 123,
  requestedById: currentUser.id,
  templateId: 5, // "Documentos de Contratacion"
  dueDays: 7,
  message: "Bienvenido! Por favor completa tu expediente."
});

Acciones Post-Documento

Al Subir Documento

Acciones posibles:

• Notificar reclutador
• Actualizar estado en CRM
• Enviar email de confirmacion
• Registrar en timeline
• Trigger condicional por tipo

Al Completar Solicitud

Acciones posibles:

• Mover en proceso de reclutamiento
• Notificar equipo de RH
• Enviar email de siguiente paso
• Crear tareas de onboarding
• Actualizar estado de aplicacion
• Activar siguiente automatizacion

Integracion con Procesos

En Etapa de Proceso

Etapa: "Documentacion"

Condiciones de Avance

Validar antes de mover:

• Solicitud existe?
• Estado es "completed"?
• Todos los requeridos aprobados?
• Si no: Bloquear movimiento

Webhooks y Eventos

Formato del Evento

DOCUMENT_UPLOADED:

{
  type: "DOCUMENT_UPLOADED",
  timestamp: "2024-01-15T10:30:00Z",
  data: {
    documentRequestId: 45,
    documentRequestItemId: 123,
    documentId: 789,
    jobApplicationId: 456,
    userId: 100,
    documentType: "id_card",
    filename: "INE_frente.pdf"
  }
}

DOCUMENT_REQUEST_COMPLETED:

{
  type: "DOCUMENT_REQUEST_COMPLETED",
  timestamp: "2024-01-18T14:00:00Z",
  data: {
    documentRequestId: 45,
    jobApplicationId: 456,
    userId: 100,
    completedAt: "2024-01-18T14:00:00Z",
    itemsApproved: 5,
    itemsTotal: 5
  }
}

Suscribirse a Eventos

Para recibir eventos:

• Configurar webhook en Automatizacion
• Usar EventBusService
• Integrar con ActionHookExecutor
• O escuchar via WebSocket

Casos de Uso Avanzados

Verificacion Escalonada

Flujo:

1. Solicitar INE primero
2. Al aprobar INE: Solicitar resto de documentos
3. Al completar todos: Continuar proceso

Documentos Condicionales

Logica:

• Si posicion requiere titulo: Incluir "Titulo Profesional"
• Si requiere vehiculo: Incluir "Licencia de Conducir"
• Base + condicionales

Recordatorios Automaticos

Configurar:

• 3 dias antes de vencer: Recordatorio
• 1 dia antes: Recordatorio urgente
• Al vencer: Notificar reclutador
• Extender automatico si es necesario

Mejores Practicas

Configurar Automatizaciones

Recomendaciones:

• Usar eventos especificos
• Condiciones claras
• Acciones apropiadas
• Probar antes de activar
• Monitorear ejecucion

Evitar Loops

Cuidado con:

• Accion que trigger mismo evento
• Solicitudes duplicadas
• Notificaciones excesivas
• Usar condiciones de guarda

Monitoreo

Verificar regularmente:

• Eventos emitidos correctamente
• Acciones ejecutadas
• Errores en logs
• Candidatos atascados
• Tiempos de respuesta

Proximos Pasos

• Crear Plantillas - Diseñar plantillas
• Solicitudes de Documentos - Gestionar solicitudes
• Revision y Aprobacion - Flujo de revision