Channels
Channels conecta tu flujo con tu espacio de trabajo de Slack para gestionar canales y personas: ver la lista de canales, crear un canal público o privado, invitar a una persona a un canal y consultar el perfil de un usuario.
Es útil para organizar la comunicación de tu equipo de forma automática, por ejemplo abrir un canal para cada proyecto nuevo e invitar a quienes trabajarán en él.
Cuándo usarlo
- Crear un canal para cada proyecto, cliente o incidencia importante.
- Invitar a un empleado recién incorporado a los canales de su departamento.
- Obtener la lista de canales para que un agente elija dónde publicar.
- Consultar el perfil de una persona, como su cargo o su correo, antes de escribirle.
Configuración
Necesitas una credencial Slack bot API con el token de tu aplicación de Slack, que obtienes en el panel de aplicaciones de Slack. La aplicación tiene que tener permisos para gestionar canales y leer usuarios. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Slack bot API de tu aplicación. |
| Operation (obligatorio) | Lo que hace el componente. Ver Operaciones. Por defecto, Get Channels. |
| New Channel Name | Solo en Create Channel, donde es obligatorio. El nombre del canal nuevo, en minúsculas y sin espacios; los espacios se cambian por guiones. Solo admite letras sin acentos, números, guiones y guiones bajos. |
| Private Channel | Solo en Create Channel. Actívalo para crear un canal privado; si no, se crea público. |
| Channel Selection Method | En Channel Invite y Get Users Channel. Cómo indicas el canal: Manual ID muestra Channel ID para escribir su identificador; Channel List muestra Channel Name para elegirlo de una lista. Por defecto, Manual ID. |
| Channel ID | El identificador del canal, por ejemplo C123456. En Channel Invite, el canal al que invitas; en Get Users Channel, el canal cuyos miembros quieres. En Get Channels es opcional: si lo indicas, trae solo ese canal. |
| Channel Name | Con Channel List. El canal, elegido de la lista de canales de tu espacio de trabajo. La lista se carga al elegir la credencial. |
| User Name | En Channel Invite y Get Channel User Profile. La persona, por su nombre de usuario, su nombre completo o su identificador de Slack. |
Operaciones
| Operación | Qué hace |
|---|---|
Channel Invite | Invita a una persona a un canal. |
Create Channel | Crea un canal público o privado. |
Get Channels | Trae la lista de canales públicos y privados que puede ver tu aplicación, sin los archivados. |
Get Users Channel | Trae los miembros de un canal, un elemento por persona con su identificador (user_id) y su nombre de usuario (user_name). |
Get Channel User Profile | Trae el perfil de una persona: nombre, cargo, correo y otros datos que tenga en Slack. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Number of Results | Solo en Get Channels. Cuántos canales traer como máximo de cada tipo, públicos y privados. Por defecto, 4. |
Resultado
La salida Data devuelve los canales o el perfil con los que has trabajado. Cada canal trae su identificador (id), su nombre (name) y el resto de datos que da Slack, como si es privado o cuántos miembros tiene. Get Channel User Profile devuelve los datos del perfil de la persona.
Puedes usar el identificador del canal en Messages para publicar en él. El componente también se puede conectar a un Agente como herramienta. Ver Tool Mode.
Ejemplo
Una agencia de diseño abre un canal para cada proyecto que firma.
- El proyecto nuevo llega al flujo desde el CRM con el nombre del cliente y el usuario de Slack del jefe de proyecto.
- Añade Channels con la operación
Create Channely escribe en New Channel Nameproyecto-seguido del nombre del cliente. - Añade un segundo Channels con
Channel Invite, eliddel canal nuevo en Channel ID y el jefe de proyecto en User Name. - Termina con Messages para publicar en el canal un mensaje de bienvenida con los datos del proyecto.
Buenas prácticas
- Si filtras con Channel ID en
Get Channelsy el canal no aparece, aumenta Number of Results: el canal se busca entre los canales que se traen. - Para invitar a alguien a un canal privado, tu aplicación tiene que ser miembro de ese canal.
Componentes relacionados
- Messages: envía, programa y gestiona mensajes de Slack.