Saltearse al contenido
Nappai Documentation

Slack Channel Reader

⚠️ 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.

¿Cómo funciona?

El componente se conecta a la API de Slack con un token de OAuth de una aplicación. Cuando lo arrastras al dashboard, simplemente introduces el nombre del canal y seleccionas la credencial que contiene el token. Internamente, el componente:

  1. Obtiene el ID del canal a partir de su nombre.
  2. Recupera la lista de miembros del canal para poder reemplazar los identificadores de usuario (<@U12345>) por sus nombres reales.
  3. Llama a conversations_history para descargar todos los mensajes del canal desde el momento más reciente que se haya leído (por defecto, desde el principio).
  4. Devuelve cada mensaje como un objeto Data con la clave del nombre del autor y el texto del mensaje.

Credencial

Para usar este componente necesitas una credencial de tipo Slack bot API:

  1. Ve a Slack API y crea o selecciona una aplicación.
  2. Copia el Slack bot App token (ejemplo: xoxb-1234567890-abcdefghijklmnop).
  3. En la sección de credenciales de Nappai, crea una nueva credencial llamada, por ejemplo, SlackBot.
  4. En el componente, elige esa credencial en el campo Credential.

Entradas

  • Channel Name: Especifica el nombre del canal de Slack del que quieres leer los mensajes. Este valor es obligatorio.

Salidas

  • Slack Message List: Devuelve una lista de objetos Data. Cada objeto contiene el nombre del autor como clave y el texto del mensaje como valor. Puedes usar esta salida para alimentar otros componentes, como filtros o visualizaciones.

Ejemplo de Uso

  1. Arrastra el componente Slack Channel Reader al flujo.
  2. Selecciona la credencial SlackBot en el campo Credential.
  3. Escribe general en el campo Channel Name.
  4. Conecta la salida Slack Message List a un componente de visualización (por ejemplo, un gráfico de barras que muestre la cantidad de mensajes por autor).

Componentes Relacionados

  • Slack Channel Writer – Envía mensajes a un canal de Slack.
  • Slack User Info – Obtiene información de usuarios de Slack.

Consejos y Mejores Prácticas

  • Mantén tu token seguro: No lo compartas públicamente y revísalo regularmente.
  • Limita el alcance: Usa el mínimo de scopes necesarios (channels:history, users:read) para reducir riesgos.
  • Controla la frecuencia: Si lees mensajes con frecuencia, considera usar la opción last_read_time para evitar descargar todo el historial cada vez.

Consideraciones de Seguridad

  • Asegúrate de que la credencial esté asignada solo a usuarios que necesiten acceder a los mensajes de Slack.
  • Revisa los permisos de la aplicación en Slack para garantizar que no tenga más acceso del necesario.