Claves de agente para scripts y automatizaciones
Crea una clave de agente, elige lo que puede hacer, guárdala porque se muestra una sola vez, renuévala antes de que caduque y revócala.
En esta página
Una clave de agente permite que un script, una automatización o un trabajo de CI hable con Verimly sin una pantalla de inicio de sesión. La clave actúa como la persona que la creó, con como máximo los derechos de esa persona. Todo lo que use la clave deja de funcionar en el momento en que la revocas.
Si usas una app como Claude o ChatGPT, no necesitas una clave: conéctala como se describe en Conecta tu propio agente de IA a Verimly.
Antes de empezar
- Permitir agentes debe estar activado en Ajustes › IA y agentes. Lo controla un propietario. Si está desactivado, las claves dejan de funcionar.
- Una clave actúa como tú, así que nunca puede ver ni cambiar más de lo que permite tu rol. Un cajero que marca Cambiar la carta no obtiene nada extra, porque su rol no puede cambiar la carta.
- Si Solo lectura para todos está activado, toda clave nueva es de solo lectura elijas lo que elijas.
- Trata una clave como una contraseña: cualquiera que la tenga puede actuar como tú dentro de sus permisos.
Crea una clave
- Abre Ajustes › IA y agentes, busca Claves de agente y elige Crear clave.
- Introduce un Nombre que diga para qué sirve, como Script del informe semanal.
- En Qué puede hacer, deja Solo lectura activado, o desactívalo para permitir cambios y marca los permisos que necesites (consulta más abajo). Ver tu negocio siempre está incluido.
- En Locales elige Todos los locales, o Solo estos locales y escoge al menos uno.
- Elige Caduca: a los 30, 90 o 365 días. Todas las claves caducan; no hay una clave que viva para siempre.
- Elige Crear clave.
- Copia tu clave ahora. Empieza por
vk_live_y se muestra una sola vez. Guárdala en un gestor de contraseñas o en los secretos de tu CI y después elige Ya la he copiado.
Envía la clave en la cabecera Authorization como token bearer: Authorization: Bearer vk_live_…. Una clave funciona tanto en la dirección de servidor completa como en la de Solo lectura que se muestran en la misma página. Las claves no pueden pedir a una persona que apruebe más acceso, así que no pueden ir más allá de los permisos que les diste.
Permisos
| Permiso | Qué permite |
|---|---|
| Ver tu negocio | Ventas, carta, stock, horario del personal, reservas e informes: lo que puedes ver tú mismo |
| Cambiar la carta | Productos, precios, categorías y qué está agotado |
| Gestionar reservas | Crear, mover y cancelar reservas |
| Gestionar personal y turnos | Perfiles del personal, invitaciones y el cuadrante |
| Gestionar pedidos online | Aceptar pedidos online y actualizar su estado y notas. Nunca reembolsos ni anulaciones. Ninguna acción de agente usa todavía este permiso. |
Los agentes nunca pueden mover dinero: ni reembolsos, ni anulaciones, ni liquidaciones, ni ajustes de pago.
Ver y gestionar claves
La lista muestra cada clave con su nombre, los primeros caracteres de la clave, quién es el Actúa como, Último uso (o Aún sin usar), y Caduca o Caducado con la fecha. Los propietarios ven todas las claves del negocio; los demás ven las suyas.
Renueva una clave antes de que caduque
Elige Renovar en la clave. Obtienes un secreto nuevo con los mismos ajustes, y el antiguo deja de funcionar al instante. La clave nueva conserva los días restantes. Actualiza tu script enseguida. Un propietario que renueva la clave de otra persona se hace cargo de ella: la clave nueva actúa como el propietario.
Revoca una clave
Elige Revocar y confirma. Todo lo que use la clave deja de funcionar al instante. Hazlo si la clave se pegó en algún sitio donde no debía, si un compañero se va o si el script se retira.
Cuando se quita a una persona del negocio, también se revocan sus claves y sus apps conectadas.
Límites
- Las llamadas se cuentan por mes para el negocio: Starter 3000, Pro 10 000 y Business 30 000 por local, agrupadas. La página muestra … de … llamadas de agente y cuándo se reinicia.
- Cada clave puede hacer 60 llamadas por minuto en Starter y Pro, 120 en Business. Si se supera el límite, la llamada se rechaza con un mensaje para esperar.
Preguntas frecuentes
He perdido la clave
No se puede volver a mostrar. Crea una clave nueva (o renueva la antigua) y revoca la perdida.
La clave funcionaba ayer y ahora da un error
Puede estar revocada (AGENT_KEY_REVOKED), caducada, o Permitir agentes puede estar desactivado (MCP_DISABLED). Revisa la clave en la lista y el interruptor de la página.
¿Por qué la clave puede leer pero no cambiar nada?
Solo lectura está activado para la clave, o Solo lectura para todos está activado para el negocio, o no se seleccionó el permiso. Consulta AGENT_READ_ONLY en Qué pueden y qué no pueden hacer los agentes.
Si algo sale mal
Mira Actividad en la misma página: lista todas las acciones de los agentes, con resultado y hora. Si se ha filtrado una clave, revócala primero y después revisa el registro de Comprueba quién cambió qué para ver qué hizo. Usa Contactar con soporte si necesitas ayuda.