Barberly ya tiene una Booking API pública. Con ella, tu propia web, app, bot de WhatsApp, agente de voz o asistente de IA puede aceptar reservas para tu barbería, con los mismos servicios, equipo, disponibilidad y reglas de reserva que tus clientes ya ven en tu app de Barberly.
Qué puedes crear con una API de reservas para barberías
- WhatsApp: reservar dentro del chat que tus clientes ya usan
- Asistentes de IA: reservar según tu disponibilidad real
- Agentes de voz: reservas por teléfono, automatizadas
- Webs: tu propio flujo de reserva, con tu marca
- Chatbots: un paso de reserva en cualquier widget de chat
- Integraciones propias: cualquier otra cosa que cree una reserva
Reserva como reservan tus clientes
La Booking API es una herramienta más para tus clientes, junto a tu app, tu web, los widgets de reserva, el quiosco y la reserva con Google. No es una API de back office. No da acceso a informes, gestión del equipo ni ajustes.
Todo lo que configuraste para tu propia página de reservas se aplica igual:
- Un hueco cerrado para los clientes también está cerrado en la API. La disponibilidad muestra la vista de cliente de tu agenda, nunca la del equipo.
- Si apruebas las citas a mano, las reservas hechas con la API también llegan sin confirmar.
- Si exiges un cliente registrado, la API también lo exige.
- Horarios, antelación mínima, duración de los servicios y qué barbero hace qué se leen en directo de tus ajustes.
La API no inventa reglas propias ni puede saltarse ninguna.
Qué cubre la Booking API
- Catálogo: locales, miembros del equipo, servicios con extras
- Disponibilidad: días y horas libres, por local, barbero y servicio
- Reservas: crear, consultar, cambiar de hora y cancelar
- Cuentas de clientes: registro, inicio de sesión y restablecer contraseña
Claves API y permisos
Primero configura tus locales, equipo, servicios y horarios en Barberly. La API lee esa configuración, no la crea. Después crea una clave en el portal de Barberly en Apps → Booking API → Create key y dale solo los permisos que necesite:
| Permiso | Permite |
|---|---|
catalog:read | Locales, miembros del equipo, servicios, disponibilidad |
bookings:read | Consultar una reserva |
bookings:write | Crear, modificar y cancelar reservas |
accounts:write | Registrar, iniciar sesión y recuperar cuentas de clientes |
Envía la clave en la cabecera X-Api-Key. Puedes revocar o eliminar claves en la misma pantalla.
Prueba las demos en vivo
Dos flujos de reserva para invitados funcionan sobre una barbería de demostración pública y muestran datos reales al instante. Ambos pasan por local, barbero, servicios con extras, fecha y hora, datos del cliente y confirmación, sin iniciar sesión.
- Appointment hub: una tarjeta con cuatro campos que el cliente rellena en cualquier orden
- Guided wizard: cinco pasos con barra de progreso
El código fuente está en GitHub: ejemplos en React para leer, copiar o llevar a tu propio proyecto.
Documentación
- Referencia de la API: cada endpoint y cada campo
- Documento OpenAPI: genera un cliente en tu lenguaje
Preguntas frecuentes
¿La Booking API cuesta más?
No. La Booking API está incluida en tu suscripción a Barberly. No tiene coste adicional.
No soy desarrollador. ¿Cómo consigo una integración?
Dale a ChatGPT, Claude u otro agente de IA el enlace a la referencia de la API y describe lo que quieres. En pocos minutos tendrás una implementación funcional para empezar.
¿Puedo conectarla con n8n, Make o Zapier?
Sí. Cualquier herramienta que pueda enviar una petición HTTP con cabecera puede llamar a la API: el nodo HTTP Request en n8n, el módulo HTTP en Make o una petición personalizada en Zapier. Estas herramientas pueden crear, cambiar y cancelar reservas. No pueden reaccionar a cambios hechos dentro de Barberly, porque la API aún no tiene webhooks.
¿Un agente de voz o ChatGPT pueden reservar citas con ella?
Sí. Plataformas de voz como Vapi o Retell llaman a API externas como herramientas, y un GPT personalizado en ChatGPT puede importar el documento OpenAPI y enviar tu clave en la cabecera. La API actual basta para ambos.
¿Los clientes reciben las confirmaciones habituales?
Sí. Las reservas hechas con la API envían las mismas notificaciones que configuraste para tu app y tu web.
¿Y los depósitos y prepagos?
La Booking API no cobra pagos. Si necesitas un depósito o un prepago, cóbralo primero en tu propio flujo y después crea la reserva con la API.
¿Puedo ver qué reservas llegaron por la API?
Sí. En el historial de la cita, una reserva hecha con la API aparece como creada a través de la Booking API, igual que otras muestran la app o la web.
¿Los clientes que reservan por la API se suman a mi base de clientes?
Sí. Se añaden a tus clientes como cualquier otro y ganan puntos de fidelidad cuando la reserva se marca como completada.
¿Hay un modo de prueba?
No. Mientras desarrollas, cancela las reservas de prueba que crees.
¿Mi sistema sabrá si una reserva cambia en Barberly?
No automáticamente: aún no hay webhooks. Para comprobar una reserva, vuelve a consultarla por su ID.
Tengo varios locales. ¿Necesito una clave para cada uno?
No. Una sola clave funciona para todos tus locales. Igual que en tu app y tu web, el cliente elige el local al reservar.
¿La Booking API gestiona clientes sin cita o la lista de espera?
No. Es para reservas: crear, consultar, cambiar y cancelar citas. La cola de clientes sin cita y la lista de espera funcionan con el quiosco y la app Barberly Business.
