Referidos

Qué hace

Cuando una persona completa el formulario del programa de referidos o se añade una nueva fila en la planilla de Google Sheets, el flujo verifica los datos del referente y busca si el candidato referido ya existe en Bizneo mediante su email. Según su estado en la plataforma, le asigna la etiqueta de referido, añade una nota con el detalle de quién lo refirió, calcula su categoría y semana de ingreso (Entry Week), y solicita confirmaciones interactivas por Slack para definir si avanza a entrevista. Finalmente, actualiza la planilla con las validaciones, el estado de avance y los avisos de mensajes pendientes para enviar al referente y al referido.

Además, todos los días a las 12:00 corre revisiones automáticas para verificar si los candidatos que no estaban registrados ingresaron a Bizneo, si cuentan con evaluaciones/scorecards o si tienen etiquetas de descarte.

Cuándo se rompe

• Si la persona asignada no responde los botones de confirmación en Slack ("¿El referido avanza a entrevista?"), el proceso queda pausado esperando la interacción y no termina de actualizar la fila en la planilla ni continúa con los siguientes candidatos del lote.
• Si el referido se carga con un email vacío o mal escrito en la planilla, las consultas a Bizneo fallan o no encuentran coincidencias, dejando los campos de validación desactualizados.
• Si se modifican o eliminan columnas clave en la pestaña "Base" de la planilla de Google Sheets (como el ID o los encabezados de validación), las lecturas y actualizaciones de filas dan error.

Detalle técnico

• Se dispara mediante el webhook /programa-de-referidos, dos Google Sheets Trigger que consultan cada minuto la hoja "Base" del spreadsheet 1HmoKi-lsZ7EpVNzIOPLYfsr7tJe1c89lDY2Qu389Onw, y cuatro Schedule Trigger programados a las 12:00.
• Realiza llamadas a la API v3 de Bizneo (https://ats.bizneo.com/api/v3/companies/171404/...) para consultar candidatos por email, agregar notas (company_notes), asignar tags (company_tags como REFERRED y formato EW YYYY-WW) y obtener respuestas de campos personalizados (custom_fields).
• Utiliza el nodo de Slack con operación sendAndWait en el canal C0BFUT48STT para pausar la ejecución hasta que un usuario apruebe o rechace el paso a entrevista.
• Procesa en nodos de código JavaScript la lógica de normalización de correos, cálculo de edad, pertenencia a países de LATAM válidos, detección de etiquetas de descarte (discard, recontact later, Continente donde no operamos) y verificación de scorecards creadas en 2026 o posteriores a la fecha de carga.
• Actualiza múltiples columnas en Google Sheets utilizando el campo ID como clave única de coincidencia (matchingColumns: ["ID"]).

Diagrama

Ficha