Ámbitos de las claves API
Ajustes > Avanzado > Claves API, página reservada a las personas autorizadas a gestionar las claves API. Una nueva clave recibe por defecto el permiso Lectura de llamadas y el modo Vinculada a un usuario, asociado a la persona que la crea.Permisos
El bloque Permisos del formulario propone nueve casillas. Los permisos de escritura no incluyen la lectura correspondiente: una clave que crea llamadas y también debe leerlas marca ambas.
| Permiso | Lo que autoriza | Condición adicional |
|---|---|---|
| Lectura de llamadas | Listar las llamadas visibles para la clave y leer su detalle: transcripción, resumen, participantes, tareas. | — |
| Escritura de llamadas | Crear una llamada a partir de una grabación, modificar o eliminar las notas de IA de las llamadas visibles para la clave. | — |
| Lectura de eventos de reunión | Listar las reuniones próximas y su estado de grabación. | — |
| Escritura de eventos de reunión | Crear una reunión, enviar a ella al asistente o retirarlo. | — |
| Lectura de usuarios | Listar los usuarios de la empresa y leer su perfil. | — |
| Escritura de usuarios | Crear, modificar y desactivar usuarios. | La persona que marca esta casilla debe estar autorizada ella misma a crear y modificar los usuarios. |
| Lectura de equipos | Listar los equipos y sus miembros. | — |
| Escritura de equipos | Crear, modificar y eliminar equipos y su composición. | La persona que marca esta casilla debe estar autorizada ella misma a crear y modificar los equipos. |
| Lectura de la empresa | Leer la información de la empresa. | — |
Una clave nunca puede conceder más de lo que posee la persona que la modifica: la condición solo se aplica en el momento en que se marca la casilla; una clave que ya tiene el permiso no queda bloqueada en una modificación posterior. Las rutas y los campos exactos de cada permiso se describen en la referencia de la API pública.
Reglas de acceso
El campo Reglas de acceso del formulario propone tres modos. Delimitan las llamadas que la clave puede listar, leer o modificar; no cambian nada en los usuarios, equipos o reuniones, que siguen siendo los de toda la empresa.
| Modo | Lo que ve la clave |
|---|---|
| Acceso a todo | Todas las llamadas de la empresa, sin tener en cuenta los equipos ni las reglas de acceso. |
| Vinculada a un usuario | Las llamadas a las que tiene acceso el usuario elegido: las suyas, las de sus equipos y las que le abren las reglas de acceso. Los accesos de la clave siguen a los del usuario. |
| Acceso personalizado | Únicamente las llamadas abiertas por las reglas de acceso de las que la clave es destinataria. Sin regla, la clave no ve ninguna llamada. Al guardar se redirige a la página Reglas de acceso. |
La lista de claves muestra el modo en la columna Reglas de acceso: Acceso a todo, Vinculada a: <nombre del usuario> o Acceso personalizado. Las reglas de acceso dedicadas a las claves API se describen en Tipos de reglas de acceso.