Slack es una plataforma de comunicación empresarial que permite a los equipos colaborar y trabajar a distancia.
Table of Contents
📌 ¿Qué es este módulo?
Este módulo permite conectar Saturn Studio con Slack, una plataforma de comunicación empresarial que facilita la colaboración remota entre equipos. A través de esta integración, es posible enviar mensajes, recibir notificaciones, administrar archivos, listar hilos y automatizar tareas directamente desde los canales de Slack.
📚 Descripción de los comandos
📄 Subscribe to Webhook
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| (sin parámetros definidos) | La suscripción se realiza directamente en Slack. |
Permite registrar un webhook de Slack para recibir eventos automáticos.
📄 Wait for Message
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Slack para recibir mensajes. | credential |
| Simplificar datos | Indica si los datos del mensaje deben simplificarse. | true |
| Asignar resultado a variable | Variable donde se almacenará el mensaje recibido. | {var} |
Espera un mensaje del usuario o canal y lo guarda para usarlo en el flujo.
📄 Get Messages
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Slack para acceder a los mensajes. | credential |
| Tipo de canal | Canal directo o público. | Direct Message |
| Canal público | Canal desde el cual se listarán mensajes. | social-media |
| Usuario | Usuario del cual se recuperarán mensajes. | bot-test |
| Límite | Número máximo de mensajes a obtener. | 10 |
| Asignar resultado a variable | Variable donde se almacenará la lista. | {var} |
Obtiene los mensajes de un canal público o conversación directa.
📄 List Thread
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Slack para acceder al hilo. | credential |
| Canal público | Canal en el que se encuentra el hilo. | social-media |
| ID del mensaje padre | Timestamp del mensaje principal del hilo. | 1734441439.169749 |
| Límite | Número de respuestas a listar. | 10 |
| Asignar resultado a variable | Variable donde se almacenarán los mensajes. | {var} |
Lista las respuestas de un hilo a partir de un mensaje principal.
📄 Create a Message
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Slack para enviar el mensaje. | credential |
| Tipo de canal | Canal directo o público. | Channel |
| Canal | Canal donde se enviará el mensaje. | social-media |
| Usuario | Usuario al que se enviará (en caso de mensaje directo). | bot-test |
| Mensaje | Contenido del mensaje. | Hello world |
| Asignar resultado a variable | Variable donde se almacenará la respuesta. | {var} |
Envía un mensaje a un canal público o conversación directa.
📄 Delete a Message
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Slack para eliminar mensajes. | credential |
| Canal público | Canal del cual se eliminará el mensaje. | social-media |
| ID del mensaje padre | Timestamp del mensaje a eliminar. | 1734441439.169749 |
| Asignar resultado a variable | Variable donde se almacenará la confirmación. | {var} |
Elimina un mensaje de un canal público usando su timestamp.
📄 Upload a File
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Slack para subir archivos. | credential |
| Tipo de canal | Canal directo o público. | Channel |
| Canal | Canal donde se subirá el archivo. | social-media |
| Usuario | Usuario destinatario si se trata de un mensaje directo. | bot-test |
| Archivo | Archivo a subir. | Documento.pdf |
| Mensaje | Mensaje que acompañará el archivo. | Aquí está el archivo |
| Asignar resultado a variable | Variable donde se almacenará el resultado. | {var} |
Sube un archivo y opcionalmente envía un mensaje acompañado.
📄 List Files
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Slack para listar archivos. | credential |
| Tipo de archivo | Tipo de archivos a listar. | Images, PDFs |
| Tipo de canal | Canal directo o público. | Channel |
| Canal público | Canal donde se buscarán los archivos. | social-media |
| Usuario | Usuario relacionado con los archivos. | bot-test |
| Límite | Cantidad máxima de archivos a mostrar. | 10 |
| Asignar resultado a variable | Variable donde se almacenará el resultado. | {var} |
Lista los archivos compartidos en un canal o conversación.
📄 Get a File
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Slack para obtener el archivo. | credential |
| ID del archivo | ID del archivo a obtener. | F085ERCF6JY |
| Asignar resultado a variable | Variable donde se almacenará el archivo. | {var} |
Obtiene la información detallada de un archivo por su ID.
📄 Download a File
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| Credencial | Credencial de Slack para descargar archivos. | credential |
| URL de descarga privada | Enlace de descarga directa del archivo. | https://files.slack.com/files-pri/… |
| Asignar resultado a variable | Variable donde se almacenará el archivo descargado. | [{ “filename”: “document.docx”, … }] |
Descarga un archivo desde una URL privada proporcionada por Slack.
🧪 Ejemplos de uso
- Create a Message: Enviar un mensaje automático a un canal de soporte con el resultado de un proceso.
- Upload a File: Subir un reporte generado en PDF al canal de marketing con un comentario.
- Get Messages: Leer los últimos 10 mensajes de un canal específico para análisis.
🧩 Requisitos
- Tener una credencial válida de Slack configurada en Saturn Studio.
- Tener acceso a los canales, usuarios o archivos con permisos suficientes.
- Verificar el formato correcto de timestamp para hilos y mensajes.
- Asegurarse de que las URLs privadas de descarga estén activas y accesibles al momento de la solicitud.