Cómo obtener tu clave de Holded
Cinco minutos y una sola vez por empresa. Al terminar, el Asistente podrá preparar presupuestos en tu Holded.
Para qué sirve la clave
La clave de la API de Holded deja que el Asistente trabaje en tu Holded en tu nombre: crea presupuestos y consulta tus productos, servicios y contactos. Si el cliente del presupuesto no existe, lo da de alta como contacto.
- Es una sola clave para toda la empresa. Tu equipo usa el Asistente sin verla nunca.
- Solo la puede guardar un administrador de la empresa en el Asistente.
- En Holded necesitas un plan de pago (el plan Free no incluye la API) y acceso al apartado Desarrolladores.
Crea la clave paso a paso
-
Abre la configuración
Entra en Holded, abre el menú de tu cuenta (arriba a la izquierda) y pulsa Configuración.
-
Ve a Desarrolladores › Credenciales
En el apartado Desarrolladores, pulsa Credenciales. Es donde se crean las claves de la API nueva (la v2).
Si ves un aviso para ir a las «Api Keys v1», no lo uses: el Asistente necesita una clave de la v2.
-
Pulsa «Agregar API Token»
Ponle un nombre que reconozcas, por ejemplo Asistente Fastex, si Holded te lo pide.
-
Marca solo estos permisos
Holded te deja elegir, módulo a módulo, si la clave puede leer, escribir o las dos cosas. Marca exactamente estos y nada más:
Qué Acceso Nombre técnico Presupuestos (Ventas) Lectura y escritura sales:estimates.readsales:estimates.writeContactos Lectura y escritura contacts:contacts.readcontacts:contacts.writeProductos (Inventario) Solo lectura inventory:products.readServicios (Ventas) Solo lectura sales:services.readNo hace falta dar acceso a facturas, contabilidad ni a ningún otro módulo.
-
Pulsa «Crear Token» y cópialo
Holded genera un código largo de letras y números. Cópialo entero.
Solo se muestra una vez. Después Holded lo enseña oculto, y la versión oculta no sirve. Si lo pierdes, crea otro.
Dónde pegar la clave
-
Escribe
/webal Asistente en TelegramTe contesta con un enlace de un solo uso al panel de tu empresa. Vale 10 minutos y solo funciona si eres administrador de la empresa.
-
Abre «Holded» en el panel
Es la página de la clave de Holded de tu empresa.
-
Pega la clave y pulsa «Guardar la clave»
El panel la comprueba con Holded antes de guardarla. Se guarda cifrada y no se vuelve a mostrar.
Listo cuando veas «La clave de Holded queda guardada». Todos los administradores reciben un aviso en Telegram.
Trata la clave como una contraseña
- Nunca la envíes por el chat ni por correo, tampoco al Asistente ni a Fastex. El único sitio donde se pega es el panel.
- Puedes retirarla cuando quieras. En Holded, en Configuración › Desarrolladores › Credenciales, elimina ese token y deja de funcionar al momento. En el panel, «Quitar la clave» hace que el Asistente deje de usar Holded.
- Para cambiarla, crea un token nuevo en Holded con los mismos permisos, pégalo en el panel y guárdalo: sustituye al anterior. Después elimina el antiguo en Holded.
- Si crees que alguien la ha visto, cámbiala ya.
Problemas frecuentes
«Holded no acepta esa clave»
La clave está mal copiada (o es la versión oculta), se ha eliminado en Holded, o le falta el permiso de Productos. Crea un token nuevo con los permisos de la tabla y pégalo completo.
La clave se guardó, pero el Asistente no puede crear el presupuesto
Al guardar, el panel solo comprueba que puede leer productos. Si falta otro permiso (presupuestos, contactos o servicios), el fallo aparece al usarlo. Crea un token nuevo con todos los permisos de la tabla y sustituye el anterior.
Antes funcionaba y ha dejado de hacerlo
Alguien ha eliminado o cambiado el token en Holded, o el plan de Holded ha cambiado. Crea uno nuevo y guárdalo en el panel.
«Solo los administradores de la empresa pueden gestionar la clave de Holded»
Tu usuario no es administrador de la empresa en el Asistente. Pídeselo a un administrador: puede guardar la clave él o hacerte administrador.
No veo «Desarrolladores» en Holded
Tu usuario de Holded no tiene acceso a ese apartado o la cuenta está en el plan Free. Pide a quien gestiona Holded en tu empresa que te dé el rol de desarrollador (o un rol con acceso a Desarrolladores) o que cree él la clave.
«Ahora no he podido comprobar la clave con Holded»
Holded no respondió a tiempo y la clave no se ha guardado. Vuelve a intentarlo en unos minutos.
¿Sigues con dudas? Escribe /humano al Asistente y te ayuda una persona de Fastex.