API
API de evaluaciones para ATS, portales y sistemas internos
Qué puedes hacer con la API
Crear procesos de evaluación
Tu sistema crea el proceso y define el perfil del cargo desde su propio flujo.
Enviar candidatos
Agregas candidatos al proceso por API: la invitación a evaluar sale sin digitación manual.
Consultar estado y resultados
Tu sistema consulta el avance de cada candidato y recibe puntaje y link al reporte cuando completa.
Recibir notificaciones
Configura un webhook al crear el proceso y recibe las novedades en tu sistema, sin polling.
Gestionar catálogo y perfiles
Lista evaluaciones disponibles y administra perfiles de cargo desde la integración.
Para quién es
- Empresas con ATS o sistema propio: agrega evaluación sin cambiar tu stack — la señal vuelve a tu sistema.
- Portales de empleo y ATS (partners): integra Kokoro como capa de evaluación para tus clientes; tú mantienes el flujo y la relación. Programa de partners →
- Equipos de RRHH Ops: elimina la digitación doble entre reclutamiento y evaluación.
Para el equipo técnico
Qué datos viajan
Los datos del candidato que tu sistema envía para evaluar, y de vuelta: estados del proceso, puntajes de adecuación y el acceso a los reportes. El detalle campo a campo está en la documentación técnica.
Autenticación y ambientes
Bearer (token JWT) por cuenta, con ambientes de producción y pruebas separados para desarrollar la integración sin tocar datos reales.
Notificaciones
Webhook configurable al crear el proceso: tu sistema recibe los avances sin polling y sin exponer más datos que los del evento.
Seguridad y privacidad de las evaluaciones →
REST + JSON, autenticación Bearer (JWT), ambientes de producción y pruebas. El flujo típico de integración, en pseudocódigo (ejemplo ilustrativo, no documentación):
// 1. crear proceso con webhook de notificaciones
POST crear_proceso { cargo, perfil, webhook: "https://tu-sistema.com/notificaciones" }
// 2. enviar candidatos
POST agregar_candidatos { proceso, candidatos: [{ nombre, email }] }
// 3. recibir novedades en tu webhook (o consultar estado)
GET estado_proceso → { candidato, estado: "Evaluación completada", puntaje, reporte_url }La documentación técnica completa (endpoints, esquemas y credenciales) se comparte en la conversación de integración con nuestro equipo.
Seguridad y datos
Autenticación por token, acceso restringido por cuenta y tratamiento de datos personales con consentimiento del candidato y finalidad declarada de evaluación para selección. Revisa la política de privacidad y los controles de integridad.
Preguntas frecuentes
¿Qué tipo de API es?
Una API REST con formato JSON y autenticación Bearer (token JWT), con ambientes de producción y de pruebas para desarrollar la integración con calma antes de salir a producción.
¿Qué puedo construir con ella?
La conexión entre tu sistema de reclutamiento y la evaluación: crear procesos, enviar candidatos, consultar estados y resultados, y recibir notificaciones vía webhook. Es la misma vía por la que operan integraciones como la de HiringRoom.
¿Cómo obtengo credenciales?
Con el equipo técnico de Kokoro: agenda una conversación y revisamos juntos tu caso, la factibilidad técnica y los accesos. La documentación técnica se comparte en esa conversación.
¿Sirve para un portal o partner que quiere ofrecer evaluación a sus clientes?
Sí. La API permite que un portal de empleo, ATS o consultora integre a Kokoro como capa de evaluación para sus clientes, devolviendo la señal al flujo del partner. Conoce también el programa de partners.
¿Qué pasa con los datos personales de los candidatos?
El tratamiento sigue las políticas de privacidad de Kokoro: consentimiento del candidato, finalidad declarada de evaluación para selección y acceso restringido. Los detalles técnicos y contractuales se revisan en la conversación de integración.
¿La API decide algo sobre los candidatos?
No. La API transporta evaluaciones, estados y resultados. La señal es comparable y trazable; la decisión sobre cada candidato es siempre del equipo humano que gestiona el proceso.
Conecta la evaluación a tu sistema
Agenda una conversación técnica: revisamos tu caso, la factibilidad y te compartimos la documentación.