🔌 Tokens de API
En 30 segundos
- Un token deja que Make, Zapier o tus propios scripts lean o escriban en el taller sin que haya una persona delante.
- Está incluido en los planes Max y Business, y lo crean Admins y Propietarios.
- La clave solo se ve una vez, al crearla: cópiala en ese momento.
- Dale al token el rol mínimo que necesite, y desactívalo cuando ya no lo uses.
Los tokens de API permiten conectar BolloPrint con herramientas externas como Make (Integromat), Zapier, scripts propios o cualquier sistema que necesite leer o escribir datos en el taller sin que haya una persona delante.
Están disponibles en Configuración → Extensiones → Tokens API para Admins y Propietarios.
La API está incluida en los planes Max y Business. Si tu plan no la incluye, la sección aparece bloqueada y las llamadas con token se rechazan aunque el token exista.
¿Qué puede hacer una integración con un token de API?
Dependiendo del rol que asignes al token, una integración puede:
- Crear pedidos automáticamente cuando llega una venta de otra plataforma.
- Leer el estado de los pedidos para actualizar un sistema externo de seguimiento.
- Añadir clientes en masa desde una importación.
- Consultar el inventario para alertas de stock.
El token actúa en nombre de un usuario "sistema" del taller, no de una persona concreta.
Crear un token de API
- Ve a Configuración → Extensiones → Tokens API.
- Pulsa "Crear token".
- Rellena el formulario:
- Nombre: algo descriptivo para saber para qué sirve (p.ej. "Make — pedidos web").
- Rol: el nivel de acceso del token (Admin, Trabajador o Solo lectura). Usa el mínimo necesario.
- Caducidad: cuánto tiempo estará activo el token (1 semana, 1 mes, 3 meses, 1 año, o No caduca).
- Pulsa Crear token.
🔐 El token se muestra solo una vez
Inmediatamente después de crear el token, el sistema muestra la clave completa. Cópiala en ese momento — no se puede ver de nuevo. Si la pierdes, tendrás que crear un token nuevo y desactivar el anterior.
El token empieza por bp_tat_
Todos los tokens de taller empiezan con el prefijo bp_tat_ (BolloPrint Tenant API Token). Es fácil de identificar si tienes varios tokens en un gestor de contraseñas.
Roles del token
| Rol | Qué puede hacer |
|---|---|
| Admin | Acceso completo (lectura y escritura en todos los módulos). |
| Trabajador | Lo mismo que una persona con rol Trabajador: gestiona pedidos, clientes, catálogo. |
| Solo lectura | Solo consulta, no modifica nada. Útil para integraciones que solo necesitan consultar datos. |
Desactivar un token
Si un token ya no lo necesitas pero quieres conservar el historial de lo que hizo, usa Desactivar. El token deja de funcionar pero permanece en la lista.
Si quieres eliminarlo completamente de la lista, usa Eliminar (solo disponible en tokens ya desactivados o caducados).
Auditoría de uso
Cada vez que una integración llama a la API usando un token, BolloPrint registra la acción en el historial del pedido o presupuesto que modifica. En lugar del nombre de una persona, como autor verás el nombre del token.
¿Quién puede gestionar tokens de API?
Solo Admins y Propietarios pueden crear, ver y desactivar tokens. Los Trabajadores y Solo lectura no tienen acceso a esta sección.