Message
Message conecta tu flujo con Discord a través de tu bot para trabajar con los mensajes de un canal: publicar un mensaje, con archivos adjuntos si quieres, leer los mensajes del canal o uno concreto, y eliminar un mensaje.
Es útil para mantener informada a una comunidad o a un equipo que se organiza en Discord, o para que un agente lea lo que se escribe en un canal y actúe.
Cuándo usarlo
- Anunciar en el canal de novedades de tu comunidad cada nuevo artículo o vídeo que publicas.
- Avisar en el canal del equipo técnico cuando falla un proceso.
- Leer los mensajes nuevos de un canal de soporte para que un agente prepare respuestas.
- Eliminar mensajes publicados por error por el 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. El bot tiene que estar añadido a tu servidor y tener permiso para ver y escribir en el canal. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Discord API de tu bot. |
| Operation (obligatorio) | Lo que hace el componente. Ver Operaciones. |
| Channel ID (obligatorio) | El identificador del canal de Discord. Lo copias en Discord con el botón derecho sobre el canal, con el modo desarrollador activado. |
| Content | Solo en Send Message. El texto del mensaje. |
| Attachments | Solo en Send Message. Archivos que se adjuntan al mensaje. Conéctalos desde un componente que entregue archivos o pasa su enlace. |
| Filter | Solo en Get Messages. All Messages trae los mensajes del canal; By ID trae un mensaje concreto. Por defecto, All Messages. |
| Message ID | El identificador del mensaje. Obligatorio en Delete Message y en Get Messages con By ID. |
| After ID | Solo en Get Messages con All Messages. Si indicas el identificador de un mensaje, trae solo los mensajes publicados después de él, del más antiguo al más reciente. Si lo dejas vacío, trae todo el historial del canal. |
Operaciones
| Operación | Qué hace |
|---|---|
Send Message | Publica un mensaje en el canal en nombre de tu bot. |
Get Messages | Trae los mensajes del canal o un mensaje concreto. |
Delete Message | Elimina un mensaje del canal. |
Resultado
La salida Data devuelve los mensajes con los que has trabajado: su identificador (id), el canal, el autor (author_username), si lo escribió un bot (is_bot), el texto (content) y la fecha. Send Message devuelve también los archivos adjuntos. Delete Message devuelve una confirmación.
Si Discord rechaza la operación, por ejemplo porque el bot no tiene permisos en el canal, el resultado trae status con el valor error y el motivo, en lugar de detener el flujo.
Puedes conectar el resultado a un agente para que lea y responda, o guardar el identificador del último mensaje para usarlo en After ID la próxima vez. El componente también se puede conectar a un Agente como herramienta. Ver Tool Mode.
Ejemplo
Una comunidad de jugadores quiere anunciar cada torneo nuevo.
- El alta del torneo llega al flujo con su nombre, fecha y enlace de inscripción.
- Añade Message con la operación
Send Message. - En Channel ID, pega el identificador del canal de anuncios.
- En Content, escribe
Nuevo torneo:seguido del nombre, la fecha y el enlace de inscripción.
Buenas prácticas
- Para leer solo lo nuevo, guarda el identificador del último mensaje leído y úsalo en After ID en la siguiente ejecución. Leer todo el historial de un canal muy activo tarda más.
- Comprueba en tu servidor de Discord que el rol del bot puede ver el canal, leer el historial y enviar mensajes.