Clientes API
Para integrar el widget o conectar tus propios sistemas con Wiselook necesitas un cliente API: unas credenciales que tu backend usa para comunicarse con la API de Wiselook. Los administradores los crean desde el engranaje de Configuración → Clientes API.
Obtener acceso
Los clientes API no están habilitados por defecto. Mientras no lo estén, Clientes API no aparece en el menú de Configuración. Para habilitarlos en tu organización, contacta con nosotros.
Crear un cliente
- Desde el engranaje de Configuración → Clientes API, crea un cliente nuevo y dale un nombre
que diga para qué sirve, por ejemplo
Widget del sitio de empleo. - Elige sus permisos (ver más abajo).
- Wiselook te muestra el secreto del cliente una sola vez. Cópialo de inmediato y pásalo a tu desarrollador por un canal seguro; no se puede volver a mostrar.
Un cliente solo actúa en nombre de tu organización. No puede ver ni cambiar datos de otra organización.
Elegir los permisos
Los permisos de un cliente deciden qué puede hacer. Elígelos según lo que vayas a construir, y concede solo lo que necesite:
| Vas a construir | Selecciona |
|---|---|
| Evaluaciones en tu propio sitio web (widget) | Crear sesiones de visitante del widget |
| Invitaciones en bloque (guía) | Crear y revocar códigos de invitación · Listar códigos de invitación y su uso · Listar metodologías adoptadas · Listar etiquetas (si agrupas las invitaciones) |
| Una sincronización con tu sistema de RR. HH. o de personas (guía) | Listar los usuarios de tu organización · Actualizar nombre, rol, estado y etiquetas de un usuario · Listar etiquetas |
| Evaluaciones iniciadas desde tu propio sistema (guía) | Iniciar una evaluación para un miembro y llevar su conversación · Consultar una evaluación y su resultado |
Los permisos quedan fijos al crear el cliente. Si más adelante una integración necesita más, crea un cliente nuevo con los permisos adecuados y revoca el anterior.
En términos de OAuth2, cada permiso es un scope. Tu desarrollador encontrará el nombre técnico de cada uno, y lo que abre, en Autenticación.
Rotar y revocar
- Rotar emite un secreto nuevo, y el anterior deja de funcionar de inmediato. Tu desarrollador debe actualizar la integración con el secreto nuevo.
- Revocar desactiva el cliente para siempre. No se puede volver a activar; crea un cliente nuevo en su lugar.
Rota los secretos de forma periódica, y revoca un cliente de inmediato si su secreto puede haberse filtrado.