> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cimaos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agenda Online

> Habilita y personaliza la página pública de reserva de citas para que tus pacientes agenden por internet.

<Note>
  La Agenda Online es una página pública donde tus pacientes pueden ver la disponibilidad de tu clínica y reservar citas sin necesidad de llamar. Tú controlas qué profesionales y tipos de sesión están disponibles, personalizas la apariencia y defines las reglas de cancelación.
</Note>

## Funcionalidades

* **Habilitar o deshabilitar** la reserva online con un interruptor
* **Personalizar la URL** de tu página de reservas
* **Configurar colores y mensajes** para tu marca
* **Definir reglas de cancelación** online
* **Seleccionar profesionales** disponibles para reserva online
* **Asignar tipos de sesión** a cada profesional

***

## Permisos por Rol

| Funcionalidad                           | Administradores | Profesionales | Asistentes |
| --------------------------------------- | :-------------: | :-----------: | :--------: |
| Habilitar/deshabilitar agenda online    |        Sí       |       No      |     No     |
| Configurar URL y personalización        |        Sí       |       No      |     No     |
| Asignar profesionales y tipos de sesión |        Sí       |       No      |     No     |

***

## Habilitar la Agenda Online

<Steps>
  <Step title="Abre la configuración">
    Ve a **Configuración** → **Agenda Online**
  </Step>

  <Step title="Activa el interruptor">
    Activa el interruptor principal para habilitar la reserva online
  </Step>

  <Step title="Configura la URL">
    Define el nombre de tu URL personalizada (ej: "mi-clinica")
  </Step>

  <Step title="Personaliza">
    Configura colores, mensajes de bienvenida e instrucciones
  </Step>

  <Step title="Asigna profesionales">
    Selecciona qué profesionales estarán disponibles y qué tipos de sesión ofrecen
  </Step>
</Steps>

<Warning>
  Todas las opciones de configuración están deshabilitadas hasta que actives el interruptor principal.
</Warning>

***

## URL personalizada

Tu página de reservas tendrá una URL del tipo:

```
https://[tu-nombre].reserva.cimaos.com
```

**Ejemplo:** Si tu clínica se llama "Dental Sur", puedes configurar `dental-sur` como nombre → `https://dental-sur.reserva.cimaos.com`

**Restricciones del nombre:**

* Solo letras, números y guiones
* Máximo 50 caracteres
* Sin espacios ni caracteres especiales

***

## Personalización

| Campo                        | Descripción                                                               | Límite                |
| ---------------------------- | ------------------------------------------------------------------------- | --------------------- |
| **Color del tema**           | Color principal de la página de reservas (selector de color + código hex) | Código hex válido     |
| **Mensaje de bienvenida**    | Texto que ven los pacientes al entrar a la página                         | 200 caracteres        |
| **Plazo de cancelación**     | Tiempo mínimo antes de la cita para cancelar online                       | Opciones predefinidas |
| **Mensaje post-reserva**     | Texto que ve el paciente después de confirmar su cita                     | 500 caracteres        |
| **Instrucciones de llegada** | Indicaciones de cómo llegar, estacionamiento, piso, etc.                  | 500 caracteres        |

### Plazos de cancelación disponibles

| Opción   | Significado                                     |
| -------- | ----------------------------------------------- |
| 0 horas  | No se permite cancelación online (deben llamar) |
| 2 horas  | Pueden cancelar hasta 2 horas antes             |
| 6 horas  | Pueden cancelar hasta 6 horas antes             |
| 12 horas | Pueden cancelar hasta 12 horas antes            |
| 24 horas | Pueden cancelar hasta 24 horas antes            |
| 48 horas | Pueden cancelar hasta 48 horas antes            |

***

## Profesionales elegibles

Solo los miembros con rol de **Administrador** o **Profesional Odontología** pueden habilitarse para la agenda online.

Para cada profesional puedes:

1. **Habilitar o deshabilitar** su disponibilidad para reservas online
2. **Asignar tipos de sesión** que ofrece (ej: Consulta General, Limpieza, Endodoncia)

<Warning>
  Cada profesional habilitado debe tener al menos un tipo de sesión asignado. Sin tipos de sesión, el profesional no aparecerá en la página de reservas.
</Warning>

<Info>
  Los tipos de sesión se configuran en **Configuración** → **Calendario** → **Tipos de Sesión**. Si no tienes tipos de sesión creados, deberás crearlos primero.
</Info>

***

## Cómo funciona para el paciente

Una vez habilitada, la experiencia del paciente es:

1. Accede a la URL de tu clínica
2. Ve la información de tu clínica y los servicios disponibles
3. Selecciona el profesional y tipo de tratamiento
4. Elige fecha y hora de un slot disponible (basado en la disponibilidad real del calendario)
5. Ingresa sus datos personales
6. Confirma la cita

La cita aparece automáticamente en tu calendario de CIMAOS.

***

## Avisos de nuevas reservas

Cada vez que un paciente reserva una cita desde la agenda online, tu equipo puede recibir un aviso para enterarse sin revisar el calendario. La configuración de **quién recibe qué avisos y por qué canal** (correo o celular) se trasladó a su propio apartado.

<Info>
  Configura los destinatarios de los avisos en **Configuración** → **Agenda** → **[Notificaciones](/configuracion/notificaciones)**, en la pestaña **Al equipo**.
</Info>

***

## Preguntas Frecuentes

<AccordionGroup>
  <Accordion title="¿Los slots disponibles se actualizan en tiempo real?" icon="rotate">
    Sí. La agenda online muestra la disponibilidad real del profesional según su calendario, horarios de trabajo y ausencias registradas.
  </Accordion>

  <Accordion title="¿Puedo deshabilitar temporalmente sin perder la configuración?" icon="power-off">
    Sí. Al desactivar el interruptor principal, la página deja de estar accesible pero toda la configuración se mantiene. Al reactivarla, todo vuelve como estaba.
  </Accordion>

  <Accordion title="¿Qué pasa si un paciente reserva y ya no hay disponibilidad?" icon="calendar-xmark">
    El sistema verifica la disponibilidad en tiempo real al momento de confirmar. Si otro paciente reservó el mismo slot segundos antes, se le notifica y debe elegir otro horario.
  </Accordion>

  <Accordion title="¿Puedo personalizar los colores para que coincidan con mi marca?" icon="palette">
    Sí. El selector de color te permite elegir cualquier color usando el picker visual o ingresando el código hexadecimal exacto de tu marca.
  </Accordion>

  <Accordion title="¿Los asistentes pueden aparecer en la agenda online?" icon="user">
    No. Solo los administradores y profesionales de odontología son elegibles para la agenda online, ya que son quienes realizan las atenciones.
  </Accordion>

  <Accordion title="¿Dónde configuro quién recibe los avisos de nuevas reservas?" icon="bell">
    En **Configuración** → **Agenda** → **[Notificaciones](/configuracion/notificaciones)**, pestaña **Al equipo**. Ahí eliges por persona qué avisos recibe y por qué canal (correo o celular).
  </Accordion>
</AccordionGroup>

***

## Ver también

* [Notificaciones](/configuracion/notificaciones) - Elegir quién del equipo recibe los avisos de la agenda
* [Tipos de Sesión](/configuracion/calendario/tipos-sesion) - Crear tipos de sesión para asignar a profesionales
* [Horarios de Trabajo](/configuracion/organizacion/horarios) - Configurar disponibilidad de profesionales
* [Gestionar Citas](/calendar/gestionar-citas) - Cómo aparecen las citas agendadas online en tu calendario

<Check>
  **Siguiente paso:** Asegúrate de tener [Tipos de Sesión](/configuracion/calendario/tipos-sesion) configurados para que tus profesionales puedan ofrecer servicios en la agenda online.
</Check>