Slack

Con la app de Kadu instalada en Slack, conversas con el agente en un hilo: le pides listar Tasks, ejecutar una de ellas, seguir el avance, cancelar o pedir un ajuste. Estado, pendientes, resultado y archivos de cada ejecución llegan al mismo hilo.

Instalar

En Configuración → Slack, haz clic en Instalar en Slack y autoriza la app en el workspace. Una organización puede tener más de un workspace instalado. Un workspace de Slack queda vinculado a una sola organización.

Quien instala directo desde Slack, sin pasar por la consola, recibe del bot un mensaje directo con el botón Conectar Cuenta Kobana. El inicio de sesión vincula Slack a la organización activa de tu cuenta (tu rol debe permitir editar la organización). Quien aún no tiene organización en Kadu va al registro. Una instalación que no se vincula a ninguna organización en 14 días se quita.

Conectar la Cuenta Kobana

Todo usuario del bot usa su propia Cuenta Kobana. En el primer mensaje, el bot te responde solo a ti con el botón Conectar Cuenta Kobana: inicia sesión y vuelve a Slack, y el bot sigue con tu pedido.

• La conexión dura 7 días. Después, el bot pide iniciar sesión de nuevo. El último día, avisa en el primer mensaje que envíes.
• El acceso es el de tu rol en la organización, el mismo de la consola. Sin invitación a la organización, el bot no responde.
• Para desconectar, escribe desconectar al bot.
• Si te quitan de la organización o te desactivan en Slack, la conexión cae sola.

Ejecutar una Task

Pide en lenguaje natural: "ejecuta la conciliación de pagos de ayer en el entorno Producción". El bot revisa la Task y los parámetros y publica una tarjeta de confirmación con Task, entorno, fecha de referencia, parámetros y secrets faltantes. Nada se ejecuta hasta que alguien haga clic en Ejecutar. La tarjeta vale 15 minutos.

Puede confirmar quien pidió u otro miembro con permiso para ejecutar. Si la conexión de quien hizo clic venció, el clic no vale: inicia sesión y confirma de nuevo.

Cancelar una ejecución y pedir un ajuste en una Task conversacional también pasan por tarjeta.

Archivos de entrada

Una Task que recibe archivos (planilla, extracto, PDF) usa los adjuntos del propio hilo: adjunta el archivo en la conversación y pide la ejecución. La tarjeta muestra los archivos que van con ella.

• Adjuntos de hasta 100 MB. Un enlace externo (Google Drive, por ejemplo) no cuenta: adjunta el archivo en sí.
• Solo entran archivos adjuntados en el mismo hilo y aún no usados por otra ejecución. Cada archivo va a una sola ejecución, como en la consola.
• El adjunto se guarda solo después de conectar tu Cuenta Kobana. Si adjuntas antes de conectar, el bot lo guarda después de la conexión.

Qué aparece en el hilo

Mensaje	Cuándo
Estado	un mensaje fijo, editado con el paso actual, el tiempo transcurrido y los pendientes abiertos
Hitos	paso completado, aviso y error, cada uno en un mensaje
Pendiente	cada pendiente nuevo, con el botón Resolver
Resultado	al final: estado, resumen, duración y precio
Archivos	los archivos de salida, como enlace a la consola o adjuntos (ver abajo)

La ejecución sigue aunque tu conexión venza a mitad de camino: estado, resultado y archivos siguen llegando.

Pedir ajuste

En una Task conversacional, responde en el hilo después de que termine la ejecución: "rehazlo considerando solo los boletos". El bot publica la tarjeta de ajuste; una vez confirmada, la nueva ronda sigue en el mismo hilo.

Configurar

Cada workspace instalado tiene tres ajustes en Configuración → Slack:

Ajuste	Predeterminado	Qué hace
Dónde responde el bot	mensaje directo y canal privado	también conversa en grupos, canales públicos y canales compartidos con otra empresa (Slack Connect)
Archivos de salida	solo enlace a la consola	adjunta en el hilo hasta el tamaño máximo (hasta 100 MB); por encima, enlace
Detalle en el hilo	solo hitos	también un resumen de los logs de la ejecución

Los canales públicos y Slack Connect exponen resultados y archivos a más personas: actívalos solo si la organización lo decidió. En un canal compartido, las personas de otra empresa nunca usan el bot, aunque tengan Cuenta Kobana.

Una Task puede fijar el modo de archivos en el Playbook, en metadata.slack.files_mode (link o upload) del bloque task:.

En un canal, menciona al bot (@Kadu) para empezar. En el hilo donde ya publicó una tarjeta o una ejecución, no hace falta mencionarlo de nuevo.

Consumo

Cada mensaje respondido se mide y se cobra como una ejecución: tokens × precio del nivel de las conversaciones, en el mismo consumo del mes, la misma franquicia de créditos y el mismo tope. Sin plan, franquicia ni saldo, el bot avisa y no responde. Cada conversación tiene un límite de gasto y cada persona puede enviar hasta 20 mensajes por minuto. Ver Plan y costos.

Quitar

Quitar en Configuración → Slack revoca la app en el workspace: el bot deja de responder y se deshacen las conexiones de cuenta. Desinstalar desde el propio Slack tiene el mismo efecto.

La misma configuración está en la API: GET, PATCH y DELETE en /v1/organizations/{id}/slack_installations.