Ir al contenido

API de Bookline

Lee y gestiona los datos de tu cuenta de Bookline desde tus propios sistemas con la API de Bookline.

La API de Bookline te permite leer y gestionar los datos de tu cuenta de Bookline desde tus propios sistemas: tu CRM, tus herramientas de BI, tus automatizaciones o un agente de IA. Es la misma información que ves en el portal (locales, agentes, actividad, métricas…), con las mismas cifras que el dashboard.

Es una API HTTPS + JSON. Lo que puede hacer cada clave, leer o también escribir y en qué ámbitos, lo deciden los permisos que eliges al crearla.

URL base Referencia interactiva
https://api.bookline.ai/v1 api.bookline.ai/v1/docs

La referencia interactiva lista todos los endpoints con la descripción de cada campo. El esquema OpenAPI está en https://api.bookline.ai/v1/openapi.json, por si quieres generar un cliente.

  • Métricas: las cifras principales, el embudo de conversión, el desglose de llamadas, las reservas y las valoraciones de encuestas.
  • Locales: tus locales y su detalle; cambia su nombre, su web y sus datos de contacto.
  • Llamadas: las llamadas que atienden tus agentes, con su transcripción.
  • Chats: las conversaciones de WhatsApp de tus agentes, con sus mensajes.
  • Reservas: tus reservas por fecha de la reserva.
  • Contactos: las personas que han contactado contigo; añádelas y cámbialas.
  • Agentes: tus agentes, con su tipo, idioma y local; cámbiales el nombre.
  • Bases de conocimiento: de qué responden tus agentes; crea, cambia y elimina las de texto.
  • Campañas: tus campañas de notificaciones y sus ejecuciones; páusalas.
  • Números de teléfono e integraciones: las líneas que atienden tus agentes y los sistemas que conectaste.
  • Equipo: quién tiene acceso a tu portal; cambia o quita su acceso.
  • Facturación: tus cuentas de facturación, facturas y servicios contratados.

Todas las rutas, con el permiso que necesita cada una, están en Endpoints; cada ámbito tiene su propia página en esta sección. Los cambios siguen las reglas de Escribir datos.

1. Crea una clave. En el portal, en el menú Administración, entra en Claves de API, pulsa Crear clave y cópiala: solo se muestra una vez. Los pasos y los permisos están en Claves y permisos.

2. Lista los locales que lee tu clave. Guarda la clave en una variable de entorno para que nunca quede en el historial de tu terminal ni en tus scripts. Al escribirla no se muestra:

Ventana de terminal
read -rs "BOOKLINE_API_KEY?API key: " # zsh; en bash: read -rsp "API key: " BOOKLINE_API_KEY
export BOOKLINE_API_KEY
BASE=https://api.bookline.ai/v1
curl -s -H "apikey: $BOOKLINE_API_KEY" "$BASE/venues"

3. Pide tus primeras métricas. El resumen de octubre, día a día, en hora de Madrid:

Ventana de terminal
curl -s -H "apikey: $BOOKLINE_API_KEY" \
"$BASE/metrics/summary?from=2026-10-01&to=2026-10-31&granularity=day&timezone=Europe/Madrid"

Si tu clave lee varios clientes, añade &customer_id=<uuid del cliente> a cada llamada. Cuando termines, ejecuta unset BOOKLINE_API_KEY.