Confirmar entrevistas

Mini-guía específica para el company_user que recibe una entrevista agendada por HUMAE.

Cuándo llega la notificación

Cuando el recruiter HUMAE agenda la entrevista:

• Email a cada owner y manager de la empresa.
• Notificación in-app con badge en la campana.

Subject del correo:

Nueva entrevista agendada: Ana Pérez · Backend Engineer · 22 abril 10:00

Opciones del company_user

Confirmar

Endpoint: POST /api/v1/interviews/{id}/confirm

Desde el correo o desde /me/empresa/vacantes/{vid}/candidatos/{aid}.

• Cambia estado: propuesta → confirmada.
• Notifica al candidato y al recruiter.
• Bloquea el slot en el calendario interno (fase 2 con integración gCal).

Reprogramar

Endpoint: POST /api/v1/interviews/{id}/rescheduleBody:

{
  "new_scheduled_at": "2026-04-24T14:00:00-06:00",
  "reason": "El entrevistador tiene conflicto"
}

• Crea un interview_reschedule row.
• Pasa la entrevista de vuelta a propuesta con la nueva fecha.
• El candidato recibe la nueva propuesta y puede confirmar.

Cancelar

Endpoint: POST /api/v1/interviews/{id}/cancel

• Desde cualquier no-terminal.
• Notifica a todas las partes con el motivo.

Detalles que muestra el panel

┌──────────────────────────────────────────────┐
│  Entrevista · Ronda 1                        │
│  Candidato: Ana Pérez                        │
│  Puesto: Backend Engineer Senior             │
│                                              │
│  📅 Martes 22 abril 2026, 10:00 am           │
│  🕐 Duración: 60 minutos                     │
│  🌎 America/Mexico_City                      │
│                                              │
│  Modalidad: Online · Google Meet             │
│  🔗 meet.google.com/abc-defg-hij             │
│                                              │
│  Entrevistador asignado: —                   │
│  [Asignar entrevistador] (owner/manager)     │
│                                              │
│  [Confirmar] [Reprogramar] [Cancelar]        │
└──────────────────────────────────────────────┘

Asignar entrevistador interno

La empresa puede asignar a un miembro específico como entrevistador:

Endpoint: PATCH /api/v1/interviews/{id} con {"interviewer_user_id": 42}.

• Opcional — no hace nada obligatorio.
• El entrevistador asignado recibe una copia de la notificación.
• Se muestra su nombre al candidato como "Conocerás a: John Smith, CTO".

Calendario sugerido (Fase 2)

• Botón "Agregar a Google Calendar" con evento pre-llenado.
• Archivo .ics adjunto al email.
• Webhook bidireccional: si el company_user rechaza el evento desde gCal, cancela la entrevista en HUMAE.

Recordatorios (Fase 2)

• Email 24h antes.
• Email 1h antes con el enlace de Meet.
• Push notification al entrevistador asignado.

Durante la entrevista

• No hay integración activa con la plataforma.
• La empresa toma sus notas en su herramienta habitual.
• Después de la entrevista, escribe feedback en HUMAE (ver siguiente sección).

Después de la entrevista

El company_user:

1. Da feedback en el panel (company_feedback + rating 1-10) vía PATCH /api/v1/interviews/{id} con company_feedback (máx 5000 chars).
2. Si es un match:
   • Añade nota: "Recomiendo avanzar a finalista".
   • El recruiter HUMAE lo ve y mueve la asignación a finalist.
3. Si no es match:
   • Añade nota: "No procede — razón".
   • El recruiter mueve la asignación a rejected con el motivo.

Ver el feedback ya capturado

Una vez la entrevista está en realizada, la InterviewCard en /me/entrevistas muestra una sección colapsable "Resultado de la entrevista" con la recomendación del reclutador (badge verde/ámbar/rojo), el rating (X/10) y el texto íntegro de recruiter_feedback y company_feedback. Esto es visible para recruiter, admin y company_user; los candidatos NO lo ven (queda como información interna de evaluación).

Filtros en el listado de entrevistas

/me/entrevistas (compartido entre recruiter y company_user) expone:

• Tabs: Próximas / Historial / Todas (agrupan los 6 estados de InterviewState).
• Búsqueda por nombre del candidato o código/título de la vacante.
• Estado específico — propuesta, confirmada, reprogramada, realizada, cancelada, no_asisto.
• Rango de fechas (from / to) — útil para auditoría: "todas las entrevistas de Q1".
• Botón "Limpiar filtros" cuando hay alguno activo.

El company_user sólo ve entrevistas de asignaciones de su propia empresa (filtro automático en backend).

Reportes de la empresa

El dashboard empresa muestra:

• Entrevistas próximas esta semana.
• Entrevistas pasadas sin feedback (alerta naranja).
• % de confirmación de entrevistas por vacante.
• Tiempo promedio entre presented y hired.

Siguiente

Cierre del manual de empresa. Ahora pasa a administración: Catálogos (Admin) →