Google Calendar y reservas: horario laboral no significa disponibilidad
Consultar la jornada desde una API puede mejorar una integración de citas, pero todavía hay que combinarla con ocupación, duración, excepciones y confirmación de la reserva.
El horario laboral indica cuándo suele trabajar una persona; no demuestra que pueda aceptar una cita concreta. Para automatizar reservas necesitas combinar jornada, eventos ocupados, reglas del servicio y una confirmación consistente. Confundir estas capas puede generar citas fuera de horario o solapamientos aunque la API responda correctamente.
Qué cambia con el acceso al horario laboral
Google anunció el 3 de noviembre de 2026 la lectura y actualización del horario laboral de usuarios de Workspace en su calendario principal mediante workingHours. La referencia del recurso Calendars es el punto de partida para revisar disponibilidad del campo, autorización y estructura de datos.
Esta capacidad no equivale a un sistema completo de reservas. La integración sigue necesitando reglas del negocio y permisos adecuados; tampoco debe modificar la jornada de una persona solamente para encajar una cita solicitada.
Definir qué representa una cita disponible
Antes de conectar sistemas, concreta duración, tiempo de preparación, margen entre citas y antelación mínima. Una empresa puede atender de nueve a seis y, aun así, no aceptar un servicio largo a última hora.
Separa reglas personales de reglas del establecimiento. Un técnico puede tener hueco, pero necesitar una sala, vehículo o equipo ocupado. Un calendario individual no representa automáticamente todos esos recursos.
Resolver zonas horarias sin depender de la pantalla
Almacena el instante de la cita y conserva el contexto horario que necesita la operación. Muestra al cliente la zona utilizada antes de confirmar, especialmente si la empresa trabaja entre España y México.
Prueba fechas cercanas a cambios estacionales de hora. No sustituyas las zonas geográficas por una diferencia fija de horas para todo el año. Lo importante es que cliente, profesional y sistema de gestión interpreten la misma reserva.
Tratar excepciones y datos ausentes
Vacaciones, festivos, cierres y cambios puntuales necesitan una política explícita. Si no puede leerse la jornada, el sistema no debería inventar disponibilidad ilimitada. Puede ofrecer una solicitud pendiente de confirmación o pedir intervención.
Documenta qué fuente manda cuando hay discrepancias entre CRM, configuración del negocio y calendario. Sin esa regla, cada sincronización puede sobrescribir una decisión válida de otra herramienta.
Confirmar sin prometer bloqueo automático
Entre mostrar un hueco y recibir la aceptación, otra persona puede ocuparlo. Revalida antes de confirmar y define cómo se resuelven peticiones simultáneas. No anuncies que una lectura de disponibilidad garantiza una reserva exclusiva.
Relaciona solicitud y cita final mediante un identificador estable. Si se pierde una respuesta y hay un reintento, comprueba el resultado anterior antes de crear otro evento. La cancelación también debe propagarse de manera controlada.
Probar el recorrido desde el negocio
Ensaya una cita válida, otra fuera de jornada, una con recurso ocupado y una petición repetida. Incluye pérdida de acceso al calendario y respuesta tardía. El resultado esperado debe ser comprensible para quien atiende, no únicamente para quien interpreta logs.
Podemos preparar una integración entre sistemas mediante API o una aplicación interna que respete esas reglas. El objetivo es coordinar reservas fiables, no añadir llamadas a una API sin definir la operación.