Corregir la plantilla de Teams que crea los canales incorrectos para un equipo de departamento

Cuando aplicas una plantilla de Teams a un equipo de departamento, es posible que los canales esperados no aparezcan. En su lugar, ves canales predeterminados como General, o canales de una versión anterior de la plantilla. Esta discrepancia hace perder tiempo y obliga a crear canales manualmente para cada equipo nuevo.

La causa principal suele ser una definición de plantilla obsoleta, una vista de plantilla en caché o una política que bloquea la creación de canales. En algunos casos, el propio archivo JSON de la plantilla contiene errores que Teams ignora silenciosamente.

Este artículo explica por qué fallan las plantillas, cómo diagnosticar la causa exacta y cómo corregir la plantilla para que cree los canales correctos cada vez. También aprenderás a evitar errores comunes al editar archivos de plantilla.

Por qué las plantillas de Teams crean los canales incorrectos

Una plantilla de Teams define la estructura de un equipo, incluidos sus canales, pestañas y aplicaciones. Cuando aplicas una plantilla, Teams lee la definición de la plantilla y crea el equipo en consecuencia. Si la plantilla produce los canales incorrectos, el problema radica en una de tres áreas: la definición de la plantilla en sí, la vista en caché de la plantilla o una política que restringe la creación de canales.

La causa más común es una plantilla que se editó externamente, por ejemplo a través de la API de Microsoft Graph, pero el cambio no se guardó correctamente. El archivo JSON de la plantilla puede contener nombres de canal duplicados, caracteres no válidos o canales que superan el límite de 30 canales. Teams omitirá silenciosamente las entradas no válidas y creará solo las válidas.

Otra causa frecuente es que el administrador aplica la plantilla desde el cliente de Teams, que almacena en caché la lista de plantillas. Si la plantilla se actualizó después de que se creó la caché, el cliente puede seguir mostrando la versión anterior. La solución es actualizar el cliente o usar el centro de administración para aplicar la plantilla.

Por último, una política de canal puede bloquear la creación de canales de la plantilla. Si la política asignada al propietario del equipo impide la creación de canales, la plantilla solo creará el canal General. Esto ocurre de forma silenciosa, por lo que debes comprobar la política efectiva del propietario.

Diagnosticar la plantilla y la configuración de políticas

Antes de editar nada, confirma qué versión de la plantilla se está aplicando y qué políticas afectan al propietario del equipo. Sigue estos pasos para acotar la causa.

1. Abrir la plantilla en el centro de administración de Teams
   Ve al centro de administración de Teams > Teams > Plantillas de equipo. Busca la plantilla de tu departamento y selecciona Editar. Revisa la sección Canales. Si los canales listados aquí coinciden con lo que esperas, la definición de la plantilla es correcta.
2. Comparar la versión de la plantilla con la versión aplicada
   En el editor de plantillas, anota el número de versión. Luego crea un equipo nuevo con esta plantilla. Inmediatamente después de la creación, enumera los canales. Si difieren, es posible que la plantilla que editaste no sea la que se está aplicando, quizás porque hay dos plantillas con nombres similares.
3. Comprobar la política de canal efectiva para el propietario del equipo
   Ve al centro de administración de Teams > Usuarios > Administrar usuarios. Selecciona el propietario del equipo y consulta sus políticas asignadas. Fíjate en la columna Políticas de canal. Abre la política y verifica que Crear canales esté establecido en Activado. Si está Desactivado, la creación de canales de la plantilla fallará.
4. Actualizar la caché del cliente de Teams
   Cierra Teams por completo. En Windows, haz clic con el botón derecho en el icono de Teams en la bandeja del sistema y selecciona Salir. Luego reinicia Teams. Esto borra la lista de plantillas en caché.

Pasos para corregir la plantilla y crear los canales correctos

Una vez que conozcas la causa, aplica la corrección adecuada. Usa los siguientes métodos en orden hasta que se resuelva el problema.

Método 1: Editar la plantilla en el centro de administración

1. Iniciar sesión en el centro de administración de Teams
   Abre un navegador y ve a admin.teams.microsoft.com. Usa una cuenta con el rol Administrador de Teams o Administrador global.
2. Localizar la plantilla de tu departamento
   Ve a Teams > Plantillas de equipo. Usa el cuadro de búsqueda para encontrar el nombre de la plantilla. Selecciónala para abrir el panel de detalles.
3. Editar la lista de canales
   Selecciona Editar. En la sección Canales, elimina cualquier canal que no deba existir. Agrega los canales que faltan escribiendo el nombre del canal y seleccionando Agregar. También puedes establecer la visibilidad del canal como Estándar o Privado.
4. Guardar y volver a publicar la plantilla
   Selecciona Guardar. Teams actualizará la versión de la plantilla. Cualquier equipo nuevo creado a partir de esta plantilla usará ahora la lista de canales corregida.

Método 2: Actualizar el archivo JSON de la plantilla

Si administras plantillas a través de la API de Microsoft Graph, edita el archivo JSON directamente.

1. Exportar la plantilla actual
   Usa el punto de conexión de Graph API GET /teamwork/teamTemplates para recuperar la definición de la plantilla. Guarda la respuesta JSON en un archivo.
2. Editar la matriz de canales
   Abre el archivo JSON en un editor de texto. Localiza la matriz channels. Cada objeto de canal debe tener un displayName y puede incluir isFavoriteByDefault. Elimina las entradas duplicadas o no válidas. Asegúrate de que los nombres de los canales sean únicos y no superen los 50 caracteres.
3. Validar la estructura JSON
   Usa un validador de JSON para comprobar si hay errores de sintaxis. Los errores comunes incluyen comas faltantes, corchetes adicionales o comillas sin escapar. Corrígelos antes de cargar el archivo.
4. Cargar la plantilla actualizada
   Usa el punto de conexión de Graph API PUT /teamwork/teamTemplates/{id} para reemplazar la plantilla. Confirma que la respuesta contenga la lista de canales actualizada.

Método 3: Ajustar la política de canal

1. Abrir la política de canal
   Ve al centro de administración de Teams > Teams > Políticas de equipo > Políticas de canal. Selecciona la política asignada al propietario del equipo.
2. Habilitar la creación de canales
   Establece Crear canales en Activado. También configura Eliminar canales y Restaurar canales eliminados según sea necesario. Selecciona Guardar.
3. Esperar la propagación de la política
   Los cambios de política pueden tardar hasta 24 horas en aplicarse. Para probar de inmediato, puedes forzar una actualización cerrando sesión y volviendo a iniciarla en Teams.

Si Teams sigue creando los canales incorrectos

Teams muestra solo el canal General

Cuando solo aparece General, la creación de canales de la plantilla está bloqueada. Esto casi siempre es un problema de política. Verifica que el propietario del equipo tenga la política de canal correcta. También comprueba que la plantilla no contenga más de 30 canales, porque Teams ignorará los canales que superen ese límite.

Teams crea canales duplicados

Los canales duplicados aparecen cuando el JSON de la plantilla contiene el mismo displayName dos veces. Teams no rechaza el duplicado durante la validación, pero solo creará un canal. Para solucionarlo, edita la plantilla y elimina la entrada duplicada.

Teams crea canales con nombres incorrectos

Los nombres de canal incorrectos suelen provenir de una plantilla que se copió de otro departamento. La plantilla puede contener nombres codificados que no coinciden con tu departamento. Edita la plantilla y cambia los valores de displayName por los nombres correctos.

Teams no aplica la plantilla actualizada

Si actualizaste la plantilla pero los equipos nuevos siguen mostrando canales antiguos, la caché del cliente está obsoleta. Cierra Teams por completo y reinícialo. Si el problema persiste, cierra sesión y vuelve a iniciarla para forzar una actualización completa.

Opciones de creación de canales de plantilla: Centro de administración vs Graph API

Elemento	Editor del centro de administración	Archivo JSON de Graph API
Acceso	Centro de administración de Teams > Teams > Plantillas de equipo	Graph Explorer o script personalizado
Límite de canales	Hasta 30 canales por plantilla	Hasta 30 canales por plantilla
Validación	Validación integrada con mensajes de error claros	Se requiere validación manual de JSON
Versionado	Incremento automático de versión al guardar	Actualización manual de versión en JSON
Manejo de errores	Omite silenciosamente los canales no válidos	Omite silenciosamente los canales no válidos

El editor del centro de administración es más seguro para la mayoría de los administradores porque evita errores de sintaxis. La API de Graph es útil cuando necesitas automatizar actualizaciones de plantillas en varios inquilinos.

Después de corregir la plantilla, crea un equipo de prueba para verificar los canales. Comprueba que exista cada canal esperado y que no aparezcan canales adicionales. Si la prueba pasa, aplica la plantilla al equipo del departamento.

Para evitar problemas futuros, edita siempre las plantillas a través del centro de administración a menos que necesites automatización. Mantén una copia de seguridad del archivo JSON de la plantilla que funciona. Revisa la lista de canales antes de guardar cualquier cambio.

Para un control avanzado, usa la API de Graph para establecer la propiedad isFavoriteByDefault en los canales. Esto hace que los canales importantes aparezcan en la lista de canales del usuario sin clics adicionales.