SlackToolkit

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

SlackToolkit es una herramienta que te permite conectar tu dashboard con Slack sin necesidad de escribir código. Con ella puedes enviar mensajes, subir archivos y realizar otras acciones directamente desde Nappai.

¿Cómo funciona?

El componente utiliza la librería oficial de Slack (slack_sdk) para crear un cliente con tu token OAuth. Cuando lo arrastras al flujo, el método get_slack_tools devuelve un objeto BaseToolkit que contiene todas las funciones disponibles para interactuar con Slack. No necesitas preocuparte por la autenticación; simplemente selecciona la credencial que ya has configurado y el componente se encargará de la conexión.

Entradas

Antes de usar el componente, asegúrate de haber configurado una credencial de tipo Slack bot API en la sección de credenciales de Nappai. Luego, selecciona esa credencial en el campo Credential del componente.

Campos de Entrada

• description: Texto descriptivo que ayuda a identificar el propósito del toolkit.
  Ejemplo: “Toolkit for Slack operations”

Salidas

• BaseToolkit: Un objeto BaseToolkit que contiene las herramientas listas para usar con Slack. Puedes conectar esta salida a otros componentes que requieran interacción con Slack.

Ejemplo de Uso

1. Configura la credencial: Ve a la sección de credenciales de Nappai y crea una credencial de tipo Slack bot API con tu token OAuth.
2. Arrastra el componente SlackToolkit al flujo.
3. Selecciona la credencial en el campo Credential.
4. Conecta la salida BaseToolkit a un componente que envíe un mensaje, por ejemplo, SlackSendMessage.
5. Ejecuta el flujo y verifica que el mensaje aparezca en el canal de Slack que hayas especificado.

Componentes Relacionados

• SlackSendMessage – Envía un mensaje a un canal o usuario de Slack.
• SlackUploadFile – Sube archivos a Slack.
• SlackListChannels – Obtiene la lista de canales disponibles.

Consejos y Mejores Prácticas

• Configura la credencial primero: Asegúrate de que el token OAuth sea válido y tenga los permisos necesarios.
• Prueba en un canal de prueba: Evita enviar mensajes de prueba a canales de producción.
• Revisa los límites de la API: Slack impone límites de tasa; si tu flujo envía muchos mensajes, considera agregar lógica de espera.
• Mantén el token seguro: No compartas el token OAuth en el código ni en archivos públicos.

Consideraciones de Seguridad

• El token OAuth debe mantenerse confidencial. No lo incluyas en logs ni en archivos de configuración que puedan ser accedidos por terceros.
• Utiliza credenciales con el menor conjunto de permisos necesario para la tarea.
• Si el token se ve comprometido, revoca inmediatamente la aplicación en el panel de Slack y genera un nuevo token.