La API de reservas de tu salón: tus citas en Zapier, Make o tu propia web
Tu gestoría quiere los cobros del mes en una hoja de cálculo. Tu herramienta de correo quiere las clientas nuevas. Tu web quiere reservar directamente en tu agenda. Creas una clave en Ajustes, en API y webhooks, se la das a la herramienta y eliges qué puede ver. Para Zapier o Make no hace falta programar, y no se paga nada aparte.
0 € al mes · 0 % de comisión · sin tarjeta para registrarte · sin límite de citas ni de clientes · lo que la IA crea para ti se paga con créditos
Crea tu cuenta gratisLo que conectan los salones
Cuatro usos habituales, ninguno exige un desarrollador salvo el último.
Zapier
El disparador de webhooks de Zapier recoge cada reserva nueva y la manda a Google Sheets, a tu lista de correo o a un canal de tu equipo.
Make
Un escenario con webhook propio, o el módulo HTTP leyendo citas y clientas cada cierto tiempo.
Tu gestoría
Slotora no emite facturas, pero el evento de cobro registrado puede llevar cada pago a la herramienta donde sí facturas.
Tu propia web
Horas libres desde la API y una reserva hecha igual que la haría recepción.
Una clave por herramienta, y solo con lo que necesita
Solo la dueña o una administradora crean claves. Se muestran una vez y Slotora guarda solo su huella, así que nadie puede leerla después, tampoco nosotros. Si quitas una clave, se para esa herramienta y nada más.
| Permiso | Qué deja hacer |
|---|---|
| Leer citas | Citas con nombre de la clienta, servicio, profesional, precio y lo cobrado; también las horas libres. |
| Leer clientas | Nombre, teléfono, correo, idioma y consentimiento de marketing. Nunca las notas. |
| Leer servicios y equipo | Tu carta con precios y duraciones, tu equipo y tus centros. |
| Crear citas | Reserva una hora que el salón ofrece, como lo haría recepción. Está desmarcado hasta que lo marcas. |
Una clave deja de funcionar sola cuando quien la creó ya no administra el salón.
Las rutas
JSON sobre HTTPS en slotora.io/api/v1, con la clave en la cabecera Authorization como Bearer o en X-Api-Key. Las fechas vuelven en la hora del salón con su desfase, por ejemplo +01:00 en Madrid en invierno.
| Petición | Permiso | Qué responde |
|---|---|---|
| GET /api/v1/me | Cualquiera | Tu salón y los permisos de la clave; sirve para probar la conexión. |
| GET /api/v1/bookings | Leer citas | Citas de hoy a 31 días, o entre from y to, filtrables por estado, profesional y centro. |
| GET /api/v1/availability | Leer citas | Horas libres de un servicio en un día. |
| POST /api/v1/bookings | Crear citas | Reserva una hora libre para una clienta que ya existe o para una nueva. |
| GET /api/v1/clients | Leer clientas | Tu lista de clientas, filtrable por fecha de alta o de cambio. |
| GET /api/v1/services | Leer servicios y equipo | La carta de servicios; también hay rutas para el equipo y los centros. |
La descripción completa, legible por máquina, está en /api/v1/openapi.json.
Páginas, errores y límites
Las listas llegan por páginas: datos y un nextCursor que devuelves como cursor hasta que sea nulo, de 1 a 100 elementos por página. Cada clave puede hacer 120 peticiones por minuto; por encima, la respuesta es un 429 con Retry-After.
Una reserva por la API pasa por el mismo código que una de recepción: la hora tiene que ser una que el salón ofrece, se comprueban salas y sillones y la clienta recibe tu confirmación habitual. Con una cabecera Idempotency-Key, un reintento en cinco minutos devuelve la misma cita en vez de crear otra.
Los webhooks se revisan cada cuarto de hora, así que un cambio llega en unos quince minutos. Cada envío va firmado con HMAC-SHA256 en la cabecera Slotora-Signature. Si tu herramienta no contesta, se reintenta al minuto, a los cinco, a los treinta y luego a las 2, 6, 12 y 24 horas.
Nunca salen las notas de la clienta ni las de la cita. Si ocultas a tu equipo el teléfono y el correo de las clientas, la API también los oculta, y cada clienta lleva marcado si se dio de baja del marketing.
Zapier, paso a paso
Unos diez minutos.
01
Recoge el webhook
En Zapier, crea un Zap con el disparador Webhooks by Zapier y la opción Catch Hook, y copia la dirección que te da.
02
Pégala en Slotora
Ajustes, API y webhooks: pega la dirección, marca qué eventos enviar y añádela.
03
Manda una prueba
Pulsa enviar una prueba en Slotora y probar el disparador en Zapier: aparece una cita de ejemplo con todos sus campos, sin datos de una clienta real.
04
Llévala a donde quieras
Añade la acción, una fila en Google Sheets o un contacto en tu lista de correo, y empareja los campos.
Make, paso a paso
La misma idea con otros nombres.
01
Un webhook propio
Empieza un escenario con Webhooks y la opción Custom webhook, crea uno y copia su dirección.
02
Añádelo en Slotora
Pégalo en API y webhooks, marca los eventos y guárdalo.
03
Que Make aprenda la estructura
Pide a Make que vuelva a leer la estructura de datos y manda una prueba desde Slotora.
04
O lee con calendario
Para traer citas o clientas cada cierto tiempo, usa el módulo HTTP contra la ruta de citas con tu clave y sigue el nextCursor.
Con franqueza
Dos cosas que esperarías y que no están.
- Una app de Slotora en el directorio de Zapier o Make
- Todavía no existe. Se usan los módulos genéricos de webhooks y HTTP, que no necesitan nada del directorio.
- Webhooks al instante
- Llegan en torno a un cuarto de hora después del cambio. Para algo inmediato, consulta la API.
Preguntas sobre la API
¿La API cuesta algo?
No. Claves, peticiones y webhooks vienen con Slotora sin coste. En AgendaPro las integraciones con API van en su plan Pro, que su web anuncia a 199 € al mes, y Flowww incluye la API en su plan Ultimate, de 289 € al mes por clínica.
¿Una herramienta puede reservar fuera de mi horario?
No. Una reserva por la API tiene que ser una hora que tu salón ofrece, igual que en el selector de recepción.
¿Quién puede crear una clave?
La dueña del salón o una administradora, desde el navegador.
¿Mi gestoría puede ver los cobros sin ver los teléfonos?
Sí. Dale una clave que solo lea citas, y si ocultas los datos de contacto a tu equipo, la API tampoco los entrega.
Fuentes de las cifras de otros programas
Leídas en su propia web el día indicado.
- AgendaPro España — Planes — https://agendapro.com/es-es/planes · Consultado el La API, solo en el plan Pro.
- Flowww — Precios — https://www.flowww.es/precios · Consultado el API con 100.000 llamadas al mes en Ultimate; precio por clínica sin IVA.
Crea tu primera clave
Abre API y webhooks en los ajustes, crea una clave que solo lea citas y pruébala con la ruta me. Si no te sirve, la borras y no queda nada abierto.