Centro de ayudaIntegraciones y avanzadoConectar Buky con herramientas externas (API Tokens)

Conectar Buky con herramientas externas (API Tokens)

Genera un token de solo lectura para conectar Buky con herramientas externas como 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 consultar los datos de tu cuenta (reservas, clientes, productos...) de forma segura y sin necesidad de compartir tu contraseña.

Los tokens son de solo lectura: permiten consultar información, pero no modificarla.

Esta función está en fase beta y se activa progresivamente. Si no ves la opción en tu panel, contacta con soporte para solicitar el acceso.

Antes de empezar

  • Necesitas tener acceso a la sección Configuración de tu cuenta de Buky.
  • La función API Tokens debe estar activada en tu cuenta (aparece como pestaña con 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).

Sección API Tokens en la configuración de Buky
Sección API Tokens en la configuración de Buky

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. Haz clic en «Crear token»

Pulsa el botón Crear token. Aparecerá un banner verde con el token generado.

Banner con el token recién creado
Banner con el token recién creado

4. 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:

Lista de tokens activos
Lista de tokens activos
ColumnaDescripción
NombreEl nombre que le diste al crearlo
CreadoFecha en la que se generó el token
Último usoCuá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.

Botón de revocar en la fila del token
Botón de revocar en la fila del token

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.

Token revocado en la lista
Token revocado en la lista

Revocar un token es irreversible. Si necesitas reconectar una herramienta, tendrás que crear un token nuevo.

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é datos puede consultar un token?

Un token tiene acceso de solo lectura a los datos de tu cuenta: reservas, clientes, productos, pagos, etc. No puede crear, modificar ni eliminar nada.

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

Esta función está en fase beta y se activa progresivamente. Contacta con soporte de Buky para solicitar el acceso.

¿Te ha resultado útil este artículo?