Feeds de calendario (ICS)

Por qué es importante

No todos quieren otorgar acceso OAuth a su calendario. Los feeds 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 feed de calendario cada 15 minutos y lo 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 un feed de calendario

1. Navega a Integrations > Calendar Feeds
2. Haz clic en Add Calendar Feed
3. Pega la URL ICS de tu calendario (debe comenzar con https://)
4. Si quieres, establece un nombre visible (Kit lo detecta automáticamente del feed)
5. Haz clic en Add Calendar Feed

Kit valida la URL, obtiene el feed 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 feeds de calendario

Función	Google Calendar (OAuth)	Feeds de calendario (ICS)
Detección de conflictos	En tiempo real	Retraso de 15 minutos
Invitaciones de entrevista	Se envían por correo como .ics (nunca se escriben en tu calendario)	Se envían por correo como .ics (nunca se escriben en tu calendario)
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 el feed

Usa Google Calendar si quieres detección de conflictos en tiempo real. Ninguna de las dos opciones escribe en tu calendario: las invitaciones de entrevista siempre se envían por correo como archivo .ics.

Usa los feeds 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 feeds de calendario

Editar un feed

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

Actualizar un feed

Haz clic en el menú de tres puntos (⋮) junto a un feed y selecciona Refresh Now. Kit obtiene la última versión de inmediato en lugar de esperar la siguiente consulta de 15 minutos.

Eliminar un feed

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

Privacidad y seguridad

Los feeds de calendario están diseñados 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 al feed 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 el feed antiguo y agrega la nueva URL si hace falta

Solución de problemas

El feed no se actualiza

Posibles causas:

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

Solución:

• Revisa el estado del feed en Integrations > Calendar Feeds
• Haz clic en Refresh Now para forzar una actualización inmediata
• Si la URL se regeneró, elimina el feed antiguo y agrega la nueva URL

Faltan eventos en la búsqueda de conflictos

Posibles causas:

1. El evento está marcado como “free” (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 “busy”
• Para eventos recurrentes, comprueba antes que aparezcan correctamente en tu app de calendario

El feed muestra “Error” o “Paused”

Kit pausa los feeds tras varios fallos de obtención para evitar solicitudes innecesarias.

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

Lista de comprobación rápida

• Navega a Integrations > Calendar Feeds
• Haz clic en Add Calendar Feed
• Pega la URL ICS secreta de tu calendario
• Verifica que el feed aparezca como “Active” 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 feeds para calendarios adicionales (personal, de equipo, etc.)