# Citas

Reserva de citas de clientes con especialistas directamente en la app: el cliente elige una sucursal, un servicio, un especialista y una hora, deja su nombre y teléfono, y la cita aparece en la agenda. Los elementos toman de la sucursal los servicios, los especialistas, el horario y las reglas de reserva. Cómo configurar una sucursal y construir el camino de reserva con los bloques «Reservar una cita», «Cancelar cita» y «Cambiar cita» se explica en la página [Reservas a través de una mini app](https://support.jetbot24.ru/es/booking/mini-app).

Cómo añadir elementos y qué tienen en común se explica en la página [Elementos de pantalla](https://support.jetbot24.ru/es/mini-apps/elements).

| Elemento | Qué muestra al cliente | Salida |
|---|---|---|
| [«Sucursales de reservas»](https://support.jetbot24.ru/es/mini-apps/elements/booking#sucursales-de-reservas) | Una lista de sucursales | «Sucursal N» |
| [«Servicios de reservas»](https://support.jetbot24.ru/es/mini-apps/elements/booking#servicios-de-reservas) | Los servicios de la sucursal con precio y duración | «Servicio N» |
| [«Especialistas de reservas»](https://support.jetbot24.ru/es/mini-apps/elements/booking#especialistas-de-reservas) | Los especialistas del servicio elegido o todos los especialistas de la sucursal | «Especialista N» |
| [«Horarios disponibles»](https://support.jetbot24.ru/es/mini-apps/elements/booking#horarios-disponibles) | Las horas libres por día | «Hora N» |
| [«Confirmar reserva»](https://support.jetbot24.ru/es/mini-apps/elements/booking#confirmar-reserva) | Un resumen de la reserva y los campos del cliente | El texto del botón, «Reservar» por defecto |
| [«Mis citas»](https://support.jetbot24.ru/es/mini-apps/elements/booking#mis-citas) | Las citas del cliente | «Cita N» |
| [«Tarjeta de la cita»](https://support.jetbot24.ru/es/mini-apps/elements/booking#tarjeta-de-la-cita) | Una cita con botones | «Cancelar cita», «Cambiar cita», «Valorar visita» |
| [«Valoración de la visita»](https://support.jetbot24.ru/es/mini-apps/elements/booking#valoración-de-la-visita) | Estrellas y un comentario después de la visita | «Tras la valoración» |

## Sucursal

La mayoría de los elementos empiezan por la opción **«Sucursal»**:

- **una sucursal concreta**: el elemento trabaja con ella. Puedes definir la sucursal en todas las pantallas de la versión a la vez en la ventana «Tienda y sucursal»;
- **«El cliente elige la sucursal»**: el elemento toma la sucursal que el cliente eligió en la pantalla con «Sucursales de reservas». Normalmente es `{{ branchId }}`. Si la app tiene una pantalla de selección de sucursal, bajo el campo aparece una indicación con el botón «Usar la sucursal que eligió el cliente».

Para «Mis citas», «Tarjeta de la cita» y «Valoración de la visita», la sucursal es opcional: con «Todas las sucursales» muestran las citas del cliente en todas las sucursales del proyecto.

En el editor, los elementos muestran los servicios y especialistas reales de la sucursal elegida; si la sucursal la elige el cliente, los de la primera sucursal adecuada. Las citas del cliente en el editor son un ejemplo.

Los elementos se pasan la elección entre sí mediante variables: `branchId`, `serviceId`, `staffId`, `slot`, `appointmentId`. En la configuración de cada elemento ya están puestas las adecuadas: solo tienes que cambiarlas si construyes tu propio flujo.

## Sucursales de reservas

Una lista de sucursales entre las que el cliente elige la suya. Hace falta cuando hay varias sucursales.

![El elemento «Sucursales de reservas»: dos salones con direcciones y teléfonos, y la configuración del elemento](https://support.jetbot24.ru/_media/es/02-mini-apps/15-elements/_images/booking-branches.webp?v=1792562451)

- **«Sucursales que mostrar»**: si está vacío, todas las sucursales del proyecto que tienen servicios y especialistas.
- **«Mostrar icono de la sucursal»**: el icono se sube en la sección «Reservas», en el selector de sucursales. Sin él, se muestra un icono de chincheta.
- **«Mostrar dirección»**, **«Mostrar teléfono»**.
- **«Sucursal elegida en una variable»**: `branchId` por defecto. A través de ella, los servicios, los especialistas, la hora y el bloque «Reservar una cita» trabajan con la sucursal elegida: define en ellos «El cliente elige la sucursal».
- **«Texto cuando no hay nada que mostrar»**: si está vacío, «Aún no hay sucursales».

## Servicios de reservas

Los servicios de la sucursal disponibles para reservar. Si el cliente eligió primero un especialista, el elemento puede mostrar solo los servicios de ese especialista.

![El elemento «Servicios de reservas»: servicios con precio y duración, y la configuración del elemento](https://support.jetbot24.ru/_media/es/02-mini-apps/15-elements/_images/booking-services.webp?v=1792562451)

- **«Categoría»**: los servicios de una categoría o «Todas las categorías». Cuando el cliente elige la sucursal, no hay filtrado por categoría: cada sucursal tiene sus propias categorías.
- **«Especialista»**: vacío significa todos los servicios de la sucursal. Si el especialista se elige antes que el servicio, pon aquí `{{ staffId }}`: solo quedan los servicios de ese especialista, con su precio y duración. La fila «Cualquier especialista» no filtra. Más información: [Primero el especialista, luego el servicio](https://support.jetbot24.ru/es/booking/mini-app#primero-el-especialista-luego-el-servicio).
- **«Vista»**: «Lista» o «Tarjetas».
- **«Agrupar por categoría»**, **«Mostrar fotos»**, **«Mostrar precios»**, **«Mostrar duración»**.
- **«Servicio elegido en una variable»**: `serviceId` por defecto. A través de ella, la pantalla de especialistas y la elección de hora muestran lo que corresponde.
- **«Texto cuando no hay nada que mostrar»**: si está vacío, «Aún no hay servicios».

## Especialistas de reservas

Los especialistas que prestan el servicio elegido. Sin servicio, todos los especialistas de la sucursal que atienden a clientes.

![El elemento «Especialistas de reservas»: la fila «Cualquier especialista» y los especialistas, y la configuración del elemento](https://support.jetbot24.ru/_media/es/02-mini-apps/15-elements/_images/booking-staff.webp?v=1792562451)

- **«Servicio»**: normalmente, `{{ serviceId }}`, definido por el elemento «Servicios de reservas». Vacío significa todos los especialistas de la sucursal, sin precio ni duración: dependen del servicio.
- **«Fila «Cualquier especialista»»** y «Texto de la fila». La cita va a un especialista libre con menos citas ese día.
- **«Mostrar fotos»**, **«Mostrar valoración»**.
- **«Especialista elegido en una variable»**: `staffId` por defecto. A través de ella, la elección de hora muestra las horas libres de ese especialista.
- **«Texto cuando no hay nada que mostrar»**: si está vacío, «Ahora mismo nadie presta este servicio».

## Horarios disponibles

Las horas libres por día: una franja de días y las horas del día elegido.

![El elemento «Horarios disponibles»: una franja de días y horas libres, y la configuración del elemento](https://support.jetbot24.ru/_media/es/02-mini-apps/15-elements/_images/booking-slots.webp?v=1792562451)

- **«Servicio»** y **«Especialista»**: normalmente, `{{ serviceId }}` y `{{ staffId }}`. Vacío o `any` en el especialista significa cualquier especialista libre.
- **«Cambio de cita»**: para una pantalla de cambio de cita: `{{ appointmentId }}`. La hora se ajusta a los servicios y al especialista de esa cita.
- **«Días que mostrar»**: hasta 31, pero no más allá de lo que permite reservar la configuración de la sucursal.
- **«Hora elegida en una variable»**: `slot` por defecto. La necesitan la confirmación de reserva y el bloque «Cambiar cita».
- **«Texto cuando no hay nada que mostrar»**: si está vacío, «No hay horas libres».

## Confirmar reserva

Un resumen de la reserva (servicio, especialista, fecha, duración y precio) y campos para el nombre, el teléfono, el email y el comentario.

![El elemento «Confirmar reserva»: el resumen de la reserva, los campos del cliente y el botón «Reservar», y la configuración del elemento](https://support.jetbot24.ru/_media/es/02-mini-apps/15-elements/_images/booking-checkout.webp?v=1792562451)

- **«Servicio»**, **«Especialista»**, **«Hora»**: normalmente, `{{ serviceId }}`, `{{ staffId }}` y `{{ slot }}`.
- Qué campos pedir (teléfono, email, comentario) lo deciden las [reglas de la sucursal](https://support.jetbot24.ru/es/booking/rules).
- **«Mostrar resumen de la reserva»**.
- **«Texto del botón»** («Reservar» por defecto) y «Color». Conecta el botón al bloque «Reservar una cita».

## Mis citas

Las citas del cliente: las próximas y, si se quiere, las pasadas y canceladas.

![El elemento «Mis citas»: citas de ejemplo y la configuración del elemento](https://support.jetbot24.ru/_media/es/02-mini-apps/15-elements/_images/booking-appointments.webp?v=1792562451)

- **«Citas que mostrar»**: hasta 50.
- **«Mostrar pasadas y canceladas»**.
- **«Cita elegida en una variable»**: `appointmentId` por defecto. A través de ella, la «Tarjeta de la cita» muestra los detalles.
- **«Texto cuando no hay nada que mostrar»**: si está vacío, «Aún no hay citas».

## Tarjeta de la cita

Una cita: número, estado, servicios, especialista, fecha y precio, y botones de acción.

![El elemento «Tarjeta de la cita»: una cita con botones y la configuración del elemento](https://support.jetbot24.ru/_media/es/02-mini-apps/15-elements/_images/booking-appointment.webp?v=1792562451)

- **«Cita»**: normalmente, `{{ appointmentId }}`, de «Mis citas» o de un enlace enviado por el bot.
- **«Botón de cancelar»** y «Texto del botón de cancelar»: antes de cancelar, la app pide al cliente que lo confirme.
- **«Botón de cambiar»** y «Texto del botón de cambiar».
- **«Botón «Valorar la visita» después de la cita»** y «Texto del botón de valoración».
- **«Botón «Añadir al calendario»»** y «Texto del botón del calendario»: solo para una cita próxima. Un iPhone añade el evento desde un archivo; Android abre Google Calendar.
- **«Texto cuando no hay nada que mostrar»**: si está vacío, «Cita no encontrada».

Cada botón tiene su propia salida: lleva la cancelación al bloque «Cancelar cita», el cambio a la pantalla de selección de hora y la valoración a una pantalla con el elemento «Valoración de la visita». El cliente puede cancelar o cambiar una cita como máximo hasta el plazo que fijan las reglas de la sucursal.

## Valoración de la visita

Estrellas del 1 al 5 y un campo de comentario después de la visita. La valoración se guarda al instante: no hace falta un bloque aparte. Se puede cambiar durante la primera semana.

![El elemento «Valoración de la visita»: estrellas, un comentario y el botón «Enviar valoración», y la configuración del elemento](https://support.jetbot24.ru/_media/es/02-mini-apps/15-elements/_images/booking-review.webp?v=1792562451)

- **«Cita»**: normalmente, `{{ appointmentId }}`.
- **«Título»** («¿Qué tal fue tu visita?» por defecto) y **«Color de las estrellas»**.
- **«Campo de comentario»** y «Texto de ejemplo del comentario».
- **«Texto del botón»** («Enviar valoración» por defecto) y «Color del botón».
- **«Texto de agradecimiento»**: si está vacío, «¡Gracias por tu valoración!».
- **«Invitar a los clientes satisfechos a dejar una reseña»** y «Texto del enlace a reseñas»: quienes dieron 4 o 5 ven un enlace a las reseñas de la sucursal. El enlace se define en la [configuración de notificaciones](https://support.jetbot24.ru/es/booking/notifications) de las reservas.

Antes de la visita, el elemento muestra «Puedes valorar la visita después de la cita.». La conexión «Tras la valoración» lleva más allá, por ejemplo, a una pantalla de agradecimiento.

## Para especialistas

Los elementos del grupo «Para especialistas» son pantallas para especialistas en la misma app: un especialista inicia sesión con el código de su ficha de especialista y ve sus citas y su horario. No necesita una cuenta. Cómo dar un código y qué puede hacer un especialista se explica en la página [Acceso de los especialistas](https://support.jetbot24.ru/es/booking/masters#especialista-en-la-mini-app).

«Citas del especialista», «Tarjeta de cita del especialista» y «Horario del especialista» tienen la opción **«Sucursal»**: si está vacía, todas las sucursales en las que la persona figura como especialista. Un cliente que llegue a una pantalla de especialista no verá ninguna cita, solo el **«Texto para quienes no son especialistas»** (si está vacío, «Esta sección es para especialistas. Inicia sesión con el código de tu administrador.»).

### Acceso del especialista

Un campo para el código y un botón para iniciar sesión. Quien ya inició sesión ve, en lugar del campo, un botón que lleva a sus citas.

![El elemento «Acceso del especialista»: el campo del código y el botón «Iniciar sesión», y la configuración del elemento](https://support.jetbot24.ru/_media/es/02-mini-apps/15-elements/_images/master-login.webp?v=1792562451)

- **«Título»** («Acceso del especialista» por defecto) y **«Explicación»**.
- **«Texto del botón»** («Iniciar sesión» por defecto) y «Color».
- **«Botón para un especialista con sesión iniciada»**: «Mis citas» por defecto.
- **«Continuar al instante si el especialista ya inició sesión»**: un especialista con sesión iniciada no ve esta pantalla: la app abre al instante aquello a lo que lleva la conexión del elemento. La conexión debe estar trazada.

La salida «Tras el acceso del especialista» lleva a la pantalla del especialista.

### Citas del especialista

Una franja de días con el número de citas y las citas del día elegido.

![El elemento «Citas del especialista»: una franja de días y las citas del día, y la configuración del elemento](https://support.jetbot24.ru/_media/es/02-mini-apps/15-elements/_images/master-appointments.webp?v=1792562451)

- **«Días en la franja»**.
- **«Cita elegida en una variable»**: `masterAppointmentId` por defecto. A través de ella, la «Tarjeta de cita del especialista» muestra la cita.

La salida «Cita del especialista N» se activa al tocar una cita.

### Tarjeta de cita del especialista

Servicios, hora, el nombre y el comentario del cliente, botones de marca y la nota del especialista.

![El elemento «Tarjeta de cita del especialista»: la cita de un cliente, botones de marca y una nota, y la configuración del elemento](https://support.jetbot24.ru/_media/es/02-mini-apps/15-elements/_images/master-appointment.webp?v=1792562451)

- **«Cita»**: normalmente, `{{ masterAppointmentId }}`, definido por el elemento «Citas del especialista» y por el enlace del mensaje del bot.
- **«Botones «El cliente acudió» y «No acudió»»**: disponibles cuando llega la hora de la visita. El especialista no puede cancelar ni cambiar una cita.
- **«Nota del especialista»**: un campo de nota para la cita.

### Horario del especialista

El horario de trabajo y los descansos del especialista para los próximos días.

![El elemento «Horario del especialista»: horas de trabajo por día y la configuración del elemento](https://support.jetbot24.ru/_media/es/02-mini-apps/15-elements/_images/master-schedule.webp?v=1792562451)

- **«Días en el horario»**.
- **«Texto cuando no hay nada que mostrar»**: si está vacío, «No hay horario definido».
