Ir al contenido
PynPyn

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.

  • 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.
The Connect to HiBob dialog with the Connect with HiBob button and the Use a service user instead option.
Connect to HiBob offers a HiBob sign-in or a service user ID and token.
  1. En Pyn, abre Settings en la navegación izquierda y después Available bajo Integrations.

  2. 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.”

  3. Para iniciar sesión, selecciona Connect with HiBob, autoriza a Pyn en Bob y vuelve.

  4. 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…”

  5. 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.

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.

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.

  • 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.

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.

  1. 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.

  2. 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.

  3. Suscríbelo a los eventos de empleado (creación, actualización, incorporación y salida), con la carga v2.

  4. 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.

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.