Saltar al contenido
KendorDocs

Cómo conectar Ashby con Kendor

Para propietarios ·

Crea una clave de API de Ashby con los permisos que indica Kendor, pégala en Integraciones y Kendor configura el webhook y sus campos hasta donde la clave lo permita.

Ashby se conecta con una sola clave de API. Crea la clave en Ashby, pégala en Integraciones → Ashby en Kendor, y Kendor comprueba sus permisos, registra el webhook y crea sus campos en la candidatura, hasta donde la clave lo permita. Después, una lista de comprobación muestra lo que está hecho y lo que, en su caso, queda por hacer a mano en Ashby.

Antes de empezar

  • Tu organización tiene el plan de Kendor, que incluye la integración con Ashby, y la hemos activado contigo.
  • Eres Propietario en Kendor. Los editores y los observadores ven la tarjeta de Ashby con el texto Solo los propietarios pueden gestionar Ashby.
  • Puedes crear claves de API en los ajustes de administración de Ashby.

Crea una clave de API en Ashby

En Ashby, abre Admin → API keys y crea una clave para Kendor. Kendor enumera los permisos que necesita en la página de Ashby, en 1 · Crea una clave de API en Ashby.

Obligatorios

Permiso en Kendor Ámbito de Ashby Para qué lo usa Kendor
Leer claves de API apiKeys:read Comprueba qué permisos tiene la clave.
Leer puestos jobs:read Lista tus puestos al configurar las reglas de etapa.
Leer entrevistas interviews:read Lee el plan de entrevistas de cada puesto y sus etapas.
Leer metadatos del proceso de contratación hiringProcessMetadata:read Lee las etapas y los campos de la candidatura.
Escribir candidatos candidates:write Escribe los campos y las notas de Kendor.

Para que Kendor se configure solo

Permiso en Kendor Ámbito de Ashby Para qué lo usa Kendor
Escribir claves de API apiKeys:write Registra el webhook por ti.
Escribir metadatos del proceso de contratación hiringProcessMetadata:write Crea por ti los cinco campos de Kendor.

Estos dos son opcionales. Sin ellos, añades tú mismo el webhook y los cinco campos en Ashby, y Kendor te muestra exactamente qué introducir.

Pega la clave en Kendor

  1. Abre Integraciones en la barra lateral, dentro de Organización.
  2. En la tarjeta de Ashby, dentro de Seguimiento de candidatos, elige Conectar.
  3. En 2 · Pega tu clave de API de Ashby, pega la clave en Clave de API de Ashby y elige Conectar.

Kendor le pregunta a Ashby qué permisos tiene la clave, registra el webhook y busca o crea sus campos. Si Ashby rechaza la clave, el motivo aparece bajo el campo, por ejemplo Ashby rejected the API key.

La clave se guarda cifrada. Después, Kendor solo muestra sus últimos cuatro caracteres: Conectado con la clave que termina en 1234.

Revisa la lista de configuración

La sección Configuración tiene tres filas. Una marca indica que la fila está completa.

  • Permisos de la clave: la clave tiene todos los permisos obligatorios. Si falta alguno, Kendor los nombra. Añádelos a la clave en Ashby y elige Volver a comprobar.
  • Webhook: Ashby avisa a Kendor cuando una candidatura cambia de etapa.
  • Campos de Kendor en las candidaturas: los cinco campos Kendor status, Kendor result, Kendor score, Kendor review y Kendor decision existen en Application en Ashby.

El estado de la parte superior indica Conectado cuando todo está en su sitio y Requiere atención cuando algo falta.

Añade el webhook a mano

Si la clave no puede escribir claves de API, la fila Webhook muestra una URL del webhook y un Token secreto para copiar. En Ashby, abre Admin → Webhooks y añade un webhook de tipo Candidate stage change con esa URL y ese secreto. Usa Mostrar secreto para ver el token completo.

Cada organización tiene su propia URL de webhook y su propio secreto. Ashby firma cada petición con el secreto, y Kendor rechaza cualquier petición cuya firma no coincida.

Crea los campos a mano

Si la clave no puede escribir metadatos del proceso de contratación, crea los campos que falten en Ashby, en Admin → Custom fields, sobre Application, con estos nombres y tipos exactos:

Nombre del campo Tipo
Kendor status String
Kendor result String
Kendor score Number
Kendor review URL
Kendor decision String

Kendor los encuentra por nombre, sin distinguir mayúsculas de minúsculas. Elige Volver a comprobar cuando existan. Los campos que falten simplemente se omiten cuando Kendor escribe los resultados.

Consejo. Volver a comprobar vuelve a leer los permisos de la clave y rehace cualquier configuración que la clave ahora permita. Úsalo siempre que cambies los permisos de la clave en Ashby.

Reemplaza o desconecta la clave

  • Reemplazar clave cambia la clave por una nueva con los mismos permisos. La clave anterior deja de usarse al instante. La URL del webhook y el secreto no cambian, así que un webhook que hayas añadido a mano sigue funcionando.
  • Desconectar elimina la clave, tus reglas de etapa y el webhook que registró Kendor, y Kendor deja de escribir en Ashby. Un webhook que hayas añadido a mano permanece en Ashby hasta que lo borres allí. Las invitaciones ya enviadas siguen siendo válidas.

Si vuelves a conectar tras desconectar, Kendor emite una nueva URL de webhook y un nuevo secreto, así que actualiza cualquier webhook que hayas añadido a mano.

A continuación, elige qué etapas envían una prueba.

¿Te ha resultado útil este artículo?