Error al agregar pestaña de SharePoint en Teams: causas, solución y workaround

Si al anclar una carpeta de SharePoint como pestaña en un canal de Teams aparece “We couldn’t complete that action”, aquí tienes una guía clara para diagnosticar el problema y aplicar un workaround estable, además de buenas prácticas para evitar que se repita.

Índice

Resumen del problema

Al intentar agregar una pestaña de SharePoint en un canal de Teams (Canal → + → SharePoint → Any SharePoint site → pegar la URL de una carpeta → Guardar), Teams muestra el mensaje de error:

We couldn't complete that action

El comportamiento se reproduce incluso creando un canal nuevo. Otra persona del equipo también logró reproducirlo, por lo que no es un fallo aislado de perfil o caché. Todo apunta a un problema actual al anclar enlaces profundos a subcarpetas con la pestaña nativa SharePoint.

Diagnóstico en dos minutos

Lo que sí falla: Pestaña nativa SharePoint con URL que apunta a una subcarpeta de la biblioteca.
Lo que sí funciona: Pestaña Website (Sitio web) con la misma URL de la carpeta.
Reproducción cruzada: El error se observa en más de un usuario/cliente, lo que refuerza que no es un caso puntual.
Alcance: Suele afectar a URLs “complejas” (enlaces de uso compartido, con parámetros o formatos /:f:/, /?id=, etc.).

Por qué sucede (explicación breve y útil)

La pestaña nativa SharePoint de Teams está pensada para anclar sitios o bibliotecas y, en condiciones normales, también admite carpetas. Sin embargo, determinadas variantes de URL (por ejemplo, enlaces de “Compartir” con parámetros, deep links a vistas, o rutas con caracteres especiales) pueden provocar que la pestaña falle al validar o resolver la ruta, resultando en el error genérico “We couldn’t complete that action”.

Por contraste, la pestaña Website inserta la URL tal cual dentro de un iframe, sin aplicar la misma lógica de validación que la pestaña SharePoint, por eso suele funcionar de forma inmediata con las mismas direcciones.

Solución de trabajo recomendada (workaround estable)

Usa la pestaña Website para anclar la carpeta directamente. Pasos:

En el canal de Teams, haz clic en +.
Elige Website (Sitio web).
Asigna un nombre a la pestaña (por ejemplo, “Carpeta del proyecto”).
Pega la URL de la carpeta de SharePoint.
Selecciona Guardar.

Ventajas:

Funciona aunque la pestaña SharePoint falle.
Respeta permisos de SharePoint; quien no tiene acceso no verá el contenido.
No modifica la estructura del sitio ni requiere mover archivos.

Consideraciones:

El icono de la pestaña se mostrará como “sitio web”, no como SharePoint.
Si cambias la URL de la carpeta (por ejemplo, renombrando la carpeta), tendrás que actualizar el vínculo.

Alternativa práctica: pestaña “Biblioteca de documentos”

Otra opción es anclar la Biblioteca de documentos del sitio y navegar desde la pestaña hasta la subcarpeta deseada:

Haz clic en + en el canal.
Elige Document Library (Biblioteca de documentos).
Conecta el sitio de SharePoint del equipo (o pega su URL del sitio, no la de la carpeta).
Ancla la biblioteca correspondiente.

Esta vía rara vez abre directamente en la subcarpeta, pero permite llegar a ella sin salir de Teams.

Buenas prácticas para la URL

Para mejorar la compatibilidad (especialmente si planeas seguir usando la pestaña SharePoint cuando Microsoft publique una corrección), intenta trabajar con una URL limpia de carpeta. Pautas:

Evita usar el vínculo de “Compartir” que añade parámetros y códigos (por ejemplo, ?e=xyz&at=...).
Prefiere la ruta directa a la biblioteca y carpeta, por ejemplo:
https://contoso.sharepoint.com/sites/Proyecto/Shared%20Documents/Carpeta
Si la carpeta tiene espacios o caracteres especiales, asegúrate de que estén URL encoded (por ejemplo, espacio = %20).
Comprueba que la URL pertenece al mismo tenant que el equipo de Teams. Los enlaces entre tenants o con cuentas invitadas son más propensos a fallar en pestañas nativas.

Comprobaciones rápidas antes de culpar al cliente

Permisos: Verifica que todos los miembros del canal tengan acceso (al menos lectura) al sitio, a la biblioteca y a la carpeta.
Cliente y sesión: Prueba en Teams Web y en el cliente de escritorio. Si funciona en uno y no en otro, cierra sesión, reinicia y borra la caché del cliente problemático.
Políticas de Teams: Si eres admin, revisa que las políticas de permisos de aplicaciones no estén bloqueando la app de SharePoint o la pestaña Website.
Estado del sitio: Asegura que el sitio no esté en proceso de migración, renombrado o con cambios recientes de URL.

Cómo borrar la caché de Teams sin dolores

A menudo es suficiente con:

Cerrar sesión en Teams.
Abrir Configuración de Teams y usar la opción de borrar caché (si está disponible).
Reiniciar Teams e iniciar sesión de nuevo.

Notas:

En dispositivos administrados, algunas políticas MDM pueden impedir limpiar caché manualmente. En ese caso, coordina con TI.
Si usas más de una cuenta o perfiles, prueba también en una ventana de incógnito en Teams Web para descartar cookies/sesión.

Tabla de diagnóstico rápido

Síntoma	Probable causa	Qué hacer
“We couldn’t complete that action” al guardar pestaña SharePoint con URL de una carpeta.	Validación de deep link en pestaña SharePoint.	Usar pestaña Website con la misma URL (workaround).
Algunos usuarios ven la pestaña, otros no.	Permisos insuficientes o acceso de invitado.	Alinear permisos en sitio/biblioteca/carpeta; comprobar tenant.
Funciona en web, falla en escritorio (o viceversa).	Caché o sesión corrupta en un cliente.	Cerrar sesión, borrar caché, reiniciar el cliente.
URL muy larga con parámetros de “Compartir”.	Parámetros no soportados por la pestaña nativa.	Usar URL limpia o la pestaña Website.
Al anclar, pide credenciales en bucle.	Desajuste de identidad o cookie/SSO.	Probar sesión en Teams Web, borrar caché y volver a iniciar.

Pasos detallados: convertir un enlace “compartido” en una URL limpia

Si tu enlace luce así (ejemplo):

https://contoso.sharepoint.com/:f:/r/sites/Proyecto/Shared%20Documents/Carpeta?e=ABCD12&at=XYZ...

Intenta formar la ruta directa tomando la base del sitio y la ruta de biblioteca:

https://contoso.sharepoint.com/sites/Proyecto/Shared%20Documents/Carpeta

Consejos:

Navega por SharePoint hasta la carpeta, y revisa la barra de direcciones; muchas veces ahí verás la ruta “limpia”.
Evita terminar con /Forms/AllItems.aspx o parámetros de vista (?viewid=...) cuando ancles la carpeta.

Acciones adicionales recomendadas

Reportar el bug en el portal de comentarios de Microsoft Teams (ya fue reportado en el caso descrito). Cuantos más casos, más visibilidad y prioridad para la corrección.
Mantener el workaround Website mientras llega el fix.
Documentar internamente el procedimiento para que otros equipos no pierdan tiempo investigando.

Preguntas frecuentes (FAQ)

¿La pestaña Website es segura?

La pestaña Website no elude los permisos de SharePoint. Si un usuario no tiene acceso a la carpeta, no podrá verla; verá una página de acceso denegado o vacía según su contexto de autenticación.

¿Puedo seguir usando la pestaña SharePoint para bibliotecas completas?

Sí. Anclar la biblioteca completa suele funcionar. El problema aparece con mayor frecuencia al anclar directamente una subcarpeta mediante la pestaña SharePoint.

¿Qué pasa si renombro la carpeta?

Si la carpeta renombrada cambia la ruta, la pestaña (SharePoint o Website) apuntará a una URL inválida. Actualiza el vínculo en el canal.

¿Afecta a todos los clientes?

No necesariamente. Hay casos en que en Teams Web funciona y falla en el cliente de escritorio, o al revés. Por eso recomendamos probar en ambos y, si procede, limpiar caché.

Guía de comunicación a usuarios

Si eres el responsable del canal, puedes informar a tu equipo con este mensaje breve:

Nota: Hay un problema temporal al anclar carpetas de SharePoint con la pestaña nativa “SharePoint” en Teams. Como alternativa hemos agregado la carpeta con la pestaña “Website”, que funciona sin afectar permisos. Cuando Microsoft publique la corrección, volveremos a la pestaña nativa.

Para administradores y soporte

Políticas de aplicaciones: Verifica que la app SharePoint y las pestañas Website no estén bloqueadas por políticas.
Identidad/SSO: Si observas bucles de inicio de sesión, prueba una sesión limpia de Teams Web, revisa caché y asegúrate de que la cuenta principal coincide con el tenant del sitio.
Registro de evidencias: Si necesitas escalar, documenta: versión de Teams, sistema operativo, tipo de URL usada, hora del fallo, capturas del mensaje y si se reproduce en Web/escritorio.

Resumen ejecutivo

El error “We couldn’t complete that action” al anclar una carpeta con la pestaña SharePoint se reproduce en distintos usuarios y canales, por lo que apunta a un fallo actual con deep links.
El workaround estable es anclar la carpeta con la pestaña Website.
Como alternativa, ancla la Biblioteca de documentos y navega hasta la subcarpeta desde la pestaña.
Aplica verificaciones rápidas: URL limpia, permisos correctos, misma organización (tenant), prueba cruzada Web/escritorio y limpieza de caché.

Checklist rápido para tu caso

¿La URL es de carpeta y no un vínculo de compartir con parámetros?
¿Todos los miembros tienen al menos lectura en el sitio, biblioteca y carpeta?
¿El tenant de SharePoint coincide con el del equipo de Teams?
¿Probaste Website como pestaña y funcionó?
¿Probaste en Teams Web y en escritorio, y limpiaste la caché si uno falla?
¿Reportaste el caso en el canal de feedback de Teams para acelerar el fix?

Estado actual y expectativas

La pestaña Website permite continuar el trabajo sin fricción y con permisos intactos, mientras se espera una corrección en futuras actualizaciones de Teams. Recomendamos mantener este enfoque en equipos de proyecto, documentarlo en el onboarding y revisarlo periódicamente.

Conclusión: Si necesitas anclar hoy mismo una carpeta de SharePoint en un canal de Teams y te aparece “We couldn’t complete that action”, utiliza la pestaña Website. Es una solución simple, rápida y robusta hasta que la pestaña nativa SharePoint vuelva a manejar correctamente los enlaces profundos a carpetas.