HiBob
La integración con HiBob lee las personas a través de la API de Bob y mantiene al día el Directory: nombres, correo de trabajo y privado, fechas de inicio y de baja, fecha de fin del periodo de prueba, departamento, puesto, sede, manager, HRBP y, si tienes un campo personalizado para ello, buddy. Pyn solo lee; nunca escribe en Bob.
Antes de empezar
Sección titulada «Antes de empezar»- Eres administrador o propietario en Pyn.
- Elige cómo conectar. Connect with HiBob te lleva a iniciar sesión en Bob y autorizar a Pyn. Use a service user instead usa un Service User ID y un API Token de Bob que un administrador de Bob crea bajo Settings > Integrations > Service Users.
- Concede al usuario de servicio, o a tu propia cuenta, acceso de lectura a las categorías de Bob que contienen los campos que Pyn lee: About, Address (ciudad, país y código postal), Basic Info, Employment, Home (correo privado), Jobs, Lifecycle, Payroll > Employment (contrato), Personal (fecha de nacimiento corta) y Personal Contact Details, para los empleados, incluidas las personas antes de su incorporación y los salientes.

Conecta
Sección titulada «Conecta»-
En Pyn, abre Settings en la navegación izquierda y después Available bajo Integrations.
-
Selecciona el mosaico HiBob. Se abre el diálogo Connect to HiBob: “You will be redirected to HiBob to authorize Pyn to access your company’s employee data.”
-
Para iniciar sesión, selecciona Connect with HiBob, autoriza a Pyn en Bob y vuelve.
-
Para usar un usuario de servicio, selecciona Use a service user instead, pega el Service User ID y el API Token, y selecciona Connect. El diálogo muestra “Validating those credentials…”
-
Si todo va bien, un aviso dice “Your HiBob integration has been added to Pyn. It will take a minute or two for employee data to be pulled from HiBob.”
Errores que puede mostrar el diálogo: “Could not verify the credentials — the service user ID or token appears to be invalid.” / “The credentials are valid but the service user lacks the permissions needed to read employees. Grant the service user people-read access in Bob.” / “An unexpected error occurred. Please check the credentials and try again. If the error persists, contact support.” El último es también lo que muestra Connect with HiBob cuando Pyn no puede comenzar el inicio de sesión.
Qué se sincroniza
Sección titulada «Qué se sincroniza»Pyn actualiza desde Bob aproximadamente una vez por hora y registra cada ejecución bajo History. La pestaña Advanced enumera Fields in Report: los ids de campo de Bob que devolvió tu tenant y para cuántas personas, que es donde mirar antes de concluir que un campo no está disponible.
| Propiedad en Pyn | Desde Bob |
|---|---|
| Nombre para mostrar, nombre legal | Display name, o nombre y apellido |
| Correo de trabajo, correo personal | Email y correo privado |
| Fecha de inicio, fecha de antigüedad | Fecha de inicio; la antigüedad desde la fecha de inicio original, si no, desde la fecha de inicio |
| Fecha de baja, fecha de fin del periodo de prueba | Las fechas internas de baja y de fin del periodo de prueba |
| Departamento, puesto, ubicación | Departamento, puesto y sede de trabajo (recurre a la ciudad de la dirección) |
| Manager | Reports-to, emparejado por id de Bob o por id de empleado en la empresa |
| HRBP | El campo employee.hrbp |
| Buddy | El campo personalizado indicado en la integración como campo de buddy, configurado con el soporte de Pyn |
| Cumpleaños, país, código postal, zona horaria | Fecha de nacimiento corta y dirección; la zona horaria a partir del país y el código postal |
| Tipo de contrato, oficina de trabajo y otras columnas personalizadas | Extensiones del workspace mapeadas a un id de campo de Bob |
Consulta Mapeo de campos de HiBob para el id de campo de Bob detrás de cada propiedad y qué comprobar cuando falta una, y Campos del HRIS para la matriz.
Pruébalo
Sección titulada «Pruébalo»Abre el mosaico de HiBob bajo Installed y comprueba en History que hay una actualización correcta; después abre Employees y confirma fechas de inicio, puestos y managers.
Reconecta o desconecta
Sección titulada «Reconecta o desconecta»- Reconnect abre Reconnect to HiBob con las mismas dos opciones. Tras rotar el token de un usuario de servicio en Bob, pega aquí el nuevo API Token. “Your HiBob integration has been updated.” lo confirma.
- Deactivate detiene la sincronización; Activate la reanuda.
Webhook
Sección titulada «Webhook»En los workspaces donde el webhook de HiBob está habilitado, el panel de HiBob instalado tiene una pestaña Webhook, para que Bob avise a Pyn de los cambios de empleados a medida que ocurren. Creas el webhook en Bob con una dirección que Pyn te da y pegas en Pyn el secreto de firma de Bob.
-
Abre el mosaico de HiBob bajo Installed y selecciona la pestaña Webhook. El aviso dice “Have HiBob tell Pyn about employee changes as they happen, rather than waiting for the next sync.” Selecciona Set Up Webhook.
-
La pestaña muestra ahora la dirección a la que publicar, con Copy URL. En los ajustes de webhooks de Bob, crea un webhook que publique en esa URL.
-
Suscríbelo a los eventos de empleado (creación, actualización, incorporación y salida), con la carga v2.
-
Pega el secreto de firma que Bob muestra para el webhook en Signing Secret y selecciona Save. Hasta que lo hagas, el aviso dice “This webhook accepts nothing until it has HiBob’s signing secret.”
Con el secreto guardado, el aviso dice “Pyn holds this webhook’s signing secret, and accepts what HiBob signs with it.” seguido de Last received y la hora de la última entrega, o Nothing received yet. El secreto no se vuelve a mostrar; para rotarlo, pega el nuevo en Replace Signing Secret y selecciona Save. Pyn registra una vez bajo History cada entrega que acepta, como Webhook Processed (por ejemplo “Received employee.updated for employee 123”) o Invalid Webhook Payload. Lo que llega al Directory sigue viniendo de la actualización. Una entrega que nombra a un empleado que ya está en el Directory también dispara cualquier automation publicada cuyo trigger sea HiBob Webhook para ese tipo de evento; consulta el Catálogo de triggers. Pyn rechaza una entrega que no supera la verificación o que llega mientras la integración está desactivada. Deja que termine la primera actualización tras conectar antes de esperar que cambie Last received.
Solución de problemas
Sección titulada «Solución de problemas»| Qué ves | Qué significa |
|---|---|
| History: “Error: Authentication failed, please reconnect” | El token se rotó o se revocó el inicio de sesión. Reconecta. |
| History: “Error: Insufficient HiBob permissions” | El usuario de servicio perdió el acceso de lectura de personas o un grupo de campos. Amplía sus permisos en Bob. |
| Faltan personas o campos | Revisa Fields in Report bajo Advanced; un campo que no está ahí no es visible para el usuario de servicio, o tu tenant no lo tiene. |
| Los empleados salientes siguen activos | Concede acceso a la categoría Lifecycle de los antiguos empleados para que se sincronicen las fechas de baja. |
| History: Invalid Webhook Payload | Bob publicó una entrega que Pyn no pudo leer. Comprueba que el webhook en Bob está suscrito a los eventos de empleado con la carga v2. |
| Last received del webhook se queda en Nothing received yet | Falta el secreto de firma o es incorrecto, el webhook en Bob publica en otra URL, o no se ha ejecutado ninguna actualización desde la conexión. Guarda el secreto que muestra Bob, comprueba la URL y revisa en History que hay una actualización completada. |
Relacionado
Sección titulada «Relacionado»- Integrations para el catálogo.
- Mapeo de campos de HiBob para el campo de Bob detrás de cada campo de Pyn.
- Campos del HRIS para la matriz de campos.
- Cadencia de sincronización y emparejamiento para calendarios y emparejamiento.
- Employees para comprobar los registros sincronizados.