Conectar Buky con herramientas externas (API Tokens)
Miguel Gómez Pérez · Equipo Bukyapp· 5 min de lectura·Actualizado 16 sept 2026Crea tokens de solo lectura o de escritura para conectar Buky con Zapier, n8n o agentes de IA sin compartir tu contraseña.
Los API Tokens te permiten conectar Buky con herramientas de automatización como Zapier, n8n o agentes de inteligencia artificial. Con un token, estas herramientas pueden trabajar con los datos de tu cuenta (reservas, clientes, productos...) de forma segura y sin necesidad de compartir tu contraseña.
Al crear un token eliges su nivel de acceso:
- Solo lectura (opción por defecto): puede consultar los datos de tu cuenta, pero no modificarlos.
- Escritura: además puede crear y modificar reservas, pedidos, clientes y configuración, como lo haría un administrador. Aun así, hay operaciones sensibles que un token nunca puede hacer (las verás más abajo, en «Lo que un token nunca puede hacer»).
Los API Tokens forman parte del complemento API y MCP, que ya viene incluido en el plan VIP. Si tu plan no lo incluye, puedes activarlo en Configuración > Mi plan > Suscripción > Addons. Si tu cuenta no muestra el apartado de Addons, contacta con soporte y te lo activamos.
Antes de empezar
- Necesitas ser administrador de la cuenta (permiso «Administrador», ver Gestionar usuarios y permisos). Solo los administradores pueden crear, ver y revocar tokens; el resto de usuarios no ve la pestaña.
- Tu cuenta debe tener el complemento API y MCP. La pestaña API Tokens sigue apareciendo con la etiqueta BETA.
Crear un token
1. Accede a la sección API Tokens
Ve a Configuración desde el menú lateral. En el panel de la izquierda, haz clic en la pestaña API Tokens (dentro del bloque Configuración).
2. Escribe un nombre para el token
En el campo Nombre del token, escribe un nombre descriptivo que te ayude a identificar para qué se usa. Por ejemplo: "Zapier", "n8n producción" o "Agente IA".
3. Elige el nivel de acceso
Por defecto el token se crea de solo lectura. Si la herramienta necesita crear o modificar datos (por ejemplo, dar de alta reservas desde n8n), marca la casilla Permitir escritura.
Al marcarla aparece un aviso: guarda ese token con el mismo cuidado que una contraseña de administrador y, si se filtra, revócalo desde esta misma pantalla. Da escritura solo a las herramientas que de verdad la necesiten; para informes o consultas basta con solo lectura.
4. Haz clic en «Crear token»
Pulsa el botón Crear token. Aparecerá un banner verde con el token generado.
5. Copia el token inmediatamente
El token (una cadena que empieza por bk_) solo se muestra una vez, en este momento. Cópialo haciendo clic en el icono de copiar que aparece junto al código.
Una vez copiado, haz clic en Entendido para cerrar el banner.
Si cierras el banner sin copiar el token, no podrás recuperarlo. Tendrás que revocar ese token y crear uno nuevo.
Gestionar tus tokens
Debajo del formulario de creación verás la lista Tokens activos, donde aparecen todos los tokens de tu cuenta con la siguiente información:
| Columna | Descripción |
|---|---|
| Nombre | El nombre que le diste al crearlo |
| Acceso | Solo lectura o Escritura, según lo que elegiste al crearlo |
| Creado | Fecha en la que se generó el token |
| Último uso | Cuándo se usó por última vez (o "—" si nunca se ha utilizado) |
Revocar un token
Si ya no necesitas un token o sospechas que se ha filtrado, puedes revocarlo para que deje de funcionar.
1. Localiza el token en la lista
Busca el token que quieres revocar en la lista de tokens activos.
2. Haz clic en el icono de revocar
A la derecha de cada token activo verás un icono de prohibición. Haz clic en él.
3. Confirma la revocación
Aparecerá un mensaje de confirmación: *"¿Revocar este token? Las integraciones que lo usen dejarán de funcionar."* Acepta para confirmar.
El token pasará a estado Revocado y dejará de funcionar inmediatamente.
Revocar un token es irreversible. Si necesitas reconectar una herramienta, tendrás que crear un token nuevo.
Lo que un token nunca puede hacer
Aunque un token tenga permiso de escritura, hay operaciones que Buky reserva siempre a una persona que entra en el panel:
- Crear, modificar o eliminar usuarios del panel.
- Hacer reembolsos de pagos.
- Cambiar la configuración de cobro: las credenciales de las pasarelas de pago y los métodos de pago que ofreces a tus clientes.
- Gestionar tu plan de Buky: la suscripción y la tarjeta con la que la pagas.
- Cambiar los datos fiscales de tu empresa o el dominio personalizado de tu tienda online.
- Generar o revocar el enlace de exportación de tu calendario.
- Crear, ver o revocar API Tokens: un token no puede gestionar otros tokens.
Tampoco puede leer datos sensibles como las claves de las pasarelas de pago o de Verifactu.
Consejos
- Un token por herramienta. Si conectas varias herramientas (Zapier, n8n, etc.), crea un token diferente para cada una. Así, si necesitas revocar el acceso de una, las demás seguirán funcionando.
- Guarda el token en un lugar seguro. Una vez cerrado el banner de creación, no hay forma de volver a ver el token. Guárdalo en tu gestor de contraseñas o en la configuración de la herramienta que vayas a conectar.
- Revisa los tokens periódicamente. La columna "Último uso" te ayuda a identificar tokens que ya no se utilizan. Si llevan tiempo sin uso, considera revocarlos.
Preguntas frecuentes
¿Qué puede hacer un token con los datos de mi cuenta?
Depende del nivel de acceso que elegiste al crearlo. Un token de solo lectura puede consultar reservas, clientes, productos, pagos, etc., pero no puede crear, modificar ni eliminar nada. Un token de escritura puede además crear y modificar datos, salvo las operaciones de «Lo que un token nunca puede hacer».
¿He perdido mi token, qué hago?
Si cerraste el banner sin copiarlo, el token no se puede recuperar. Revoca el token perdido y crea uno nuevo.
¿Puedo tener varios tokens activos a la vez?
Sí. Puedes crear todos los que necesites. Lo recomendable es tener uno por cada herramienta o integración.
No veo la pestaña API Tokens en mi configuración.
La pestaña solo aparece si eres administrador de la cuenta y tu plan incluye el complemento API y MCP (viene incluido en el plan VIP). Si te falta el complemento, actívalo en Configuración > Mi plan > Suscripción > Addons o pídenoslo a soporte.