Slack Message

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai. Por favor, migra a los componentes alternativos recomendados.

Credencial

Este componente necesita una credencial de tipo Slack bot API.
Para usarlo sigue estos pasos:

1. Configura la credencial en la sección de credenciales de Nappai.

   • Ve a Credenciales → Agregar credencial → Slack bot API.
   • Introduce el Slack bot App token (ejemplo: <APP_OAUTH_TOKEN>).
   • Guarda la credencial.

2. Selecciona la credencial en el campo Credential del componente Slack Message.

Nota: La credencial no aparece como un campo de entrada en la lista de Input Fields; solo se selecciona en el panel de configuración del componente.

¿Cómo funciona?

El componente envía un mensaje a un canal de Slack usando la API de Slack.
Internamente:

1. Obtiene el token OAuth de la credencial seleccionada.
2. Lee el canal seleccionado en el campo Channel Name y el texto del mensaje en Input.
3. Si se adjunta un archivo (Media files), extrae el texto del archivo (si es un mensaje o datos) y lo incluye en el cuerpo del mensaje.
4. Crea una instancia de SlackWrapperApi con el token y llama a send_post para publicar el mensaje y, opcionalmente, subir la imagen.
5. Devuelve un objeto Message que contiene el texto enviado (y el texto del medio, si lo hubo).

Entradas

• Media files
  Tipo: HandleInput
  Descripción: Archivos multimedia que se subirán al canal. Si el medio es un mensaje o datos, su texto se incluirá en el mensaje final.

• Channel Name
  Tipo: DropdownInput (requerido)
  Descripción: Selecciona el canal de Slack donde se enviará el mensaje. El componente recupera la lista de canales disponibles usando la credencial.

• Input
  Tipo: MultilineInput (requerido)
  Descripción: Texto del mensaje que quieres enviar a Slack.

Salidas

• Slack Message
  Tipo: Message (método: send_message)
  Descripción: Contiene el texto que se envió a Slack, incluyendo el contenido del medio si se proporcionó.

Ejemplo de Uso

1. Añade el componente Slack Message al flujo de trabajo.
2. Selecciona la credencial Slack bot API que configuraste previamente.
3. Elige el canal de la lista desplegable Channel Name.
4. Escribe el mensaje en el campo Input (por ejemplo, “¡Hola equipo, el informe está listo!”).
5. (Opcional) Adjunta un archivo en Media files (por ejemplo, un PDF o una imagen).
6. Ejecuta el flujo.
7. El componente enviará el mensaje a Slack y devolverá un objeto Message con el contenido enviado, que puedes usar en pasos posteriores del flujo.

Componentes Relacionados

• Slack Bot API Credential – Configura el token OAuth necesario para autenticarte con Slack.
• Slack Channel List – (Si existe) Obtiene la lista de canales disponibles.

Consejos y Mejores Prácticas

• Usa canales privados solo cuando sea necesario; los mensajes públicos son más visibles.
• Limita el tamaño de los archivos adjuntos; Slack tiene límites de 1 GB por archivo.
• Prueba con un canal de prueba antes de enviar mensajes a canales de producción.
• Evita enviar información sensible directamente en el mensaje; utiliza enlaces seguros o archivos cifrados.

Consideraciones de Seguridad

• Protege tu token OAuth: no lo compartas públicamente y almacénalo en la sección de credenciales de Nappai.
• Revisa los permisos de tu Slack App; solo concede los scopes necesarios (por ejemplo, chat:write).
• Monitorea el uso de la API de Slack para detectar actividad inesperada.

---