Sincroniza personas desde BambooHR
Conecta BambooHR con una clave de API y Polzy mantiene a tus miembros al día según una programación, y a los pocos instantes de un cambio si añades un webhook de BambooHR.
En esta página
- 1Antes de empezar
- 2Crea una clave de API en BambooHR
- 3Conecta BambooHR en Polzy
- 4Ajustes de sincronización
- 5Asigna los campos
- 6Previsualiza y lanza la primera sincronización
- 7Recibe los cambios en unos instantes con un webhook
- 8Programación e historial de sincronización
- 9Cuando alguien se va
- 10Solución de problemas
- 11Conviene saber
- 12Enlaces útiles
Conecta BambooHR y Polzy lee tu directorio de empleados según una programación. Las nuevas incorporaciones llegan como miembros de tu espacio de trabajo, los cambios de puesto, departamento o responsable se aplican en la siguiente sincronización, y quien se va deja de recibir encuestas. Si además añades un webhook de BambooHR, un cambio llega a Polzy en unos instantes en lugar de esperar a la siguiente sincronización.
La sincronización de personas está disponible desde Team, y solo los administradores del espacio de trabajo pueden conectar una fuente. Polzy solo lee de BambooHR: nunca escribe en él ni cambia ningún expediente de empleado.
Antes de empezar
Necesitas:
- Ser administrador del espacio de trabajo de Polzy, en Team o superior, con Sincronización de personas activada en Configuración → General → Qué hace este espacio de trabajo.
- Un usuario de BambooHR que pueda crear claves de API y vea a todos los empleados y campos que Polzy debe leer, incluidos los antiguos empleados, las fechas de baja y los supervisores. Una clave de API ve exactamente lo que ve su usuario.
- Tu subdominio de BambooHR: la parte de tu dirección de BambooHR antes de
.bamboohr.com. Parahttps://acme.bamboohr.comesacme. - Para los webhooks: un administrador de BambooHR y la página Integraciones de Polzy, que viene con Business.
Un espacio de trabajo sincroniza desde una sola fuente a la vez. Si hay otra fuente conectada, desconéctala primero. Si tu organización aprovisiona personas mediante SCIM, no se puede conectar ninguna fuente; consulta SCIM.
Crea una clave de API en BambooHR
- Inicia sesión en BambooHR con el usuario cuyo acceso debe tener la clave. Conviene un usuario propio para integraciones: si ese usuario se desactiva, la clave deja de funcionar.
- Haz clic en tu nombre, abajo a la izquierda, y elige API Keys.
- Añade una clave nueva, llámala Polzy y genérala.
- Copia la clave en ese momento. BambooHR solo la muestra una vez.
Consulta BambooHR: Getting started with the API.
Conecta BambooHR en Polzy
- Abre Contactos → Sincronización y campos.
- En Fuentes disponibles, busca BambooHR y elige Conectar. Se abre un panel con tres pasos: Conexión, Ajustes de sincronización y Asignación de campos.
- Escribe tu Subdominio de BambooHR y pega la API Key. Deja Secreto del webhook vacío por ahora; es para el webhook que se explica más abajo.
- Elige Probar conexión. Successfully connected to BambooHR. Found N employees. significa que la clave funciona.
- Elige Siguiente, revisa los ajustes de sincronización (ver abajo) y vuelve a elegir Siguiente.
- En Asignación de campos, mantén la asignación predeterminada o activa Asignación de campos personalizada (ver abajo) y luego elige Conectar.
La clave se guarda cifrada y solo se usa para leer de BambooHR. Polzy la vuelve a comprobar cuando eliges Conectar: si BambooHR la rechaza, no se guarda nada.
Ajustes de sincronización
| Ajuste | Qué hace | Predeterminado |
|---|---|---|
| Frecuencia de sincronización | Cada cuánto lee Polzy de BambooHR: cada 30 minutos, cada hora, cada 4 horas o a diario. | Cada hora |
| Desactivar empleados dados de baja | Quien Polzy trajo de BambooHR y ya no aparece allí se desactiva en la siguiente sincronización. | Activado |
| Enviar correos de invitación | Los miembros nuevos con dirección de correo reciben una invitación para iniciar sesión en Polzy. | Activado |
| Rol predeterminado | El rol que reciben los miembros nuevos: Lector, Editor o Administrador. Solo se aplica a las personas que crea la sincronización. | Lector |
| Guardar datos sin procesar | Guarda junto a la persona en Polzy una copia de cada registro tal como lo envió BambooHR. Déjalo desactivado salvo para investigar una asignación: guarda más datos personales de los necesarios. | Desactivado |
Asigna los campos
Polzy lee BambooHR mediante un informe con los campos que necesita, antiguos empleados incluidos. La asignación predeterminada rellena:
| Campo de Polzy | De BambooHR |
|---|---|
| Correo electrónico | workEmail |
| Nombre, apellidos | firstName, lastName |
| Puesto de trabajo | jobTitle |
| Departamento, oficina | department, location |
| Número de teléfono | mobilePhone |
| ID de empleado, fecha de inicio | id, hireDate |
| Estado activo | deducido de terminationDate y status |
| Responsable | supervisorId |
Para cambiarla, activa Asignación de campos personalizada. Cada fila tiene entonces una fuente que elegir —entre los demás campos disponibles están workPhone, employeeNumber y division— y un valor Si está vacío, usar, que se escribe cuando BambooHR no tiene nada para esa persona. Un valor que BambooHR sí envía nunca se sobrescribe.
Conviene saber:
- Solo se rellenan los campos de tu espacio de trabajo. El departamento o la oficina solo se guardan si tu espacio de trabajo tiene un campo con ese nombre. Añade uno con Añadir campo en Sincronización y campos y luego asígnalo.
- Grupos. Para comparar resultados por un campo, conviértelo en un campo Lista y activa Grupos a su lado en la tabla Asignación de campos. Los valores de BambooHR se emparejan con las opciones del campo.
- Ejemplos reales. Una vez conectado, elige Ajustes en Sincronización y campos y vuelve a abrir Asignación de campos: la lista sale entonces de cinco registros reales, cada uno con un Ejemplo.
- Responsables. El supervisor pasa a ser el responsable de la persona cuando también está en Polzy. Si aún no está, el vínculo se crea en una sincronización posterior. Los responsables necesitan Líneas de reporte activado en el espacio de trabajo.
Previsualiza y lanza la primera sincronización
- En Sincronización y campos, elige Previsualizar sincronización en Historial de sincronización. Polzy calcula qué añadiría, actualizaría y desactivaría una sincronización, sin cambiar nada, y abre el registro donde el resultado aparece como Vista previa.
- Revisa la vista previa. Si los nombres, los correos o los departamentos no cuadran, corrige la asignación en Ajustes y vuelve a previsualizar.
- Elige Sincronizar ahora. El resultado aparece en Historial de sincronización.
Las personas se emparejan por su ID de BambooHR y, después, por dirección de correo, así que alguien a quien ya habías invitado a mano se actualiza en lugar de añadirse dos veces.
Recibe los cambios en unos instantes con un webhook
Sin webhook, los cambios llegan en la siguiente sincronización programada. Con uno, BambooHR avisa a Polzy de qué empleados han cambiado y Polzy lee a cada uno de inmediato.
- En Polzy, abre Integraciones, luego BambooHR, y copia la dirección que aparece en Recepción. Está creada para tu conexión y termina en
/bamboohr. - En BambooHR, abre Account Settings y elige Webhooks. Si no aparece, el soporte de BambooHR puede activar los webhooks en tu cuenta.
- Añade un webhook llamado Polzy, pega la dirección como URL y elige JSON como formato.
- Elige los campos que se vigilan: los que asignas en Polzy, como nombre, correo de trabajo, puesto, departamento, ubicación, estado y supervisor.
- Genera la clave privada y cópiala antes de guardar. BambooHR solo la muestra una vez.
- En Polzy, abre Contactos → Sincronización y campos, elige Ajustes, pega la clave privada en Secreto del webhook y elige Guardar en el último paso.
BambooHR firma cada llamada con la clave privada (X-BambooHR-Signature y X-BambooHR-Timestamp). Polzy rechaza una llamada sin firmar, firmada con otra clave o con más de cinco minutos de antigüedad, y no hace nada dos veces si la misma llamada vuelve a llegar. Cada cambio aparece en Registro completo como una ejecución propia, marcada como Webhook. Consulta BambooHR: Webhooks.
Programación e historial de sincronización
Tras la primera sincronización, Polzy se ejecuta solo con la frecuencia que elegiste, con unos minutos de margen. La línea bajo el nombre de BambooHR muestra cuándo se sincronizó por última vez, cada cuánto se ejecuta y cuántas personas y grupos ha traído. Historial de sincronización muestra las cinco últimas ejecuciones —Correcto, Parcial (se omitieron o fallaron algunas personas), Fallida o Vista previa— y Registro completo abre todas, con cada cambio que hicieron.
Si una sincronización falla, Polzy vuelve a intentarlo más tarde, esperando más cada vez. Tras tres fallos seguidos, o de inmediato si BambooHR rechaza la clave, la fuente muestra Requiere atención y se avisa a los administradores. Sincronizar ahora vuelve a funcionar cuando la fuente está conectada: corrige la clave en Ajustes y guarda.
Cuando alguien se va
- Dado de baja en BambooHR. Una persona con fecha de baja o con el estado Terminated se desactiva en la siguiente sincronización, o al momento con un webhook. Las personas desactivadas no reciben encuestas ni ocupan plaza; sus respuestas anteriores se conservan.
- Ya no está en BambooHR. Con Desactivar empleados dados de baja activado, también se desactiva a quien ya no aparece en absoluto en BambooHR.
- Bloqueado en Polzy. Quien un administrador bloqueó en Polzy sigue bloqueado, diga lo que diga BambooHR.
Una sincronización nunca elimina a nadie.
Solución de problemas
| Lo que ves | Por qué | Qué hacer |
|---|---|---|
| BambooHR refused this API key: … The key needs report access. | La clave se revocó, su usuario se desactivó o ese usuario no puede ejecutar informes. | Crea una clave con un usuario que tenga acceso a informes y pégala en Ajustes. |
| Failed to fetch from BambooHR | No se pudo contactar con BambooHR, o el subdominio no es correcto. | Revisa el subdominio y elige Sincronizar ahora. |
| Todo el mundo aparece como activo, también quien se fue | El usuario de la clave no ve las fechas de baja ni el estado. | Da a ese usuario acceso a esos campos en BambooHR. |
| Los cambios por webhook nunca llegan | No hay ningún Secreto del webhook guardado, no coincide con la clave privada o la dirección es incorrecta. | Genera una clave privada nueva, pégala en Secreto del webhook y revisa la URL en BambooHR. |
| No se importaron N personas: el plan se ha quedado sin plazas. | Cada miembro ocupa una plaza, y el plan está lleno. | Libera plazas o cambia de plan, y luego elige Sincronizar ahora. |
| … ya está importando personas. Desconéctalo antes de conectar otra fuente. | Un espacio de trabajo sincroniza desde una sola fuente a la vez, y hay otra conectada. | Abre los Ajustes de esa fuente y elige primero Desconectar. |
Conviene saber
- Miembros, no contactos. Todas las personas que vienen de BambooHR son miembros: pueden iniciar sesión y cada una ocupa una plaza. Una sincronización que superaría tus plazas importa a las personas que caben, se detiene ahí y avisa a los administradores. Consulta Uso y límites.
- El webhook es opcional. Las sincronizaciones programadas siguen funcionando con o sin él, y recogen lo que un webhook se haya perdido.
- Desconectar o eliminar. En Ajustes, Desconectar detiene la sincronización y conserva los ajustes y el historial, para que puedas volver a conectar más tarde; Eliminar borra la conexión. En ambos casos, las personas ya sincronizadas se quedan en Polzy y dejan de actualizarse.
- ¿Necesitas ayuda? El enlace Preguntar a Polzy del panel de conexión explica dónde está cada valor en BambooHR.
Enlaces útiles
- BambooHR: Getting started with the API — cómo crear una clave de API y encontrar tu subdominio.
- BambooHR: Webhooks — cómo envía y firma BambooHR los cambios.
- Personas y contactos — campos, grupos y miembros.
Artículos relacionados
Los miembros con sesión iniciada pueden preguntar a Polzy o escribir al equipo desde Soporte. La rapidez de nuestra respuesta depende de tu plan.