Fuentes de calendario (ICS)

Por qué es importante

No todos quieren otorgar acceso OAuth a su calendario. Las fuentes de calendario te permiten conectar cualquier calendario para detectar conflictos pegando una simple URL. Sin OAuth, sin diálogo de permisos, sin autorización de aplicaciones de terceros.

Funciona con:

• Google Calendar (personal o workspace)
• Microsoft Outlook / Office 365
• Apple Calendar (iCloud)
• Cualquier app de calendario que ofrezca una URL de exportación ICS/iCal

Kit consulta tu fuente de calendario cada 15 minutos y la usa para ocultar los horarios en conflicto cuando los candidatos reservan entrevistas, igual que la integración con Google Calendar.

Lo que necesitas

• Una cuenta de Kit con la programación habilitada
• Una app de calendario que ofrezca una URL secreta ICS/iCal (la mayoría lo hace)

Agregar una fuente de calendario

1. Navega a Integraciones > Fuentes de calendario
2. Haz clic en Agregar fuente de calendario
3. Pega la URL ICS de tu calendario (debe comenzar con https://)
4. Si quieres, establece un nombre visible (Kit lo detecta automáticamente de la fuente)
5. Haz clic en Agregar fuente de calendario

Kit valida la URL, obtiene la fuente y empieza a buscar conflictos de inmediato.

Encontrar tu URL ICS

Google Calendar

1. Abre Google Calendar y haz clic en el icono de engranaje (Configuración)
2. Haz clic en el nombre del calendario en la barra lateral izquierda
3. Desplázate hasta Secret address in iCal format
4. Copia la URL

Importante: Usa la dirección secreta, no la pública, a menos que tu calendario sea público a propósito. La URL secreta incluye un token que otorga acceso de lectura.

Microsoft Outlook / Office 365

1. Abre Outlook en la web y ve a Settings > Calendar
2. Haz clic en Shared calendars
3. En «Publish a calendar», selecciona el calendario que quieras
4. Elige Can view all details y haz clic en Publish
5. Copia el enlace ICS (no el HTML)

Apple Calendar (iCloud)

1. Abre la app Calendar en tu Mac
2. Haz clic derecho en el calendario que quieras compartir
3. Selecciona Share Calendar…
4. Marca Public Calendar
5. Copia la URL que aparece

Cómo funciona

Aspecto	Detalle
Frecuencia de consulta	Cada 15 minutos
Datos a los que accede	Solo horas de inicio/fin de eventos y estado ocupado/libre
Datos almacenados	Solo ventanas de tiempo ocupado (sin contenido de eventos)
Rango de tiempo	Próximos 30 días
Eventos recurrentes	Se expanden automáticamente (diario, semanal, mensual)
Eventos de todo el día	Bloquean el día completo

Cuando un candidato ve los horarios de entrevista disponibles, Kit resta los tiempos ocupados de tu calendario a tu horario de disponibilidad, exactamente igual que con Google Calendar.

Integración con Google Calendar frente a fuentes de calendario

Función	Google Calendar (OAuth)	Fuentes de calendario (ICS)
Detección de conflictos	En tiempo real	Retraso de 15 minutos
Invitaciones de entrevista	Se envían por correo como .ics, más una entrada directa en el calendario del entrevistador principal si ha activado Permitir crear eventos en este calendario	Solo se envían por correo como .ics: Kit nunca puede escribir en una fuente ICS
Configuración	Autorización OAuth	Pegar una URL
Compatible con	Solo Google Calendar	Cualquier proveedor de calendario
Privacidad	Requiere permisos de calendario	Basado en URL, sin acceso a la cuenta
Eventos de todo el día	Compatible	Compatible
Eventos recurrentes	Los gestiona la API de Google	Se expanden desde la fuente

Usa Google Calendar si quieres detección de conflictos en tiempo real, o si quieres que las entrevistas reservadas aparezcan en el calendario del entrevistador principal sin que nadie tenga que aceptar un adjunto (consulta Integración de calendario). Una fuente de calendario es de solo lectura: Kit lee de ella las ventanas de tiempo ocupado y nunca puede escribir en ella. En cualquiera de los dos casos, las invitaciones de entrevista siempre se envían además por correo como archivos .ics adjuntos.

Usa las fuentes de calendario si prefieres no otorgar acceso OAuth, usas un calendario que no es de Google, o quieres agregar un calendario secundario de otro proveedor.

Puedes usar ambos a la vez. Kit combina los tiempos ocupados de todas las fuentes conectadas.

Gestionar fuentes de calendario

Editar una fuente

Navega a Integraciones > Fuentes de calendario, busca tu fuente en la sección Fuentes de calendario y haz clic en el icono de lápiz. Puedes cambiar el nombre visible y activar o desactivar la búsqueda de conflictos.

Actualizar una fuente

Haz clic en el menú de tres puntos (⋮) junto a una fuente y selecciona Actualizar ahora. Kit obtiene la última versión de inmediato en lugar de esperar la siguiente consulta de 15 minutos.

Eliminar una fuente

Haz clic en el menú de tres puntos (⋮) y selecciona Eliminar fuente de calendario. Kit deja de buscar conflictos en este calendario. Tu calendario en sí no se ve afectado.

Privacidad y seguridad

Las fuentes de calendario están diseñadas pensando en la privacidad:

• No se almacena el contenido de los eventos – Kit lee únicamente las horas de inicio/fin de eventos y el estado ocupado/libre. Los títulos de eventos, descripciones, asistentes y ubicaciones se descartan de inmediato tras el análisis.
• Almacenamiento cifrado – Tu URL de calendario se cifra en reposo. Nunca se registra ni se expone en respuestas de la API.
• Solo HTTPS – Kit solo acepta URLs de calendario sobre HTTPS.
• Tú controlas el acceso – Para revocar el acceso de Kit, regenera la URL secreta de tu calendario en tu app de calendario (Google, Outlook, etc.). La URL antigua deja de funcionar de inmediato.

Revocar el acceso

A diferencia de OAuth (donde revocas desde Kit o tu cuenta de Google), el acceso a la fuente de calendario se controla mediante la propia URL:

1. Ve a la configuración de tu app de calendario
2. Busca el calendario publicado/compartido
3. Haz clic en «Reset» o «Unpublish» para invalidar la URL anterior
4. En Kit, elimina la fuente antigua y agrega la nueva URL si hace falta

Solución de problemas

La fuente no se actualiza

Posibles causas:

1. La URL del calendario se revocó o regeneró
2. Tu proveedor de calendario no está disponible temporalmente
3. La fuente se pausó tras fallos repetidos

Solución:

• Revisa el estado de la fuente en Integraciones > Fuentes de calendario
• Haz clic en Actualizar ahora para forzar una actualización inmediata
• Si la URL se regeneró, elimina la fuente antigua y agrega la nueva URL

Faltan eventos en la búsqueda de conflictos

Posibles causas:

1. El evento está marcado como «libre» (transparente) en tu calendario
2. El evento usa un patrón de recurrencia inusual que Kit no puede expandir
3. El evento está a más de 30 días en el futuro

Solución:

• Edita el evento en tu calendario y establece el estado en «ocupado»
• Para eventos recurrentes, comprueba antes que aparezcan correctamente en tu app de calendario

La fuente muestra «Error» o «Pausado»

Kit pausa las fuentes tras varios fallos de obtención para evitar solicitudes innecesarias.

• Error (3+ fallos): Kit sigue intentándolo. Comprueba que tu URL sea válida.
• Pausado (fallos prolongados): Kit ha dejado de consultar. Elimina la fuente y vuelve a agregarla con una URL nueva.

Lista de comprobación rápida

• Navega a Integraciones > Fuentes de calendario
• Haz clic en Agregar fuente de calendario
• Pega la URL ICS secreta de tu calendario
• Verifica que la fuente aparezca como «Activo» tras unos minutos
• Pruébalo abriendo una página de reserva de candidato y confirma que los horarios en conflicto estén ocultos
• Si quieres, agrega fuentes para calendarios adicionales (personal, de equipo, etc.)