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.
Dirección de la API
Sección titulada «Dirección de la API»| 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.
Qué está disponible hoy
Sección titulada «Qué está disponible hoy»- 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.
Primeros pasos
Sección titulada «Primeros pasos»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:
read -rs "BOOKLINE_API_KEY?API key: " # zsh; en bash: read -rsp "API key: " BOOKLINE_API_KEYexport BOOKLINE_API_KEYBASE=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:
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.
Relacionado
Sección titulada «Relacionado»- Claves y permisos: crear y revocar claves, permisos y qué lee cada clave.
- Endpoints: todas las rutas, y los parámetros y reglas de los datos de las métricas.
- Escribir datos: versiones, reintentos y el límite de escritura.
- Errores y límites de uso: códigos de error, límites y cabeceras.
- Conectar Claude o ChatGPT: usa tus datos desde una app de IA.
