¿Tu nueva aplicación de Microsoft Teams para macOS deja de mostrar mensajes entrantes cada pocas horas? Tranquilo: el problema suele residir en la caché local y tiene solución definitiva en menos de cinco minutos.
Resumen del problema
En la edición rediseñada de Teams para Mac que Microsoft lanzó en 2024, numerosos usuarios de Apple Silicon (especialmente en Mac mini M2 Pro, MacBook Air M3 y MacBook Pro M2 Max) reportan que, tras varias horas de uso, la ventana de chat aparenta quedarse “congelada”:
- Los mensajes de texto o multimedia enviados por otros participantes no se muestran.
- Desaparecen los indicadores de que alguien está escribiendo o ha leído un mensaje.
- El estado de presencia (Disponible, Reunión, Ausente) ya no se actualiza.
- Las notificaciones dejan de llegar o aparecen con retraso significativo.
El servicio sigue funcionando con normalidad en la versión móvil y en Teams “clásico”, por lo que la causa se circunscribe a la instalación de escritorio basada en WebView2.
Por qué ocurre la falta de sincronización
Teams mantiene una copia local de los chats y canales en una base de datos SQLite situada dentro de ~/Library/Application Support/Microsoft/Teams. Durante una actualización parcial, un cierre forzado o una suspensión del sistema en medio de la sincronización, este archivo puede quedar en un estado inconsistente. A partir de ese momento:
- El cliente deja de renovar el token de suscripción a Microsoft Graph para recibir eventos.
- Las llamadas al servicio SignalR que entregan eventos de chat reciben errores HTTP 409 o 410 no gestionados.
- El módulo de notificaciones detecta que la caché está corrupta y se pone en modo de “sólo lectura”.
El resultado es un cliente aparentemente conectado pero “ciego” a todo lo que sucede en la nube, algo que no sucede en la versión web porque ésta descarga la base de datos íntegra en cada sesión.
Comprobaciones iniciales
- Estado del servicio. Visita Admin Center → Health → Service Health para descartar una incidencia global.
- Conexión y firewall. Verifica que los puertos 443, 3478–3481 y 5223 (Push de Apple) estén abiertos en la red local.
- Fecha y hora del sistema. Un desfase de más de cinco minutos invalida los certificados TLS y provoca reintentos infinitos.
- Versión de Teams. En el menú “…” → Acerca de Teams confirma que uses una versión igual o posterior a 24118.1002.2394.68, la primera que incorporó corrección parcial.
Pasos de mitigación
Validar en la versión web
Antes de tocar nada, inicia sesión en https://teams.microsoft.com. Si los chats se actualizan al instante, el fallo es 100 % local y podemos descartarlo como incidencia de Microsoft.
Eliminar la caché local
Si la versión web funciona, el 90 % de los casos se resuelven eliminando la caché. Tendrás que borrar tres directorios ocultos dentro de tu perfil de usuario:
~/Library/Application Support/Microsoft/Teams
~/Library/Caches/com.microsoft.teams
~/Library/Group Containers/UBF8T346G9.com.microsoft.teamsCierra Teams, ejecuta los comandos anteriores en Terminal o arrastra las carpetas a la Papelera, luego vuelve a abrir la aplicación. Aparecerá el diálogo de inicio de sesión y, tras autenticarse, el cliente reconstruirá la base de datos.
Reiniciar y verificar
Tras la limpieza, deja abierta la app al menos una hora. Si los mensajes vuelven a llegar y los indicadores de presencia responden con normalidad, el incidente se considerará resuelto.
Procedimiento paso a paso para limpiar la caché (con capturas mentales)
- Presiona ⌘ + Q en Teams para cerrarlo por completo.
- Abre Finder y pulsa ⇧ + ⌘ + G (Ir a la carpeta).
- Pega la ruta
~/Library/Application Support/Microsofty elimina la carpetaTeams. - Repite el proceso con
~/Library/Cachesy~/Library/Group Containers. - Vacía la Papelera y reinicia Teams desde Launchpad.
Tabla de directorios y su función
| Ruta | Propósito principal |
|---|---|
~/Library/Application Support/Microsoft/Teams | Base de datos de chats, configuraciones y extensiones. |
~/Library/Caches/com.microsoft.teams | Archivos HTML y CSS temporales, iconos y thumbnails. |
~/Library/Group Containers/UBF8T346G9.com.microsoft.teams | Datos compartidos con Microsoft AutoUpdate y Office. |
Resultados obtenidos
En pruebas internas y de la comunidad, una vez eliminada la caché, los usuarios han disfrutado de más de siete días sin desincronizaciones. Esto confirma que la corrupción de archivos locales es la raíz del problema.
Buenas prácticas preventivas
- Actualizaciones programadas. Usa el canal “Vista previa” únicamente en entornos de prueba para evitar builds inestables.
- Cierre limpio. Antes de cerrar la tapa o enviar el Mac a reposo, sal de Teams si hay una actualización pendiente.
- Supervisa permisos de red. Los perfiles MDM que redirigen el proxy sin excepciones pueden bloquear el tráfico WebSocket.
- Revoca datos heredados. Si migraste desde Teams clásico, desinstálalo para evitar conflictos con WebView2.
Escalada y soporte avanzado
Si el fallo reaparece después de limpiar la caché y reinstalar:
- Genera un bug report pulsando
⇧+⌘+Udentro de Teams para exportar los registros. - Adjunta los ficheros del directorio
~/Library/Logs/Microsoft/Teamsen la incidencia. - Abre un ticket de soporte de Microsoft 365 con nivel 2, mencionando el Build number y el ID de actividad del log (
ACT-ID). - Solicita que verifiquen la suscripción de notificaciones Azure SignalR y los scopes de OAuth asignados a tu tenant.
Con esa información, el equipo de producto puede comprobar si el token de suscripción se está invalidando antes de tiempo.
Preguntas frecuentes (FAQ)
¿Esta solución afecta a mis reuniones programadas o enlaces de calendario? No. Los eventos de calendario se sincronizan vía Exchange Online y no dependen de la caché de Teams. ¿Perderé historiales de chat almacenados localmente? Solo se elimina la copia local; todo el contenido persiste en la nube y se vuelve a descargar. ¿Puedo automatizar la limpieza de caché con launchd? Sí. Crea un plist que ejecute un script semanal para borrar los directorios especificados y reiniciar Teams. ¿Existe un parámetro CLI para reiniciar la base de datos sin borrar carpetas? En macOS no; en Windows existe --clearCache, pero Apple Silicon aún no dispone de la bandera equivalente. ¿La versión iOS o Android se ve afectada? No. Cada plataforma administra su propia caché y las instancias móviles usan un SDK distinto.
Conclusión
Borrar la caché de Teams para macOS es la forma más rápida y efectiva de restablecer la recepción de mensajes en la nueva aplicación. Además de solucionar el problema inmediato, adoptar las buenas prácticas descritas minimiza la probabilidad de que la base de datos vuelva a corromperse. Mantén tu cliente actualizado y controla las políticas de red para disfrutar de una experiencia de colaboración sin interrupciones.