Integración · Canales
Conectar Microsoft Teams a Igniten
Conecte Microsoft Teams para que su equipo le pregunte a Igniten en un chat o en un canal de Teams, sin salir de donde ya trabaja. Teams no se conecta por separado: usa el mismo registro de aplicación que Microsoft 365, dentro del directorio de su organización, y cada persona autoriza su propio acceso.
Si Microsoft 365 ya está conectado, el registro es el mismo: lo propio de Microsoft Teams son los permisos de abajo. La ficha de Microsoft 365 tiene el resto.
Qué lee Igniten, y qué no
Lee
- Mensajes de los chats y canales de Teams donde haya alguien que haya dado su consentimiento
- La transcripción de las reuniones de Teams programadas, si Teams la generó
No lee
- Nada que la persona que pregunta no pudiera ver en Teams
Cómo se conecta
6 pasos · ≈ 20 min
-
Crear el registro de la aplicación
Un App registration es la identidad de Igniten en su directorio. Single tenant.
entra.microsoft.com → Identity → Applications → App registrations → New registration- Elija «Single tenant»: la aplicación queda dentro de su directorio y ninguna otra organización la puede usar.
- El nombre es libre; lo van a ver sus administradores, no su equipo.
- Al terminar, la pantalla muestra el ID de la aplicación y el del directorio: esos dos son los que se pegan acá.
Salió bien si La aplicación aparece en «App registrations» y tiene sus dos identificadores.
-
Agregar los permisos de Microsoft Graph
Application permissions para leer, Delegated para lo que una persona consiente.
- Microsoft llama «permiso» a cada cosa que una aplicación puede hacer. Hay dos clases y hacen falta las dos. «Application permissions» (permisos de aplicación) los usa Igniten por su cuenta, sin que nadie inicie sesión: por eso alcanzan a TODA su organización y no a una persona. «Delegated permissions» (permisos delegados) sólo sirven cuando una persona inicia sesión, y nunca ven más que lo que esa persona ve.
- Para agregarlos: en el menú de la izquierda toque «API permissions», después «Add a permission», elija «Microsoft Graph» y arriba elija «Application permissions» o «Delegated permissions». Escriba el nombre del permiso en el buscador, tíldelo y toque «Add permissions».
- La ficha de esta integración tiene los nombres exactos de cada lista.
- Si quiere que Igniten lea los documentos de SharePoint de sus equipos, en «Application permissions» tilde también «Sites.Read.All». Ojo con lo que entrega: Microsoft le deja a Igniten leer TODOS los sitios de SharePoint de su organización. El límite lo pone Igniten, no Microsoft: sólo lee las bibliotecas de los equipos de las personas a las que les dio SharePoint en el panel, y a cada una le muestra sólo lo que SharePoint le deja ver.
- Si quiere que Igniten responda sobre las tareas de Planner y To Do, tilde también «Tasks.Read.All»: Microsoft deja leer las tareas de toda la organización, e Igniten le muestra a cada persona sólo las suyas.
- Si además quiere que pueda crear y completar tareas de Planner (siempre le pide confirmación antes), sume «Tasks.ReadWrite.All». Ojo: Microsoft le deja a Igniten escribir en CUALQUIER plan de la organización. El límite lo pone Igniten: sólo crea tareas a nombre de quien lo pide, en planes de equipos de los que esa persona es miembro, y sólo completa tareas asignadas a ella. Nunca borra.
- Lo que no tilde no se lee. Si agrega un permiso más adelante, vuelva a tocar «Grant admin consent» (el paso 3): sin eso el permiso nuevo no vale.
Salió bien si Los permisos figuran en la tabla, todavía con el aviso de que falta el consentimiento.
-
Dar el consentimiento del administrador
Grant admin consent. Sin esto el token sale vacío y nada entra.
- «Grant admin consent» quiere decir «el administrador aprueba estos permisos en nombre de toda la organización». Lo tiene que tocar alguien con el rol de administrador global o de administrador de aplicaciones de Microsoft 365; si no lo ve habilitado, pídaselo a esa persona.
- Dónde está: en la misma pantalla «API permissions», arriba de la tabla, es un solo botón: «Grant admin consent for <su organización>». Tóquelo y confirme con «Yes».
- Microsoft lo exige desde octubre de 2025 para leer contenido de Teams.
- Con el consentimiento dado, su gente ve una pantalla de inicio de sesión normal y no la lista de permisos.
Salió bien si Cada permiso de la tabla queda con el tilde verde de concedido.
-
Crear el secreto y cargarlo
Certificates & secrets → New client secret. Se carga acá y no vuelve a salir.
- El valor del secreto se muestra UNA sola vez: cópielo antes de salir de esa pantalla.
- Copie el valor («Value»), no el identificador del secreto.
- Anote la fecha de vencimiento que eligió; acá se puede cargar para avisarle antes.
Salió bien si El panel confirma la carga y muestra sólo los últimos cuatro caracteres.
-
Probar que anda
Pedimos un token y leemos qué permisos Application quedaron otorgados. No guardamos nada.
- Pedimos un token y leemos qué permisos quedaron otorgados de verdad.
- Si falta alguno, le decimos cuál y qué deja de andar sin él.
- No se guarda nada de lo que devuelva la prueba.
Salió bien si La prueba dice «anduvo» y no nombra ningún permiso faltante.
-
Transcripciones de Teams
Teams no entrega la transcripción hasta que un administrador prende dos interruptores. Sin eso, Igniten entra al directorio y no ve ninguna reunión.
-
Install-Module MicrosoftTeams -
Connect-MicrosoftTeams - New-CsApplicationAccessPolicy -Identity "Igniten-Transcripciones" -AppIds "<client-id>" -Description "Permite a Igniten leer transcripciones de Teams"
- Grant-CsApplicationAccessPolicy -PolicyName "Igniten-Transcripciones" -Identity "<persona>"
- Set-CsTeamsMeetingConfiguration -EnableGraphTranscriptAccess $true
- Hace falta un administrador de Teams (no alcanza el de aplicaciones). La transcripción de cada reunión tiene que estar prendida en Teams: si nadie la grabó, no hay texto y no inventamos uno.
- Abra PowerShell e instale el módulo, una sola vez: Install-Module MicrosoftTeams. Esa línea baja el programa con el que se le habla a Teams.
- Connect-MicrosoftTeams abre el inicio de sesión de Microsoft. Entre con la cuenta de administrador de Teams. Si la ventana no aparece, la política no se crea.
- New-CsApplicationAccessPolicy crea una política con nombre Igniten-Transcripciones y le anota el ID de la aplicación de Igniten (el mismo client id del paso 1). Sin esta política, Graph contesta «No application access policy found for this app».
- Grant-CsApplicationAccessPolicy -Identity <persona> se la aplica sólo a esa persona. Reemplace <persona> por el correo de quien conectó calendario y reuniones y repita esa línea para cada persona conectada. -Global es opcional: autoriza a toda la organización y sólo se usa si el administrador decide ese alcance. Puede tardar horas, a veces hasta dos días, en propagarse. No es un fallo de Igniten.
- Set-CsTeamsMeetingConfiguration -EnableGraphTranscriptAccess $true prende, en el inquilino, que Graph pueda leer transcripciones. El mismo interruptor está en el centro de administración de Teams: Reuniones, Configuración de reuniones, acceso de la API de transcripciones. Sin eso, Graph contesta que el acceso está apagado y no reintentamos hasta que se prenda.
- Esto cubre reuniones programadas cuyo organizador es alguien con calendario y reuniones concedidos. Las reuniones de un canal no entran por esta vía.
Salió bien si Los cinco comandos terminan sin un mensaje en rojo. La primera transcripción puede tardar horas en aparecer: la política no se aplica al instante.
-
Qué permisos pide
| Permiso | Para qué | Cuándo hace falta |
|---|---|---|
https://graph.microsoft.com/ChatMember.Read.All | Saber quién está en cada conversación de Teams | Si conecta Teams |
https://graph.microsoft.com/TeamMember.Read.All | Saber quién está en cada equipo de Teams | Si conecta Teams |
https://graph.microsoft.com/ChannelMember.Read.All | Saber quién está en cada canal de Teams | Si conecta Teams |
https://graph.microsoft.com/Team.ReadBasic.All | Responder sobre los equipos de Teams | Si conecta Teams |
https://graph.microsoft.com/Channel.ReadBasic.All | Responder sobre los canales de Teams | Si conecta Teams |
https://graph.microsoft.com/OnlineMeetingTranscript.Read.All | Leer la transcripción de una reunión de Teams | Si conecta las transcripciones de reuniones de Teams |
https://graph.microsoft.com/OnlineMeetings.Read.All | Saber de qué reunión es esa transcripción y quién estuvo | Si conecta las transcripciones de reuniones de Teams |
https://graph.microsoft.com/Chat.Read | Responder sobre sus conversaciones de Teams | Siempre |
https://graph.microsoft.com/ChannelMessage.Read.All | Responder sobre lo que se escribe en los canales | Siempre |
https://graph.microsoft.com/Chat.Create | Abrir una conversación de Teams en su nombre | Siempre |
https://graph.microsoft.com/ChatMessage.Send | Escribir un mensaje de Teams en su nombre | Siempre |
https://graph.microsoft.com/ChannelMessage.Send | Publicar en un canal de Teams en su nombre | Si Igniten publica en canales de Teams |
Los dos niveles de permiso que recomendamos, y qué habilita cada uno, están en Permisos recomendados.
Qué puede salir mal
- El token sale bien pero no entra ningún mensaje
-
Por qué Falta el consentimiento del administrador. Desde octubre de 2025 Microsoft lo exige para leer contenido de Teams.
Qué hacer En el registro de la aplicación, «Grant admin consent». Con eso dado, cada persona ve sólo una pantalla de inicio de sesión, no la lista de permisos.
- Entra acepta los permisos y aún así no entra ninguna transcripción
-
Por qué Falta la política de acceso de la aplicación, o el inquilino tiene apagado el acceso de Graph a las transcripciones. Las dos cosas las prende un administrador de Teams, no el de aplicaciones.
Qué hacer Siga el paso «Transcripciones de Teams»: son cinco líneas de PowerShell, explicadas una por una. Pueden tardar horas en hacer efecto.
Preguntas frecuentes
¿Igniten puede escribir en Teams?
Sólo con el nivel que habilita acciones, y siempre con el permiso que esa persona autorizó para su propia cuenta. Toda escritura se confirma antes de salir.