# Agendario

> Agendario es una plataforma de reservaciones en línea para negocios de servicios en México. Los clientes de cada negocio pueden agendar citas las 24 horas, recibir confirmaciones y recordatorios por WhatsApp, y gestionar todo desde agendario.mx. Cada negocio tiene una página pública en agendario.mx/{slug}.

## Cómo funciona para el cliente final

Cada negocio en Agendario tiene una página pública de reservaciones en `agendario.mx/{slug}` donde cualquier persona puede:

1. Ver los servicios disponibles con duración y precio
2. Seleccionar una fecha en el calendario y ver los horarios disponibles en tiempo real
3. Reservar una cita proporcionando su nombre y número de teléfono
4. Recibir confirmación y recordatorios automáticos por WhatsApp

Los clientes no necesitan crear cuenta ni descargar ninguna aplicación para agendar.

## API Pública

Agendario ofrece una API pública JSON para que asistentes de IA (Claude, ChatGPT, Gemini, etc.) puedan ayudar a los usuarios a descubrir negocios y agendar citas de forma programática. La API no requiere autenticación.

**Flujo para agendar una cita:**

1. `GET /api/v1/businesses/{slug}` — Información del negocio y lista de servicios con precios y duración
2. `GET /api/v1/businesses/{slug}/available-slots?service_id={id}&date={YYYY-MM-DD}` — Horarios disponibles en tiempo real
3. `POST /api/v1/businesses/{slug}/appointments` — Crear una cita (requiere: service_id, date, start_time, customer_name, customer_phone)

Las citas creadas quedan en estado "pendiente" y se confirman cuando el cliente responde al mensaje de WhatsApp que se envía automáticamente.

- [Documentación de la API](https://agendario.mx/api/v1/): Endpoint raíz con descripción completa de todos los endpoints, parámetros y formatos de respuesta
- [Especificación OpenAPI](https://agendario.mx/api/v1/openapi.json): Especificación OpenAPI 3.1 para integración programática

## Datos estructurados

Todas las páginas públicas de negocios incluyen JSON-LD con esquemas Schema.org:

- `LocalBusiness` con nombre, dirección, coordenadas, teléfono, email, logo y servicios
- `Service` individual por cada servicio con duración, precio y URL de reservación directa
- `BreadcrumbList` para navegación
- `ReserveAction` indicando que se aceptan reservaciones en línea

Los servicios de cada negocio incluyen URLs de reservación directa con el formato `agendario.mx/{slug}/book/{service-slug}`.

## Información general

- [Página principal](https://agendario.mx/): Funcionalidades, precios y preguntas frecuentes
- [Centro de ayuda](https://help.agendario.mx/): Guías y documentación para dueños de negocio

## Optional

- [Términos y condiciones](https://agendario.mx/terms): Términos de uso de la plataforma
- [Aviso de privacidad](https://agendario.mx/privacy): Política de privacidad y manejo de datos (LFPDPPP)
- [Eliminación de datos](https://agendario.mx/data-deletion): Solicitud de eliminación de datos personales