Cuando una organización adopta la nueva interfaz de Microsoft Teams (también llamada “Nuevo Teams” o “Teams 2.1”) espera un rendimiento superior y una experiencia más fluida. Sin embargo, varios administradores de Microsoft 365 informan de un obstáculo repetido: el nombre del empleado recién creado no aparece en los cuadros de búsqueda al intentar agregarlo a un equipo o canal. En Teams “clásico” el usuario sí aparece inmediatamente, pero en la nueva aplicación se muestra el mensaje “No se encontró coincidencia”.
En la mayoría de los casos el problema no se debe a errores de licencia ni a permisos, sino a la combinación de tres factores:
- El tiempo natural de replicación de Azure AD (hasta 24 h) y la reconstrucción nocturna de la libreta de direcciones interna.
- Información de usuario almacenada en la caché local de Teams, que puede contener registros obsoletos tras la migración a Nuevo Teams.
- Archivos dañados o incompletos de la instalación UWP de Teams, sobre todo si la actualización se interrumpió o ha fallado Windows Repair.
El artículo describe, paso a paso, cómo acelerar la solución y, sobre todo, cómo evitar que el mismo incidente se repita cuando se incorporen futuros empleados.
Cómo identificar si el problema es de caché o de replicación
Antes de aplicar cambios drásticos conviene diferenciar:
- Fallo local. Si otro administrador, desde otro equipo o desde la versión web (
https://teams.microsoft.com), sí encuentra al usuario, estamos ante un fallo de caché o instalación en el dispositivo original. - Fallo de directorio. Si nadie puede localizar al usuario ni en Nuevo Teams ni en Teams clásico, lo más probable es que la cuenta aún no haya terminado su replicación global.
Solución inmediata recomendada
En el caso más habitual — el usuario existe en Azure AD y aparece en Teams clásico, pero no en Nuevo Teams — sigue esta secuencia de intervención mínima:
| Paso | Acción | Propósito |
|---|---|---|
| 1. Reparar la aplicación | Configuración de Windows → Aplicaciones › Aplicaciones instaladas → Microsoft Teams (Nuevo) → Opciones avanzadas › Reparar | Corrige archivos dañados o instalaciones incompletas. |
| 2. Restablecer y limpiar caché | En las mismas Opciones avanzadas, pulsa Restablecer. Después elimina manualmente la carpeta %AppData%\Microsoft\Teams\* o sigue la guía oficial “Clear Teams cache”. | Fuerza a Teams a reconstruir la libreta de direcciones y eliminar registros obsoletos. |
| 3. Probar en otro equipo o navegador | Inicia sesión con la misma cuenta en otro dispositivo o en Teams web. | Distingue entre un fallo local y un problema del servicio. |
| 4. Considerar la replicación de Azure AD | Espera hasta 24 h tras la creación del usuario. | La libreta global se sincroniza; en el caso reportado se actualizó durante la noche. |
En el 90 % de los escenarios reales bastan los pasos 1 y 2 para que el nombre aparezca al instante en los cuadros de búsqueda de Nuevo Teams. Solo en entornos híbridos con conexiones de red lentas o reglas de retención estrictas se alcanza el margen máximo de 24 h.
Explicación técnica de cada paso
Reparar la instalación UWP de Teams
La versión distribuida desde Microsoft Store se implementa como una aplicación UWP (Universal Windows Platform). Windows 11 registra su estado en la base de datos del sistema y, si detecta archivos corruptos o un SHA hash erróneo, la pone en modo “requiere reparación”. Al pulsar Reparar, el sistema descarga de nuevo los paquetes diferenciales y rescribe las dependencias dañadas.
Restablecer y purgar la caché
Teams almacena su caché en dos rutas:
%AppData%\Microsoft\Teams– ajustes de la aplicación y tokens de autenticación.%LocalAppData%\Microsoft\Teams– blobs de datos como thumbnails, logs y el catálogo de usuarios.
Restablecer en Configuración equivale a ejecutar wsreset.exe para la aplicación UWP: borra registros, cookies y datos fuera de roaming. El borrado manual asegura la eliminación de cualquier fichero huérfano que bloquee la actualización del directory roster.
Prueba cruzada en otro dispositivo
Si en un segundo equipo (o en Teams web) el usuario aparece, confirmas que la sincronización de Azure AD es correcta y que el problema se acota al perfil original de Windows. Este paso ahorra tiempo porque descarta tareas de reimportación masiva o recreación de la cuenta.
Replicación de Azure AD y atributos críticos
Cuando creas un usuario en el centro de administración de Microsoft Entra ID (antes Azure AD), los atributos se propagan en varias oleadas:
- Datacenters de Entra ID (segundos).
- Microsoft Graph API y Exchange Online (minutos).
- LinkedIn Work School Accounts, Viva Engage y rosters de Teams (ciclos cada 30 min).
Un ciclo completo de ida y vuelta no debería exceder 4 h, pero Microsoft documenta un SLA de hasta 24 h para no romper dependencias con clientes legacy. De hecho, estas ventanas largas son una herencia de Skype for Business y de la coexistencia con Exchange On‑Prem.
Buenas prácticas para prevenir incidencias futuras
Automatizar el vaciado de caché en el proceso de incorporación
Incluye un script de PowerShell en Intune o en GPO que, al primer inicio de sesión del empleado, ejecute:
<# Elimina carpetas de Teams, reinicia servicios y registra evento personalizado #> Remove-Item -Path "$env:AppData\Microsoft\Teams\*" -Recurse -Force -ErrorAction SilentlyContinue Stop-Process -Name Teams -Force -ErrorAction SilentlyContinue Start-Sleep -Seconds 2 Start-Process "C:\Program Files\WindowsApps\MSTeams_*\MS Teams.exe"
Así evitas que el usuario se encuentre con una caché “heredada” del perfil de referencia o de la imagen corporativa.
Supervisar la replicación mediante Microsoft Graph
Con una sencilla consulta REST GET a /beta/users?$filter=mailNickname eq 'jsanchez' puedes verificar si el objeto está disponible en el frente de Graph. Si la respuesta es 200 OK, pero Teams aún no resuelve el UPN, sabes que la incidencia se ubica en la capa cliente, no en el servicio.
Programar tareas de “Teams Cleanup”
Para dispositivos compartidos (salas de reuniones, quioscos o laptops de préstamo) conviene una tarea programada que borre la caché de Teams cada madrugada. Así evitas que un dispositivo contenga información personal de quien lo usó el día anterior.
Actualizar Nuevo Teams de manera controlada
Nunca es buena idea dejar que cada usuario pulse “Probar la nueva versión” en días diferentes. Microsoft publica el paquete MSTeams-x64.msix con cadencia mensual. Establece anillos de despliegue (piloto, producción) y basa la actualización en versiones validadas por tu departamento de IT.
Comprobaciones avanzadas (para entornos híbridos)
Verificar sincronización de objetos en Azure AD Connect
Si tu organización mantiene Active Directory On‑Prem, ejecuta en el servidor del conector:
Start-ADSyncSyncCycle -PolicyType Delta
De esta forma fuerzas un ciclo delta y compruebas que el export” a Entra ID termina sin errores (evento 6935). Si hay colisiones de proxyAddresses, Teams no resolverá el objeto hasta que se subsanen.
Inspeccionar atributos obligatorios
Teams necesita, al menos, los siguientes atributos para indexar un usuario en la libreta global:
| Atributo | Descripción |
|---|---|
mail | Dirección principal SMTP. |
userPrincipalName | UPN con sufijo de dominio habilitado en Teams. |
displayName | Nombre visible. |
accountEnabled | Debe ser true. |
Si alguno falta o se rellena más tarde (caso típico de scripts de provisioning por lotes), Teams tardará otro ciclo de 30 min en indexarlo.
Preguntas frecuentes
¿Puedo acortar el tiempo de replicación oficial?
No. Lo máximo que puedes hacer es forzar la sincronización delta en Azure AD Connect y vaciar la caché local. El backend de Teams se rige por sus propios ciclos internos.
¿Es mejor volver temporalmente a Teams clásico?
Solo como medida provisional para terminar tareas urgentes. El objetivo es resolver el problema en la nueva interfaz, por lo que conviene enfocarse en reparar la instalación y limpiar caché.
¿La licencia de Microsoft Teams Exploratory influye?
No en este caso. Si el usuario inicia sesión y ve el tenant correcto, la licencia (E1, E3, E5, Exploratory, F3) no afecta a su indexación en la libreta global.
Conclusión
Cuando Nuevo Teams no encuentra a un usuario recién creado, la raíz suele estar en la capa local: caché desactualizada o archivos corruptos tras la migración. Reparar la aplicación y purgar la caché resuelven la mayoría de incidentes al instante. En los pocos casos restantes, basta con esperar la replicación completa de Azure AD. Establecer procesos automáticos de limpieza y supervisión garantiza que cada nuevo empleado sea localizable desde el primer momento, manteniendo así la productividad del equipo.