Tu propio portal o app
El cliente elige un horario donde ya contrata un servicio o gestiona su cuenta.
API y webhooks
Reservas de Umovi en tu sistema
Ofrece la selección de servicios y horarios disponibles en tu portal, CRM o aplicación. La API registra la reserva en Umovi y los webhooks permiten recibir avisos de cambios posteriores.
Ejemplo: tu portal de clientes
Cómo llega una reserva de tu portal a Umovi
Este ejemplo de un portal de clientes muestra la consulta de horarios, el registro de la reserva y la actualización cuando cambia la hora.
- 01
Tu portal muestra los horarios libres.
Tu portalDisponibilidad en Umovi
Consulta los servicios, profesionales y horarios en Umovi. El cliente elige una hora que respeta la jornada, la duración del servicio y las pausas del calendario.
- 02
La reserva llega a tu equipo.
Elección del clienteCalendario del equipo
El portal envía el horario elegido y los datos del cliente. Umovi verifica la disponibilidad al guardar. Cuando se crea, la reserva aparece en el calendario y el portal recibe su identificador.
- 03
Los cambios vuelven al portal.
Cambio en UmoviActualización del portal
Un empleado cambia la hora de la reserva en Umovi. Un webhook avisa a tu sistema, que puede consultar los datos actuales y mostrar al cliente el nuevo horario.
Cuándo tiene sentido
Dónde puedes usar la API de Umovi
CRM y atención al cliente
Un asesor consulta horarios y registra la reserva desde la herramienta en la que mantiene la conversación.
Automatizaciones tras la reserva
Crear, cambiar o cancelar una reserva pone en marcha el siguiente paso en tu sistema.
¿Solo quieres que tus clientes reserven online? Empieza con tu perfil de Umovi y un enlace de reserva.
Conocer el panel del negocioAlcance de la implementación
Qué necesitas preparar para la integración
La integración requiere desarrollo en tu sistema. Un programador prepara el formulario, la relación entre datos y la gestión de actualizaciones. En Umovi configuras la oferta, la disponibilidad y los permisos.
En Umovi
Preparas los servicios, el equipo, los horarios y el acceso de la integración a tu negocio.
En tu sistema
Tu desarrollador vincula clientes y reservas, gestiona los horarios ocupados y procesa las actualizaciones de Umovi.
Para quien implementa
Cómo conectar con la API
REST entre servidores, OAuth2 client credentials y acceso limitado a un negocio. Guarda el secreto de la integración en tu servidor.
Operaciones y casos que debes contemplar
- 01
Obtén un token y el catálogo.
Crea un cliente de integración en el panel, guarda el secreto que se muestra una sola vez y solicita un token. El catálogo proporciona los servicios y profesionales para elegir horario.
- 02
Comprueba disponibilidad antes de guardar.
Gestiona los conflictos de horario. Usa Idempotency-Key al reintentar y envía el identificador de tu registro como externalReservationId.
- 03
Recibe cambios por HTTPS.
Verifica la firma HMAC sobre el cuerpo original. Los webhooks pueden repetirse y llegar fuera de orden: deduplica las entregas y consulta el estado actual de la reserva.
REST · /integrations
POST /integrations/oauth/token
grant_type: client_credentials
/integrations/v1/providers/{providerId}
GET /catalog
POST /reservations
POST /webhooks
Idempotency-Key: <unique-request-key>
booking.created
booking.rescheduled
booking.cancelled_by_client¿Tienes un proceso que conectar?
Hablemos de tu sistema
Cuéntanos qué sistema utilizas y qué debe pasar tras elegir un horario. Definiremos el alcance de la conexión con Umovi.