🔌 Tokens de API
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,workeroviewer). Usa el mínimo necesario. - Caducidad: cuánto tiempo estará activo el token (1 semana, 1 mes, 3 meses, 1 año, o sin caducidad).
- 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 revocar 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). |
worker | Equivalente a un Trabajador: gestiona pedidos, clientes, catálogo. |
viewer | Solo lectura. Ú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 "API".
¿Quién puede gestionar tokens de API?
Solo Admins y Propietarios pueden crear, ver y revocar tokens. Los Trabajadores y Solo lectura no tienen acceso a esta sección.