Pon evaluación verificada dentro del sistema que ya usas.
Hirovia es una capa de medición, no otro sitio donde iniciar sesión. Cuatro formas de conectarlo — desde una regla de correo que lleva dos minutos hasta una integración REST completa con tu ATS.
Consigue una clave sandbox — gratis Ver la referencia de la API
Los candidatos de sandbox nunca se facturan · sin tarjeta para empezar
Cuatro formas de conectar, por orden de esfuerzo.
Pon en copia o reenvía las candidaturas a tu dirección privada de entrada. Hirovia lee el remitente, identifica el puesto por el asunto, guarda el CV e invita al candidato. Una regla de reenvío en Gmail o Outlook es toda la integración.
Ideal para: equipos cuyas candidaturas ya llegan por correoUna página de candidatura de marca blanca con el nombre de tu empresa. Enlázala desde tu web de empleo o insértala en un iframe. Los candidatos se postulan y son evaluados en un mismo flujo.
Ideal para: páginas de empleo sin un ATS detrásPega una lista de nombres y correos, elige el puesto, y cada candidato recibe un enlace único. Exporta los resultados puntuados en CSV.
Ideal para: campañas puntuales y pilotosCrea candidatos desde tu ATS en el momento en que llega una candidatura, consulta las puntuaciones y escribe la puntuación compuesta de vuelta en tu propio registro. JSON de entrada, JSON de salida, autenticación con bearer token.
Ideal para: proveedores de ATS, RPO y cualquiera con un sistema interno de selecciónLos rebotes y las quejas de spam se informan de vuelta automáticamente, así una invitación a una dirección mal escrita aparece como un problema en lugar de como silencio.
Incluido en todos los métodosUna clave de sandbox crea registros de candidato reales que nunca se facturan — y te permite simular una evaluación completada, para que puedas probar tu lógica de puntuación sin hacer una prueba de 30 minutos.
Gratis e ilimitadoQué te da realmente la integración.
Si gestionas la contratación
- La evaluación empieza en cuanto llega una candidatura, no cuando alguien encuentra un rato
- Las puntuaciones viven junto a tus propias fichas de candidato — sin un segundo sistema que consultar
- Tu ATS puede ordenar, filtrar y descartar por capacidad verificada en lugar de por palabras clave
- Ningún paso de copiar y pegar que olvidar un día ajetreado
Si desarrollas software de contratación
- Añade una capa de evaluación real sin construir psicometría ni contratar a un psicólogo I/O
- 20 perfiles de puesto investigados, puntuación, controles de validez y guías de entrevista, listos para usar
- Marca blanca: tus usuarios nunca ven nuestra marca
- Precio por evaluación que puedes revender, desde $0.75 a volumen
La API en seis endpoints.
URL base https://hirovia.com/api/v1. Autentícate con un bearer token de Ajustes → API. Las claves que empiezan por hv_test_ son de sandbox; las hv_live_ son reales y cuentan para tu plan. 120 peticiones por minuto y clave.
| Endpoint | Qué hace |
|---|---|
GET /ping | Confirma que la clave funciona e indica en qué modo estás |
GET /roles | Los 20 ids de puesto para los que puedes evaluar |
POST /candidates | Crea un candidato y devuelve su enlace único de evaluación |
GET /candidates | Lista los candidatos, filtrable por estado y puesto |
GET /candidates/{id} | Un candidato con sus puntuaciones; añade ?include=report para el informe completo |
POST /candidates/{id}/simulate | Solo en sandbox. Simula una evaluación completada para que puedas probar el tratamiento de resultados |
Crear un candidato
curl -X POST https://hirovia.com/api/v1/candidates \
-H "Authorization: Bearer hv_test_..." \
-H "Content-Type: application/json" \
-d '{
"name": "Jane Doe",
"email": "jane@example.com",
"role": "cam",
"send_email": true
}'
{
"id": 412,
"name": "Jane Doe",
"role": "cam",
"role_title": "Corporate Accounts Manager",
"status": "invited",
"test": true,
"assessment_url": "https://hirovia.com/a/xJ2f8Kq1",
"invitation_emailed": false
}
Envía tú mismo al candidato a assessment_url, o activa send_email y Hirovia le escribe con el nombre de tu empresa.
Leer el resultado
curl https://hirovia.com/api/v1/candidates/412 \ -H "Authorization: Bearer hv_test_..."
{
"id": 412,
"status": "completed",
"completed_at": "2026-08-19T10:41:00Z",
"scores": {
"composite": 89,
"role_fit": 90,
"band": "Exceptional",
"scenarios_pct": 78,
"validity_flags": []
}
}
composite es el número de ranking de 0 a 100. band es la lectura en lenguaje llano del ajuste al puesto. Un validity_flags no vacío significa que las respuestas parecieron descuidadas o manipuladas — trata ese perfil con desconfianza sea cual sea su puntuación.
Probar todo el ciclo sin un candidato real
curl -X POST https://hirovia.com/api/v1/candidates/412/simulate \
-H "Authorization: Bearer hv_test_..." \
-H "Content-Type: application/json" \
-d '{"band": "weak"}'
Devuelve un candidato completado y bien formado, incluida la estructura del informe, para que puedas construir y probar el tratamiento de resultados en minutos. Pasa "band": "weak" para obtener un perfil marcado y de puntuación baja y comprobar también tu ruta de error.
Errores
Todo fallo devuelve la misma forma, con un estado HTTP que significa lo que dice.
{ "error": { "message": "unknown role 'manager' - call GET /api/v1/roles for valid ids",
"status": 400 } }
| Estado | Significado |
|---|---|
| 400 | Algo en tu petición está mal; el mensaje dice qué |
| 401 | Clave ausente, inválida o revocada |
| 402 | Prueba gratuita agotada — añade un método de pago |
| 403 | Endpoint solo de sandbox llamado con una clave real |
| 404 | No existe ese candidato en tu cuenta |
| 429 | Más de 120 peticiones en un minuto |
Los candidatos creados por API se facturan igual que los demás.
Qué cuenta
- Solo las evaluaciones completadas. Crear un candidato por la API es gratis, igual que cualquier invitación
- Los candidatos con clave real cuentan para el volumen incluido en tu plan y consumen tu crédito prepago
- Las tarifas por volumen se aplican automáticamente — hasta $0.75 por evaluación a escala
- Tus primeros cinco candidatos son gratis, se hayan creado como se hayan creado
Qué no cuenta nunca
- Los candidatos de sandbox nunca se facturan y nunca consumen tu prueba gratuita
- Las evaluaciones simuladas son gratuitas e ilimitadas
- Las invitaciones que nunca se realizan no cuestan nada, jamás
- Las invitaciones rebotadas o no entregadas no cuestan nada
Así puedes construir y probar la integración entera a coste cero, y luego cambiar una sola clave para pasar a producción.
Ten la certeza de que quien hizo la prueba es quien vas a entrevistar.
La IA puede redactar el CV. Un amigo puede hacer la evaluación. Con la verificación de identidad activada, cada candidato fotografía un documento oficial y se hace un selfie en directo antes de la primera pregunta, de modo que la puntuación queda ligada a una persona real y verificada, y el nombre del documento se compara con el de la candidatura.
La comprobación se hace al principio, así que nadie puede responder primero y verificarse después. Sin documento verificado no hay evaluación.
Stripe Identity lee el documento, comprueba sus elementos de seguridad, confirma que el selfie es de una persona real y lo coteja con la foto del documento. Funciona con pasaportes, permisos de conducir y documentos nacionales de más de 100 países.
El informe muestra verificado / no verificado y si el nombre del documento coincide con la candidatura. Hirovia nunca guarda imágenes de documentos, números ni fechas de nacimiento: nada sensible llega a tu cuenta.
Se cobra una vez por candidato en su primer intento de verificación, sea cual sea el resultado; quien no lo supera tiene un reintento sin coste adicional. Nunca se cobra a los candidatos. La verificación es una señal antifraude para tu proceso, no una comprobación de antecedentes ni un informe de solvencia.
Consigue una clave de sandbox y pruébalo ahora.
Gratis, ilimitada, y nada se factura hasta que cambies a una clave real.