Configuración de plantillas de proceso

Descripción general

Una plantilla de proceso define las etapas por las que pasa un candidato a lo largo de tu pipeline de contratación. Las plantillas se escriben en YAML y constan de una lista ordenada de etapas, cada una con un tipo, un nombre y una configuración opcional.

Cuando creas una oferta de empleo y seleccionas una plantilla, las etapas se instancian en orden. Los candidatos avanzan por cada etapa de forma secuencial, desde la candidatura hasta la oferta.

Estructura básica

name: My Hiring Process
description: |
  A short description of this template.
  Supports **Markdown** formatting.

tags:
  - engineering
  - remote

stages:
  - type: application_form
    name: "Application"
    config:
      candidate_description: "Tell us about yourself."

  - type: live_interview
    name: "Interview"
    config:
      duration_minutes: 60

  - type: offer
    name: "Offer"

Claves de nivel superior

Clave	Obligatoria	Descripción
stages	Sí	Lista ordenada de definiciones de etapa (al menos una)
name	No	Nombre de la plantilla (también se puede definir en el campo del formulario)
description	No	Descripción del proceso con formato Markdown
tags	No	Lista de etiquetas de texto para categorizar
quick_fields	No	Campos rápidos para capturar información del candidato (consulta Campos rápidos más adelante)

Claves de etapa

Cada etapa requiere name y type. El hash opcional config y la lista reviewers varían según el tipo de etapa.

Clave	Obligatoria	Descripción
name	Sí	Nombre visible de la etapa
type	Sí	Uno de los 10 tipos de etapa que se enumeran a continuación
config	No	Opciones de configuración específicas del tipo
reviewers	No	Lista de asignaciones de revisores

Referencia de tipos de etapa

application_form

El punto de entrada para los candidatos. Recopila información estructurada mediante campos de formulario personalizados. Opcionalmente, retiene a los candidatos en estado de cribado antes de avanzarlos.

Clave de configuración	Tipo	Predeterminado	Descripción
candidate_description	string	—	Instrucciones que se muestran al candidato
screening_enabled	boolean	true	Retiene las candidaturas para revisión manual antes de avanzarlas. Activado por defecto: ponlo en false de forma explícita para desactivar el cribado
screening_message	string	—	Mensaje que se muestra a los candidatos mientras el cribado está activo
fields	array	—	Lista de definiciones de campos de formulario (ver a continuación)

Opciones de los campos de formulario:

Clave	Obligatoria	Tipo	Descripción
name	Sí	string	Identificador del campo
type	Sí	string	text, textarea, file, url, select, checkbox, email, phone
required	No	boolean	Si el campo es de cumplimentación obligatoria
label	No	string	Etiqueta visible (por defecto, el nombre)
placeholder	No	string	Texto de ejemplo
max_length	No	integer	Número máximo de caracteres (mínimo: 1)
options	No	array	Opciones para los campos select

- type: application_form
  name: "Application"
  config:
    candidate_description: "Tell us about yourself."
    screening_enabled: true
    screening_message: "We'll review your application shortly."
    fields:
      - name: resume
        type: file
        required: true
      - name: experience_level
        type: select
        required: true
        options:
          - "Junior (0-2 years)"
          - "Mid (2-5 years)"
          - "Senior (5+ years)"
      - name: cover_letter
        type: textarea
        required: false
        max_length: 500

code_assignment

Un ejercicio de código para realizar en casa. Cuando GitHub está conectado, se crea un repositorio privado a partir de una plantilla para cada candidato. Incluye gestión de plazos de entrega.

Importante: El repositorio que indiques en github_template debe estar marcado como plantilla en GitHub. Consulta GitHub Template Repository Setup para conocer los requisitos y las instrucciones de configuración.

Clave de configuración	Tipo	Predeterminado	Descripción
candidate_description	string	—	Instrucciones que se muestran al candidato
github_template	string	—	Repositorio plantilla de GitHub (por ejemplo, org/hiring-assignment)
duration_days	integer	—	Días disponibles para completarlo (mínimo: 1)
estimated_hours	string	—	Esfuerzo estimado como texto libre (por ejemplo, "4-6 hours")

Compensación: Los pagos se configuran por etapa en la interfaz de configuración de la etapa, no en el YAML de la plantilla. Cualquier tipo de etapa puede ofrecer compensación. Consulta Candidate Payouts para más detalles.

- type: code_assignment
  name: "Take-Home Assignment"
  config:
    candidate_description: "Complete a practical coding exercise."
    github_template: "mycompany/hiring-challenge"
    duration_days: 7
    estimated_hours: "4-6 hours"

portfolio_upload

Los candidatos suben muestras de trabajo (archivos de diseño, muestras de escritura, etc.). Admite restricciones de tipo de archivo y límites de subida.

Clave de configuración	Tipo	Predeterminado	Descripción
candidate_description	string	—	Instrucciones que se muestran al candidato
accept	array	—	Extensiones de archivo permitidas (por ejemplo, pdf, png, figma)
max_files	integer	—	Número máximo de archivos (mínimo: 1)

- type: portfolio_upload
  name: "Portfolio Review"
  config:
    candidate_description: "Share 3-5 examples of your best work."
    accept:
      - pdf
      - png
      - jpg
      - figma
    max_files: 5

questionnaire

Preguntas escritas para que los candidatos respondan de forma asíncrona. Útil para el cribado basado en escenarios en roles de soporte, ventas o redacción.

Clave de configuración	Tipo	Predeterminado	Descripción
candidate_description	string	—	Instrucciones que se muestran al candidato
questions	array	—	Lista de definiciones de preguntas

Opciones de las preguntas:

Clave	Obligatoria	Tipo	Descripción
type	Sí	string	Categoría de la pregunta (por ejemplo, scenario)
prompt	Sí	string	El texto de la pregunta

- type: questionnaire
  name: "Written Scenarios"
  config:
    candidate_description: "Respond to these real-world scenarios."
    questions:
      - type: scenario
        prompt: "A customer reports a billing error. Walk us through your response."
      - type: scenario
        prompt: "You discover a bug affecting 10% of users. What do you do?"

video

Presenta un vídeo a los candidatos. Admite vídeos subidos (a través de Mux) o vídeos incrustados desde plataformas externas.

Clave de configuración	Tipo	Predeterminado	Descripción
candidate_description	string	—	Instrucciones que se muestran al candidato
video_source_type	string	—	mux (subido) u oembed (incrustación externa)
video_oembed_url	string	—	URL del vídeo incrustado (cuando la fuente es oembed)
video_description	string	—	Descripción o contexto del vídeo
video_min_watch_percentage	integer	—	Porcentaje mínimo de visualización requerido (1-100)

- type: video
  name: "Company Introduction"
  config:
    candidate_description: "Watch this video about our team and culture."
    video_source_type: oembed
    video_oembed_url: "https://www.youtube.com/watch?v=example"
    video_description: "A 5-minute overview of our engineering team."
    video_min_watch_percentage: 80

video_recording

Los candidatos graban o suben una respuesta en vídeo a una indicación. Útil para presentaciones en vídeo, cartas de presentación en vídeo o entrevistas en vídeo asíncronas. Requiere la integración con Mux.

Los ajustes de grabación se agrupan bajo una clave anidada video_recording dentro de config.

Clave de configuración	Tipo	Predeterminado	Descripción
candidate_description	string	—	Instrucciones que se muestran al candidato
video_recording	hash	—	Ajustes de grabación (ver a continuación)

Opciones de video_recording:

Clave	Tipo	Predeterminado	Descripción
max_duration_seconds	integer	120	Duración máxima de la grabación en segundos
allow_upload	boolean	true	Permitir a los candidatos subir un archivo de vídeo pregrabado
max_retakes	integer	—	Número de regrabaciones permitidas (en blanco = ilimitadas)

- type: video_recording
  name: "Video Introduction"
  config:
    candidate_description: "Record a 2-minute video introducing yourself."
    video_recording:
      max_duration_seconds: 120
      allow_upload: true
      max_retakes: 3

team_review

Una etapa de revisión interna en la que tu equipo evalúa a un candidato. Admite umbrales de votación y reglas de veto.

Clave de configuración	Tipo	Predeterminado	Descripción
candidate_description	string	—	Mensaje que se muestra al candidato durante esta etapa
voting	hash	—	Configuración de la votación (ver a continuación)

Opciones de la votación:

Clave	Tipo	Predeterminado	Descripción
threshold	integer	—	Mínimo de votos a favor para avanzar (1-10)
require_all_reviewers	boolean	false	Todos los revisores asignados deben votar
veto_auto_rejects	boolean	false	Un solo veto rechaza automáticamente al candidato

- type: team_review
  name: "Code Review"
  config:
    candidate_description: "Our team is reviewing your submission."
    voting:
      threshold: 2
      require_all_reviewers: true
      veto_auto_rejects: true

live_interview

Una entrevista síncrona realizada por videollamada o de forma presencial. Se integra con la programación del calendario.

Clave de configuración	Tipo	Predeterminado	Descripción
candidate_description	string	—	Instrucciones que se muestran al candidato
duration_minutes	integer	—	Duración de la entrevista en minutos (mínimo: 15)
interviewers_required	integer	—	Número de entrevistadores necesarios (mínimo: 1)
includes_roleplay	boolean	false	Si la entrevista incluye un ejercicio de simulación de rol

- type: live_interview
  name: "Technical Interview"
  config:
    candidate_description: "A conversation about your technical skills."
    duration_minutes: 60
    interviewers_required: 2

reference_check

Recopila y verifica las referencias de los candidatos.

Clave de configuración	Tipo	Predeterminado	Descripción
candidate_description	string	—	Instrucciones que se muestran al candidato
references_required	integer	—	Número de referencias necesarias (mínimo: 1)

- type: reference_check
  name: "References"
  config:
    candidate_description: "Provide contact details for your references."
    references_required: 2

offer

La etapa final, en la que le extiendes una oferta al candidato. Suele tener una configuración mínima.

Clave de configuración	Tipo	Predeterminado	Descripción
candidate_description	string	—	Mensaje que se muestra al candidato

- type: offer
  name: "Offer"
  config:
    candidate_description: "We'd love to have you join the team."

Revisores

Puedes asignar revisores a cualquier etapa. Cada revisor necesita una dirección de correo electrónico y un rol.

Clave	Obligatoria	Descripción
email	Sí	Dirección de correo electrónico del revisor (debe coincidir con la de un miembro del equipo)
role	Sí	reviewer (estándar) o lead (responsable principal de la decisión)

- type: team_review
  name: "Code Review"
  config:
    voting:
      threshold: 2
  reviewers:
    - email: [email protected]
      role: lead
    - email: [email protected]
      role: reviewer
    - email: [email protected]
      role: reviewer

Campos rápidos

Los campos rápidos definen los metadatos estructurados que tu equipo captura para cada candidato: cosas como expectativas salariales, disponibilidad, preferencia de ubicación o cualquier señal personalizada relevante para tu puesto. Los campos aparecen en la barra lateral del candidato.

Para gestionar las definiciones de campos directamente en la interfaz, consulta Campos de datos del candidato.

Esquema

Clave	Obligatoria	Tipo	Descripción
key	Sí	string	Identificador único (solo minúsculas y guiones bajos, por ejemplo, salary_expectation)
label	Sí	string	Etiqueta visible que se muestra a tu equipo
field_type	No	string	Uno de los 4 tipos de campo de más abajo (predeterminado: text)
placeholder	No	string	Texto de ejemplo para el campo
options	No	array	Opciones para los campos select

Nota: Los tipos de campo y opciones más avanzados —como números, valoraciones, extracción por IA y reglas de visibilidad— se configuran en metafield_definitions, una clave de nivel superior independiente. Consulta Campos de datos del candidato.

Tipos de campo

Tipo	Descripción
text	Entrada de texto de una sola línea
textarea	Entrada de texto de varias líneas
select	Lista desplegable a partir de un conjunto fijo de opciones
date	Selector de fecha

Ejemplos

quick_fields:
  - key: salary_expectation
    label: "Salary Expectation"
    field_type: text
    placeholder: "$80,000 - $100,000"
  - key: start_date
    label: "Earliest Start Date"
    field_type: date
  - key: work_authorization
    label: "Work Authorization"
    field_type: select
    options:
      - "US Citizen"
      - "Permanent Resident"
      - "Requires Sponsorship"
  - key: source
    label: "Source / Referral"
    field_type: text
    placeholder: "e.g. LinkedIn, referral from..."

Ejemplo completo

Una plantilla completa para contratar a un ingeniero de software, que incluye cribado, un ejercicio de código, revisión del equipo, dos rondas de entrevistas, referencias y una oferta. Para añadir compensación a la etapa del ejercicio, configura los pagos en la interfaz de configuración de la etapa: consulta Candidate Payouts.

name: Software Engineer - Standard
description: |
  Comprehensive process for mid-to-senior software engineers.
  Includes a take-home assignment with team code review.

tags:
  - engineering
  - technical
  - assignment

quick_fields:
  - key: salary_expectation
    label: "Salary Expectation"
    field_type: text
    placeholder: "e.g. $120k - $150k"
  - key: notice_period
    label: "Notice Period"
    field_type: text
  - key: location_preference
    label: "Location Preference"
    field_type: text

stages:
  - type: application_form
    name: "Application"
    config:
      candidate_description: "Tell us about yourself and your experience."
      screening_enabled: true
      screening_message: "We're reviewing your application."
      fields:
        - name: resume
          type: file
          required: true
        - name: github_url
          type: url
          required: false
        - name: motivation
          type: textarea
          required: true
          max_length: 500

  - type: code_assignment
    name: "Take-Home Assignment"
    config:
      candidate_description: "Complete a practical coding exercise at your own pace."
      github_template: "mycompany/hiring-assignment"
      duration_days: 8
      estimated_hours: "5-7 hours"
    reviewers:
      - email: [email protected]
        role: lead

  - type: team_review
    name: "Code Review"
    config:
      candidate_description: "Our team reviews your code submission."
      voting:
        threshold: 2
        require_all_reviewers: true
        veto_auto_rejects: true
    reviewers:
      - email: [email protected]
        role: lead
      - email: [email protected]
        role: reviewer

  - type: live_interview
    name: "Technical Interview"
    config:
      candidate_description: "A conversation about your technical skills."
      duration_minutes: 75
      interviewers_required: 2

  - type: live_interview
    name: "Culture & Values"
    config:
      candidate_description: "Get to know the team and learn about our culture."
      duration_minutes: 45
      interviewers_required: 1

  - type: reference_check
    name: "References"
    config:
      references_required: 2

  - type: offer
    name: "Offer"
    config:
      candidate_description: "We'll present you with an offer to join the team."

Consejos

• Comienza con application_form: es el punto de entrada natural y te permite recopilar currículos e información básica.
• Termina con offer: mantiene el pipeline ordenado y te da una etapa final para el seguimiento.
• Usa el cribado en el formulario de candidatura para revisar manualmente a los candidatos antes de avanzarlos. Así evitas que candidatos no cualificados reciban ejercicios de código.
• Paga por los ejercicios de código para realizar en casa: configura los pagos en la configuración de la etapa para compensar a los candidatos. Consulta Candidate Payouts.
• Mantén los procesos por debajo de 7 etapas: los pipelines largos provocan el abandono de los candidatos.
• Asigna revisores a las etapas team_review y code_assignment para que se notifique automáticamente a las personas adecuadas.
• Usa candidate_description en cada etapa: los candidatos ven este mensaje, así que una comunicación clara reduce la confusión y las solicitudes de soporte.
• Captura las señales habituales con quick_fields: añade campos como expectativa salarial, disponibilidad y ubicación para que tu equipo los registre de forma coherente en la barra lateral del candidato.
• ¿Necesitas tipos más avanzados o extracción por IA? Los números, las valoraciones, el autocompletado por IA y las reglas de visibilidad están en metafield_definitions. Consulta Campos de datos del candidato.