Guía · Configurar herramientas

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.

Antes de empezar

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.
En Holded

Crea la clave paso a paso

  1. Abre la configuración

    Entra en Holded, abre el menú de tu cuenta (arriba a la izquierda) y pulsa Configuración.

  2. 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.

  3. Pulsa «Agregar API Token»

    Ponle un nombre que reconozcas, por ejemplo Asistente Fastex, si Holded te lo pide.

  4. 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éAccesoNombre técnico
    Presupuestos (Ventas)Lectura y escriturasales:estimates.read
    sales:estimates.write
    ContactosLectura y escrituracontacts:contacts.read
    contacts:contacts.write
    Productos (Inventario)Solo lecturainventory:products.read
    Servicios (Ventas)Solo lecturasales:services.read

    No hace falta dar acceso a facturas, contabilidad ni a ningún otro módulo.

  5. 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.
En el Asistente

Dónde pegar la clave

  1. Escribe /web al Asistente en Telegram

    Te 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.

  2. Abre «Holded» en el panel

    Es la página de la clave de Holded de tu empresa.

  3. 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.
Seguridad

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.
Si algo falla

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.