Integración n8n

¿Qué es n8n?

n8n es una plataforma de automatización de flujos de trabajo de código abierto que te permite conectar Manatal con cientos de otras herramientas, incluyendo Slack, Google Sheets, HubSpot, Salesforce, Microsoft Teams y más. A diferencia de otras herramientas de automatización, n8n se puede autoalojar para una privacidad de datos completa, o usarse mediante n8n Cloud.

Cada automatización en n8n se llama un Workflow (flujo de trabajo), construido a partir de dos componentes principales:

• El Nodo Disparador (Trigger Node): El evento que inicia el flujo de trabajo (por ejemplo, se crea un nuevo Candidato en Manatal).
• El Nodo de Acción (Action Node): La respuesta automatizada en otra aplicación (por ejemplo, enviar un mensaje a un canal de Slack).

¿Qué es la Integración de Manatal con n8n?

Esta integración actúa como un puente entre Manatal y cientos de aplicaciones, permitiéndote automatizar tu trabajo y aumentar la productividad.

• El nodo de Manatal (@manatal/n8n-nodes-manatal) es un nodo comunitario verificado. La verificación significa que ha pasado la revisión de seguridad y calidad de n8n, convirtiéndolo en una integración oficial disponible tanto para usuarios de Cloud como autoalojados.
• Consulta la lista completa de disparadores y acciones de Manatal en esta guía.

¿Por qué usar la Integración de Manatal con n8n?

Integrar Manatal con n8n permite a tu equipo automatizar tareas repetitivas de reclutamiento, mantener tus herramientas sincronizadas y crear flujos de trabajo totalmente personalizados sin escribir código:

• Ahorra Horas de Trabajo Administrativo: Envía automáticamente los datos de los candidatos contratados a tu HRIS, sistema de nómina o CRM en el momento en que un match se marca como contratado.
• Mejora la Comunicación: Notifica a tu equipo en Slack o Microsoft Teams en tiempo real cuando un candidato pasa a una nueva etapa o cambia el estado de una vacante.
• Estandariza los Procesos: Asegúrate de que cada nuevo postulante reciba una invitación a una evaluación, una solicitud de verificación de antecedentes o un formulario de consentimiento de GDPR, sin que nadie de tu equipo tenga que recordar hacerlo.
• Crea tus Propias Soluciones: No necesitas esperar a que nuestro equipo desarrolle una integración específica. Conecta Manatal con cualquier herramienta de tu stack y crea flujos de trabajo adaptados a tu proceso de contratación único.

Instalar el Nodo de Manatal

La forma de instalar el nodo de Manatal depende de si estás usando n8n Cloud o una instancia autoalojada.

Hay cuatro formas de instalar nodos comunitarios.

1. Panel de Nodos

Los nodos comunitarios verificados se pueden instalar directamente desde el lienzo de n8n, sin necesidad de la página de ajustes.

1. Abre un flujo de trabajo en tu instancia de n8n Cloud. Haz clic en el botón "+" para abrir el panel de nodos.
2. Busca 'Manatal'.
3. Haz clic en el nodo y selecciona tu disparador o acción. Aprende más en esta guía.

2. GUI de Ajustes (Autoalojado)

1. En tu instancia de n8n, ve a Ajustes y luego a Nodos Comunitarios.
2. Haz clic en "Instalar un nodo comunitario".
3. Ingresa el nombre del paquete: @manatal/n8n-nodes-manatal
4. Acepta el aviso de riesgo y haz clic en "Instalar".

3. Línea de Comandos (Autoalojado)

Si tu instancia no admite la instalación por GUI, puedes instalar el nodo manualmente mediante npm, y luego reiniciar tu instancia de n8n.

1. Accede a tu shell de Docker:

docker exec -it n8n sh

2. Crea ~/.n8n/nodes si aún no existe, y navega dentro de él:

mkdir ~/.n8n/nodes
cd ~/.n8n/nodes

3. Instala el nodo:

npm install @manatal/n8n-nodes-manatal

4. Reinicia tu instancia de n8n después de la instalación. Consulta la guía de instalación manual de n8n para más detalles.

4. Archivo de Configuración (Autoalojado)

Si tu equipo de TI configura las instancias de n8n automáticamente, el nodo de Manatal se puede incluir en la configuración de tu instancia para que se instale al iniciar, con una versión específica seleccionada. Esto normalmente lo gestiona quien administra tu implementación de n8n.

Pídeles que consulten la guía de instalación mediante variables de entorno de n8n para los pasos de configuración. El nombre del paquete es @manatal/n8n-nodes-manatal.

Habilitar la Integración de n8n

Obtén tu Clave de API de Manatal

1. Dirígete a la siguiente página. Alternativamente, haz clic en "Administración" desde tu menú lateral y abre la categoría "Funciones".
   
   
2. Haz clic en "API Abierta".
   
3. Haz clic en "Generar nuevo token".
   
4. Completa el nombre del token de API (por ejemplo, "Integración n8n") y haz clic en "Generar".
   
5. Copia la clave de API generada.
   
6. Inicia sesión en tu cuenta de Manatal y localiza la conexión de la aplicación Manatal. Ingresa el token de API de Manatal para completar la integración. Aprende más aquí.

Casos de Uso Comunes

Usa estos flujos de trabajo como inspiración de lo que es posible al conectar Manatal con el resto de tu stack de reclutamiento.

Firmas Electrónicas y Ofertas

Caso de Uso: Activa automáticamente documentos legales y cartas de oferta en el momento en que un candidato pasa a la etapa "Ofertado". Puedes precompletar estos documentos con datos extraídos directamente de Manatal (como el nombre, el salario o el puesto), garantizando la precisión y ahorrando a tu equipo la entrada de datos repetitiva.

• DocuSign: Al mover un Match, filtrado a la etapa Ofertado → Envía la carta de oferta o el contrato de empleo correspondiente para firma electrónica.
• Dropbox Sign: Al mover un Match, filtrado a la etapa Ofertado → Envía una solicitud de firma precompletada con los datos del candidato y del puesto.
• PandaDoc: Al mover un Match, filtrado a la etapa Ofertado → Genera y envía un acuerdo de contratista precompletado desde Manatal.

Filtrado de Currículos con IA

Caso de Uso: Filtra candidatos a gran escala. Cuando se crea un nuevo candidato en Manatal, un modelo de IA califica y resume su idoneidad respecto a la vacante, escribe el resultado como una Nota en su perfil, y alerta a un reclutador cuando la puntuación supera tu umbral.

• OpenAI: Cuando se crea un Candidato en Manatal → Envía su currículo y la descripción del puesto a un modelo de GPT y registra la puntuación de idoneidad como una Nota en Manatal.
• Anthropic Claude: Cuando se crea un Candidato en Manatal → Genera una evaluación detallada con Claude y agrégala como una Nota en Manatal con las brechas de experiencia señaladas.
• Google Gemini: Cuando se crea un Candidato en Manatal → Extrae datos estructurados (habilidades, experiencia, educación) del currículo y actualiza el perfil del candidato en Manatal.
• Slack: Continuando el mismo flujo de trabajo, cuando la puntuación supera tu umbral → Publica un resumen del candidato en tu canal de reclutadores.

HRIS e Incorporación

Caso de Uso: Cierra la brecha entre reclutamiento y RR. HH. Una vez que un match llega a tu etapa "Contratado", sincroniza los datos del candidato directamente con tu HRIS para iniciar la incorporación, y abre automáticamente las tareas de soporte correspondientes.

• BambooHR: Al mover un Match, filtrado a la etapa Contratado → Crea un nuevo registro de empleado precompletado con los datos del candidato.
• Workday: Al mover un Match, filtrado a la etapa Contratado → Inicia una transacción de contratación y asigna la lista de verificación de incorporación correspondiente.
• Jira: Al mover un Match, filtrado a la etapa Contratado → Crea un ticket de tarea de incorporación y lo asigna al equipo correspondiente.

Sincronización de Datos y Reportes de Reclutamiento

Caso de Uso: En un horario nocturno, extrae cada candidato, match y vacante actualizados desde la última ejecución y escríbelos directamente en tu base de datos o data warehouse. Mantiene tus paneles de BI actualizados sin exportaciones manuales ni middleware.

• PostgreSQL / MySQL: En un disparador programado nocturno, Obtén Candidatos y Matches → Inserta o actualiza registros en tu base de datos interna de reclutamiento.
• Google BigQuery: En un disparador programado nocturno, Obtén Candidatos y Matches → Transmite registros a tu data warehouse para análisis a gran escala.
• Google Sheets: En un disparador programado nocturno, Obtén Muchos Matches actualizados → Agrega un resumen diario del proceso para las partes interesadas.

Programación de Entrevistas y Seguimiento

Caso de Uso: Envía una confirmación por correo electrónico en el momento en que se programa una entrevista, materiales de preparación 24 horas antes, y un recordatorio el día de la entrevista, todo a partir de un solo cambio de etapa en Manatal.

• Gmail / Outlook: Al mover un Match, filtrado a la etapa Entrevista → Envía una confirmación de inmediato, materiales de preparación después de 24 horas, y un recordatorio en la mañana de la entrevista.
• Google Calendar: Al mover un Match, filtrado a la etapa Entrevista → Crea una invitación de calendario para el candidato y el panel de entrevistadores.

Comunicación del Equipo

Caso de Uso: Mantén a todo el equipo actualizado en tiempo real. Publica un resumen del movimiento del proceso directamente en la plataforma de chat de tu equipo.

• Slack: Al mover un Match → Publica un resumen del cambio de etapa en tu canal de reclutamiento.
• Microsoft Teams: Cuando se crea un Candidato en Manatal → Publica una tarjeta de resumen del candidato en el canal de tu equipo de contratación.

Buenas Prácticas para Crear Flujos de Trabajo

1. Activa tu Flujo de Trabajo:
   • n8n registra el disparador con Manatal solo cuando un flujo de trabajo está activado. Mientras un flujo de trabajo esté inactivo, los eventos de Manatal no le llegarán. Crea y prueba usando los controles de prueba manual de n8n, y actívalo cuando estés listo para pasar a producción.
2. Comienza con un flujo de trabajo simple de 2 nodos.
   • Antes de crear flujos de trabajo complejos de múltiples etapas, comienza con un solo Disparador y una sola Acción (por ejemplo, Manatal a Slack). Una vez que te sientas cómodo con el flujo de datos, puedes empezar a agregar más pasos.
3. Usa Convenciones de Nomenclatura Descriptivas:
   • A medida que crees más automatizaciones, puede volverse difícil gestionarlas. Nombra tus flujos de trabajo según el flujo, como: "[Manatal → DocuSign] Enviar Carta de Oferta cuando la Etapa sea Ofertado." También puedes etiquetar tus flujos de trabajo para agrupar automatizaciones relacionadas.
4. Aprovecha los Nodos "IF":
   • Los disparadores se activan en cada evento coincidente en Manatal. Usa el nodo IF integrado de n8n para asegurarte de que el flujo de trabajo continúe solo cuando se cumplan criterios específicos (por ejemplo, solo una etapa de proceso en particular, o solo vacantes de tipo "Tiempo Completo"). Esto mantiene tus datos limpios y reduce ejecuciones innecesarias. Aprende más sobre dividir flujos de trabajo con condicionales.
5. Prueba con Datos "Ficticios":
   1. Crea un candidato o vacante de prueba en Manatal para activar tu flujo de trabajo por primera vez. Esto te permite ver exactamente cómo aparecen los datos en la aplicación de destino antes de aplicarlos a postulantes reales. Puedes revisar cada ejecución en tu historial de ejecuciones para ver exactamente qué datos pasaron por cada paso.
6. Configura un Flujo de Trabajo de Errores:
   1. n8n te permite asignar un flujo de trabajo dedicado a la gestión de errores, para que tu equipo sea notificado automáticamente si una automatización falla. Esto mantiene tu flujo de datos confiable. Consulta la guía de n8n sobre cómo manejar los errores con elegancia.

Para más información sobre el diseño, la prueba y el mantenimiento de flujos de trabajo, consulta la guía de n8n para crear flujos de trabajo.

Preguntas Frecuentes

P1. ¿Qué Disparadores y Acciones de Manatal están disponibles en n8n?

La integración ofrece 7 disparadores y 69 acciones en 19 recursos. Puedes consultar la lista completa en nuestra página de referencia de Disparadores y Acciones.

P2. ¿Necesito una cuenta de n8n de pago para usar la integración de Manatal?

Puedes comenzar con el plan gratuito de n8n Cloud, o autoalojar n8n de forma gratuita. Dependiendo de la complejidad de tus flujos de trabajo o de tu volumen de ejecuciones mensuales, es posible que eventualmente necesites una suscripción de pago de n8n.

P3. ¿Qué planes de Manatal incluyen acceso a la integración de n8n?

La integración requiere acceso a la API Abierta, que está incluido en nuestro Plan Enterprise Plus. Si estás en un plan diferente, contacta a nuestro equipo de soporte para hablar sobre la actualización o la habilitación del acceso a la API para tu cuenta.

P4. ¿La transferencia de datos entre Manatal y n8n es instantánea?

Casi instantánea. Tan pronto como ocurre un evento disparador (como la creación de un nuevo candidato), los datos se envían a tu flujo de trabajo activo de n8n mediante un webhook en cuestión de segundos.

P5. Estoy recibiendo un error de 'No autorizado'; ¿cómo lo soluciono?

Esto generalmente significa que el Token de API ha sido eliminado o desactivado dentro de Manatal. Para solucionarlo, simplemente genera un nuevo token de API Abierta en los ajustes de Administración de Manatal y actualiza la credencial en la sección "Credenciales" de tu instancia de n8n.

P6. ¿Puedo eliminar registros de Manatal a través de n8n?

No. Por seguridad, la integración deliberadamente no ofrece operaciones de eliminación. Los registros solo se pueden crear, consultar y actualizar.