Consultar Disponibilidad

Consulta los tiempos ocupados de multiples personas para encontrar el mejor horario para reuniones.

Como funciona

Consulta de disponibilidad

Quiero agendar reunion con:

• Maria (reclutadora)
• Carlos (tech lead)
• Juan (candidato)

Sistema consulta:

• Eventos de Maria en Talivo
• Eventos de Maria en Google Calendar
• Eventos de Carlos en Talivo y Outlook
• Disponibilidad de Juan (email)

Resultado:

• Bloques donde TODOS estan ocupados
• Horarios donde TODOS estan libres
• Sugerencias de mejores slots

FreeBusy API

Google Calendar

POST /freeBusy/query

Request:
{
  "timeMin": "2024-01-15T00:00:00Z",
  "timeMax": "2024-01-22T00:00:00Z",
  "items": [
    { "id": "maria@empresa.com" },
    { "id": "carlos@empresa.com" }
  ]
}

Response:
{
  "calendars": {
    "maria@empresa.com": {
      "busy": [
        { "start": "2024-01-15T10:00:00Z", "end": "2024-01-15T11:00:00Z" },
        { "start": "2024-01-15T14:00:00Z", "end": "2024-01-15T15:00:00Z" }
      ]
    }
  }
}

Microsoft Graph

POST /me/calendar/getSchedule

Request:
{
  "schedules": ["maria@empresa.com", "carlos@empresa.com"],
  "startTime": { "dateTime": "2024-01-15T00:00:00", "timeZone": "America/Mexico_City" },
  "endTime": { "dateTime": "2024-01-22T00:00:00", "timeZone": "America/Mexico_City" }
}

Visualizacion de disponibilidad

Vista por persona

Slots comunes

Horarios donde TODOS estan libres:

Lun 15 Ene

• 09:00 - 10:00
• 16:00 - 17:00

Mar 16 Ene

• 11:00 - 12:00
• 15:00 - 16:00

Mie 17 Ene

• 14:00 - 15:00

Consultar multiples personas

Endpoint de Talivo

POST /api/google/busy/multiple

Body:
{
  "emails": [
    "maria@empresa.com",
    "carlos@empresa.com",
    "candidato@email.com"
  ],
  "timeMin": "2024-01-15T00:00:00Z",
  "timeMax": "2024-01-22T00:00:00Z"
}

Respuesta

{
  "individual": {
    "maria@empresa.com": {
      "busy": [
        { "start": "...", "end": "..." }
      ]
    },
    "carlos@empresa.com": {
      "busy": [...]
    }
  },
  "combined": [
    {
      "start": "2024-01-15T09:00:00Z",
      "end": "2024-01-15T10:00:00Z",
      "available": true
    },
    {
      "start": "2024-01-15T10:00:00Z",
      "end": "2024-01-15T11:00:00Z",
      "available": false,
      "busyAttendees": ["maria@empresa.com"]
    }
  ]
}

Uso al agendar entrevistas

Flujo recomendado

1. Crear nuevo evento
2. Seleccionar participantes:
   • Candidato
   • Entrevistador 1
   • Entrevistador 2
3. Click "Ver disponibilidad"
4. Sistema muestra slots libres
5. Seleccionar horario
6. Crear evento

Panel de sugerencias

MEJORES OPCIONES:

• Lun 15, 09:00 - 10:00 - Todos disponibles
• Mar 16, 15:00 - 16:00 - Todos disponibles
• Mie 17, 10:00 - 11:00 (advertencia) - Carlos tiene conflicto tentativo

Requisitos para consultar

Calendarios internos (Talivo)

Para ver disponibilidad de usuarios Talivo:

• Usuario debe tener eventos en Talivo
• O tener calendario externo conectado
• Permisos de calendario.read

Calendarios externos

Google:

• Usuario debe tener Google conectado
• O calendario publico/compartido

Microsoft:

• Usuario en misma organizacion
• O calendario compartido externamente

Zonas horarias

Consideraciones

Al consultar disponibilidad:

• Especificar zona horaria de referencia
• Sistema convierte automaticamente
• Muestra en zona horaria local del usuario

Ejemplo

Consulta desde Mexico City (GMT-6):

• Maria esta en Mexico (GMT-6)
• Carlos esta en Madrid (GMT+1)
• Juan esta en Buenos Aires (GMT-3)

Sistema:

• Convierte todo a UTC internamente
• Muestra resultados en GMT-6 (tu zona)
• 10:00 Mexico = 17:00 Madrid = 13:00 BA

Bloquear tiempo

Crear bloque de ocupado

Si necesitas bloquear tiempo sin evento:

1. Crear evento personal
2. Titulo: "Ocupado" o "Bloqueado"
3. Sin participantes
4. Aparece como ocupado en disponibilidad

Sincronizar bloques

Bloques en Google/Outlook:

• Se reflejan automaticamente
• Muestran como "ocupado"
• Bloquean para agendamiento

Limitaciones

Calendarios externos no conectados

Si el participante no tiene calendario conectado:

• No se puede consultar su disponibilidad
• Debes preguntarle directamente
• O usar link de auto-agendamiento

Calendarios privados

Eventos marcados como privados:

• Se muestran como "ocupado"
• Sin detalles del evento
• Respetan privacidad del usuario

Rate limits

Proveedores tienen limites:

• Google: X consultas por minuto
• Microsoft: Y consultas por hora
• Talivo maneja automaticamente

Mejores practicas

Consultar rango razonable

Recomendado:

• 1-2 semanas adelante
• Horario laboral (9-18)
• No mas de 10 participantes

Evitar:

• Rangos de meses
• Demasiados participantes
• Consultas muy frecuentes

Usar links de agenda

Para candidatos externos:

• Enviar link de auto-agendamiento
• Ve tu disponibilidad automaticamente
• Elige horario el mismo
• Menos coordinacion manual

Mantener calendario actualizado

Para disponibilidad precisa:

• Registrar todos los compromisos
• Bloquear tiempo personal
• Sincronizar calendarios externos
• Actualizar cuando cambie algo

Problemas comunes

"No puedo ver disponibilidad de X"

Causas:

1. Usuario no tiene calendario conectado
2. Calendario no compartido
3. Politica de privacidad

Solucion: Pedir que conecte calendario o use link de agenda.

"Muestra disponible pero esta ocupado"

Causas:

1. Evento creado despues de consulta
2. Calendario no sincronizado
3. Evento en otro calendario

Solucion: Refrescar y verificar calendarios.

"Error al consultar"

Causas:

1. Token expirado
2. Rate limit alcanzado
3. Email invalido

Solucion: Reconectar calendario o esperar.

Proximos pasos

• Enlaces de Agenda - Auto-agendamiento
• Crear Eventos - Programar reuniones