AgendaPro

AgendaPro es una plataforma de gestión de citas y reservas para negocios de servicios. Esta integración permite a tu agente de IA gestionar reservas, clientes, servicios, prestadores, locales y pagos directamente desde conversaciones.

​

Credenciales requeridas

​

Herramientas disponibles

​

Buscar entidades

Herramienta de búsqueda unificada para todas las entidades de AgendaPro. Usa esta herramienta primero cuando necesites obtener un ID. Entidades soportadas:

• bookings — Reservas/citas
• clients — Clientes
• services — Servicios
• providers — Prestadores
• locations — Locales/sucursales
• payments — Pagos
• plans — Planes

Entradas:

• entity (string) — Tipo de entidad a buscar.
• id (number, opcional) — Obtener un registro específico por ID.
• query (string, opcional) — Término de búsqueda (para clientes: nombre, email, teléfono).
• filters (object, opcional) — Filtros adicionales: location_id, client_id, provider_id, service_id, status_id, start_date, end_date, active.
• page (number) — Número de página (default: 1).
• per_page (number) — Resultados por página (default: 20, max: 100).

---

​

Obtener horarios disponibles

Consulta los horarios disponibles para agendar un servicio en una fecha específica. Requiere location_id o provider_id. Entradas:

• service_id (number) — ID del servicio.
• date (string) — Fecha en formato YYYY-MM-DD.
• location_id (number, opcional) — ID del local (requerido si no se proporciona provider_id).
• provider_id (number, opcional) — ID del prestador (requerido si no se proporciona location_id).

---

​

Crear reserva

Crea una nueva reserva/cita en AgendaPro. Primero usa “Obtener horarios disponibles” para encontrar slots abiertos. Entradas:

• start (string) — Fecha y hora de inicio (ISO: YYYY-MM-DDTHH:mm:ss.000Z).
• end (string) — Fecha y hora de fin (ISO: YYYY-MM-DDTHH:mm:ss.000Z).
• service_id (number) — ID del servicio.
• provider_id (number) — ID del prestador.
• first_name (string) — Nombre del cliente (requerido).
• last_name (string, opcional) — Apellido del cliente.
• email (string, opcional) — Email del cliente.
• phone (string, opcional) — Teléfono del cliente.
• identification_number (string, opcional) — Número de identificación (cédula, RUT).
• price (number, opcional) — Precio (usa el precio del servicio si no se especifica).

---

​

Actualizar reserva

Actualiza una reserva existente. Puede reprogramar, cambiar prestador o actualizar estado. Entradas:

• booking_id (number) — ID de la reserva a actualizar.
• start (string, opcional) — Nueva fecha/hora de inicio.
• end (string, opcional) — Nueva fecha/hora de fin.
• status_id (number, opcional) — Nuevo estado.
• provider_id (number, opcional) — Nuevo prestador.

Estados disponibles:

---

​

Cancelar reserva

Cancela/elimina una reserva. Entradas:

• booking_id (number) — ID de la reserva a cancelar.

---

​

Crear o actualizar cliente

Crea un nuevo cliente o actualiza uno existente si se proporciona client_id. Entradas:

• client_id (number, opcional) — ID del cliente a actualizar (omitir para crear nuevo).
• first_name (string) — Nombre del cliente.
• last_name (string) — Apellido del cliente.
• email (string, opcional) — Email del cliente.
• phone (string, opcional) — Teléfono del cliente.
• identification (string, opcional) — Número de identificación (cédula, RUT).
• address (string, opcional) — Dirección.
• city (string, opcional) — Ciudad.
• notes (string, opcional) — Notas internas sobre el cliente.

---

​

Eliminar cliente

Elimina un cliente de AgendaPro. Entradas:

• client_id (number) — ID del cliente a eliminar.

---

​

Obtener historial de cliente

Obtiene el historial de reservas y pagos de un cliente. Entradas:

• client_id (number) — ID del cliente.
• include_bookings (boolean) — Incluir historial de reservas (default: true).
• include_payments (boolean) — Incluir historial de pagos (default: true).
• page (number) — Número de página (default: 1).

---

​

Crear pago por servicio

Registra un pago por un servicio (sin reserva asociada). Busca automáticamente cliente, local, servicio y vendedor por nombre. Entradas:

• client_name (string) — Nombre o email del cliente.
• location_name (string) — Nombre del local.
• service_name (string) — Nombre del servicio.
• seller_name (string) — Nombre del vendedor/prestador.
• amount (number) — Monto del pago.
• payment_date (string, opcional) — Fecha del pago (YYYY-MM-DD, default: hoy).
• payment_method (string) — Método: cash, credit, debit, check, other.
• receipt_type (string) — Tipo de comprobante: receipt (boleta), invoice (factura), service_receipt, other.
• receipt_number (string, opcional) — Número de comprobante.
• notes (string, opcional) — Notas del pago.

---

​

Crear pago por producto

Registra un pago por venta de producto del inventario. Entradas:

• client_name (string) — Nombre o email del cliente.
• location_name (string) — Nombre del local.
• seller_name (string) — Nombre del vendedor.
• product_id (number) — ID del producto del inventario.
• quantity (number) — Cantidad de productos (default: 1).
• amount (number) — Monto total del pago.
• price_per_unit (number) — Precio por unidad.
• payment_date (string, opcional) — Fecha del pago.
• payment_method (string) — Método de pago.
• receipt_type (string) — Tipo de comprobante.

---

​

Crear venta de giftcard

Registra una venta de giftcard/tarjeta de regalo. Entradas:

• client_name (string) — Nombre del cliente comprador.
• location_name (string) — Nombre del local.
• seller_name (string) — Nombre del vendedor.
• credit_amount (number) — Valor del crédito de la giftcard.
• amount (number) — Monto pagado (puede diferir si hay descuento).
• payment_date (string, opcional) — Fecha del pago.
• payment_method (string) — Método de pago.
• to_the_carrier (boolean) — true=transferible, false=restringida al comprador.
• comments (string, opcional) — Descripción de la giftcard.
• start_date (string, opcional) — Fecha de inicio de validez.
• end_date (string, opcional) — Fecha de expiración.

---

​

Obtener detalles de local

Obtiene información detallada de un local incluyendo servicios y prestadores disponibles. Entradas:

• location_id (number) — ID del local.
• include_services (boolean) — Incluir servicios disponibles (default: true).
• include_providers (boolean) — Incluir prestadores disponibles (default: true).

---

​

Obtener detalles de prestador

Obtiene información detallada de un prestador incluyendo sus servicios. Entradas:

• provider_id (number) — ID del prestador.

---

​

Obtener detalles de servicio

Obtiene información detallada de un servicio incluyendo los prestadores que lo ofrecen. Entradas:

• service_id (number) — ID del servicio.

​

Ejemplo de uso

Un flujo típico para agendar una cita:

1. Buscar servicios disponibles — Usa “Buscar entidades” con entity: "services" para listar servicios.
2. Buscar locales — Usa “Buscar entidades” con entity: "locations" para ver sucursales.
3. Consultar disponibilidad — Usa “Obtener horarios disponibles” con el servicio y fecha deseados.
4. Crear la reserva — Usa “Crear reserva” con los datos del cliente y el horario seleccionado.