import { Steps } from '@astrojs/starlight/components';
import Figure from '@/components/Figure.astro';

**Para quién:** cualquier negocio que agende citas con clientes — visitas, llamadas, demostraciones — y
quiera que su agente IA las ofrezca y las confirme sin que nadie de su equipo tenga que mirar un
calendario.

## Qué ve el cliente final

Cuando el cliente pide cita durante una conversación por WhatsApp, Telegram o el chat web, el agente
consulta el mismo motor de huecos que usa tu equipo al crear una cita a mano y solo le ofrece horarios
**reales**, nunca inventados. En ningún momento la IA revela el contenido de tu agenda —no dice qué citas
hay ni con quién—, solo negocia huecos libres. Si el cliente confirma uno, la IA **agenda la cita
directamente**, sin que nadie de tu equipo tenga que intervenir.

## Pasos en el producto

<Steps>

1. **Configura el horario laboral y los parámetros de tu agenda** (duración del hueco, margen entre citas,
   antelación mínima y días máximos hacia el futuro) desde Ajustes — los define tu administrador y
   afectan a todos los huecos que se ofrecen, tanto a mano como por IA.
2. **Cada persona conecta su propio calendario, si quiere.** Desde **Ajustes → Mi calendario**, cualquiera
   elige entre tres proveedores: el calendario de la propia plataforma (sin servicio externo), **Google
   Calendar** (usa tu ocupación real y espeja tus citas) o un servidor MCP (deshabilitado hoy, la
   infraestructura todavía no está disponible).

   <Figure
     src="/captures/agenda-lista.png"
     alt="Pantalla Agenda con los filtros de empleado y estado, el selector Lista/Semana, el navegador de fechas, el botón + Nueva cita, y la tabla de citas con columnas Cita, Empleado, Fecha y hora, Estado, Origen y Acciones"
     caption="La columna Origen distingue las citas creadas a mano (Manual) de las que agendó la IA sola durante una conversación."
   />

3. **Conecta Google Calendar, si lo usas.** Elige el proveedor Google Calendar y concede el consentimiento
   — solo pide tu disponibilidad libre/ocupado y permiso para gestionar los eventos que la propia
   plataforma crea, nada más de tu calendario. Cada cita que se te asigne se crea también allí, y se
   actualiza o cancela igual si cambia en la plataforma.
4. **Un cliente pide cita en una conversación.** El agente consulta horario laboral, parámetros, tu
   disponibilidad personal y tu ocupación real en Google Calendar (si lo conectaste), y ofrece solo
   huecos genuinamente libres.
5. **El cliente confirma un hueco y la IA agenda directamente.** La cita aparece en la pantalla Agenda con
   origen **IA** y estado **Agendada**, asignada al empleado correspondiente — sin que nadie de tu equipo
   tenga que hacer nada.
6. **Para crear una cita a mano**, pulsa **"Nueva cita"**, elige empleado y fecha, selecciona uno de los
   huecos disponibles que calcula el mismo motor, añade título y tipo, y confirma.
7. **Cambia el estado de una cita** (Completada, Cancelada o No presentado) desde sus propios iconos de
   acción en la tabla, cuando corresponda.

</Steps>

## Qué configurar

- **Horario laboral y parámetros de agenda**: los define tu administrador, iguales para citas manuales y
  de IA.
- **Calendario personal**: cada empleado elige su proveedor (plataforma o Google Calendar) desde su propio
  Ajustes.
- **Disponibilidad personal**: opcional, día a día, dentro siempre del horario laboral de la agencia.

## Límites y honestidad

- Hoy solo hay integración real con **Google Calendar** — no hay sincronización con Microsoft
  Outlook/365 ni con ningún otro calendario externo.
- El proveedor "Servidor MCP" para calendario aparece en el selector pero está **deshabilitado**: la
  infraestructura necesaria todavía no está disponible.
- Con Google Calendar conectado, la cita se refleja en el calendario del empleado **asignado** a ella, no
  en el de quien la creó — si asignas una cita a alguien sin Google conectado, la cita existe con
  normalidad en la plataforma pero no aparece en ningún Google Calendar.
- No se permiten citas solapadas: el desplegable de huecos solo ofrece horarios de verdad libres.

## Ver también

- **[Agenda y citas](/guides/agenda/)** — el detalle completo de vistas, estados y cálculo de huecos.
- **[Conversaciones](/guides/conversaciones/)** — dónde ver la conversación desde la que se agendó la
  cita.
- **[Tickets y seguimiento interno](/use-cases/tickets-seguimiento/)** — cuando una cita necesita además
  un caso interno de seguimiento.