Channel
Channel conecta tu flujo con Discord a través de tu bot para gestionar canales: ver los servidores en los que está tu bot, consultar los canales de un servidor o uno concreto, crear un canal nuevo y eliminar un canal.
Es útil para organizar un servidor de forma automática, por ejemplo abrir un canal para cada proyecto, evento o cliente, y cerrarlo cuando termina.
Cuándo usarlo
- Crear un canal de texto para cada cliente nuevo de tu servicio de soporte.
- Abrir un canal de voz para cada evento de tu comunidad.
- Obtener la lista de canales de un servidor para que un agente elija dónde publicar.
- Eliminar los canales de proyectos ya cerrados.
- Saber en qué servidores está instalado tu bot.
Configuración
Necesitas una credencial Discord API con el Public Key, el Application ID y el Bot Token de tu aplicación, que encuentras en el Discord Developer Portal. Para crear y eliminar canales, el bot necesita el permiso de gestionar canales en el servidor. Consulta Credenciales.
En Discord, los servidores se llaman también guilds: por eso los campos hablan de Guild ID.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Discord API de tu bot. |
| Operation (obligatorio) | Lo que hace el componente. Ver Operaciones. |
| Guild ID | El identificador del servidor de Discord. Obligatorio en Create Channels y en Get Channels con By Guild. Lo encuentras en el resultado de Get Guilds. |
| Filter | Solo en Get Channels. By Guild trae los canales de un servidor; By ID trae un canal concreto. Por defecto, By Guild. |
| Channel ID | El identificador del canal. Obligatorio en Delete Channels y en Get Channels con By ID. |
| Top | Solo en Get Channels con By Guild. Cuántos canales traer como máximo. Por defecto, 10. |
| Filter Type | Solo en Get Channels con By Guild. Trae solo los canales de un tipo, indicado con su número: 0 para texto, 2 para voz, 4 para categorías y 15 para foros de hilos. |
| Mode | Solo en Create Channels. Cómo indicas el canal nuevo. Data Entry (Single Channel) muestra Item para recibirlo de otro componente; Manual Entry (Single Channel) muestra Name y Type para escribirlo a mano. Por defecto, Data Entry (Single Channel). |
| Item | Con Data Entry (Single Channel). Los datos del canal, con su nombre en name, su tipo en type (el mismo número que en Filter Type) y, si quieres, ajustes de Discord en options, como el tema del canal en topic. |
| Name | Con Manual Entry (Single Channel). El nombre del canal nuevo. |
| Type | Con Manual Entry (Single Channel). El tipo de canal: 0 : Text channel, 2 : Voice channel, 4 : Channels Container (una categoría que agrupa canales) o 15 : Threads channel (un foro de hilos). Por defecto, 0 : Text channel. |
Operaciones
| Operación | Qué hace |
|---|---|
Create Channels | Crea un canal en el servidor indicado. |
Delete Channels | Elimina un canal. |
Get Channels | Trae los canales de un servidor o un canal concreto. |
Get Guilds | Trae los servidores en los que está tu bot. |
Resultado
La salida Data devuelve los canales o servidores con los que has trabajado. Cada canal trae su identificador (id), nombre, tipo, servidor (guild_id), categoría en la que está (parent_id), tema (topic) y posición. Cada servidor trae su identificador (id) y su nombre. Delete Channels devuelve una confirmación.
Si Discord rechaza la operación, por ejemplo porque el bot no tiene permisos, el resultado trae status con el valor error y el motivo, en lugar de detener el flujo.
Puedes usar el identificador del canal en Message para publicar en él. El componente también se puede conectar a un Agente como herramienta. Ver Tool Mode.
Ejemplo
Una empresa de soporte técnico abre un canal de seguimiento para cada cliente nuevo.
- El alta del cliente llega al flujo con el nombre de la empresa.
- Añade Channel con la operación
Create Channelsy Mode enManual Entry (Single Channel). - En Guild ID, pega el identificador de tu servidor; en Name, el nombre del cliente; deja Type en
0 : Text channel. - Conecta el resultado a Message para publicar un mensaje de bienvenida en el canal nuevo, usando su
id.
Buenas prácticas
- Eliminar un canal borra también todos sus mensajes. Comprueba el Channel ID antes de ejecutar
Delete Channels. - Discord admite en los nombres de canales de texto solo minúsculas, números y guiones. Si escribes otros caracteres, Discord los adapta.