Channel
Channel trabaja con los equipos y canales de Microsoft Teams: lista los equipos de los que formas parte, los canales de un equipo y los miembros de un canal, y crea canales nuevos.
Es útil para organizar Teams de forma automática, por ejemplo creando un canal por proyecto, y como paso previo de Channel Messages cuando un flujo necesita saber en qué canales puede publicar.
Cuándo usarlo
- Al abrir un proyecto quieres crear su canal en el equipo correspondiente.
- Un agente de IA tiene que saber qué canales existen en un equipo antes de publicar un aviso.
- Quieres obtener la lista de miembros de un canal para enviarles un resumen por correo.
- Necesitas una relación de los equipos de Teams de una cuenta.
Configuración
Necesitas una credencial Microsoft Teams, que se conecta iniciando sesión con tu cuenta de Microsoft. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Microsoft Teams con la que se accede a tus equipos. Al elegirla se cargan tus equipos y canales. |
| Operation (obligatorio) | Lo que hace el componente. Ver Operaciones. Por defecto, Get Teams. |
| Teams ID | El equipo con el que trabajas, elegido por su nombre. Al cambiarlo se recarga la lista de canales. En Get Teams Channels, Get Channel Members y Create Channel. |
| Channel ID | El canal, elegido por su nombre. Solo en Get Channel Members. |
| Channel Name | El nombre del canal nuevo. Solo en Create Channel. |
| Channel Description | La descripción del canal nuevo. Solo en Create Channel. |
| Channel Type | standard (visible para todo el equipo) o private (solo para las personas que se añadan). Por defecto, standard. Solo en Create Channel. |
Operaciones
| Operación | Qué hace |
|---|---|
Get Teams | Lista los equipos de los que formas parte, con su identificador, nombre y descripción. |
Get Teams Channels | Lista los canales de un equipo, con su identificador, nombre, descripción y tipo. |
Get Channel Members | Lista los miembros de un canal, con su nombre, correo y función. |
Create Channel | Crea un canal nuevo en el equipo. |
Resultado
La salida Data devuelve un elemento por cada equipo, canal o miembro encontrado, o un único elemento con el canal creado y su identificador.
Puedes conectar el resultado a Channel Messages para publicar en el canal, o a un componente de correo. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo consultar equipos o crear canales. Ver Tool Mode.
Ejemplo
Una consultora crea un canal de Teams para cada proyecto nuevo que firma.
- Cuando se firma un proyecto, el flujo recibe su nombre y una breve descripción.
- Añade Channel con la operación
Create Channely la credencial Microsoft Teams de la consultora. - En Teams ID elige el equipo
Proyectos, en Channel Name el nombre del proyecto y en Channel Description la descripción. - Conecta la salida Data a Channel Messages para publicar en el canal nuevo un mensaje de bienvenida.
Componentes relacionados
- Channel Messages: enviar y leer mensajes en canales.
- Chats: consultar tus chats y sus miembros.
- Teams Webhook: iniciar un flujo cuando ocurre algo en Teams.