Slack

• Tipo de canal: Texto (mensajería tipo chat).
• Visibilidad del canal: Privado (espacio de trabajo de Slack).
• Complejidad de integración: Media (requiere crear una app en Slack API, configurar OAuth y suscripción a eventos).
• Chat general o solo Kyubo: Chat general.
• Sandbox disponible: N/D.

Definición

El canal Slack permite una integración fluida entre la plataforma Lynn y un espacio de trabajo en Slack, habilitando la comunicación en tiempo real y la gestión de interacciones directamente desde esta herramienta de colaboración. Al configurar este canal, los mensajes enviados en Slack pueden ser recibidos y procesados por Lynn, y la plataforma puede responder automáticamente o a través de un agente. Es ideal para equipos que utilizan Slack como su medio principal de comunicación.

Requisitos previos

• Tener un espacio de trabajo en Slack (cuenta activa).
• Crear una nueva aplicación en Slack desde Slack API: Applications.

  1. Se puede agregar más de una aplicación al mismo espacio de trabajo.

  2. Aceptar los términos y condiciones del Marketplace de Slack.

     

  3. Al crear la aplicación, seleccionar "From scratch" (crearla desde cero, en lugar de usar un manifiesto).

     

  4. Ingresar los datos de la aplicación (nombre y espacio de trabajo).

     

     

  5. Copiar y resguardar (sin compartir con terceros) las credenciales generadas: Client ID, Client Secret, Signing Secret y Verification Token.

     

  6. Personalizar la información del bot/canal en Slack (descripción, imagen y, opcionalmente, descripción extendida).

     

Pasos para la creación del canal en Lynn

1. Iniciar sesión en Lynn.

2. Seleccionar "Diseñador" en el menú principal.

3. Clic derecho sobre el área libre del diseñador → menú contextual → "Configurar canal" → "Agregar canal a [Ambiente]".

   

4. Elegir Slack de la lista de canales disponibles y hacer clic en "Crear".

   

5. Completar los campos requeridos con los datos obtenidos desde la interfaz de configuración de la app en Slack (ver "Requisitos previos").

   

6. Hacer clic en "Verificar" para inicializar la validación de parámetros, y luego en "Crear". El sistema confirma la creación exitosa del canal.

7. Activar el canal: clic derecho sobre la burbuja del canal creado → "Activar". El canal cambia a estado blanco sólido, indicando que está activo.

8. Autorizar el canal: clic derecho sobre el canal → "Autorizar". Se abre en otra pestaña la interfaz web de la API de Slack solicitando permisos (si el usuario está autenticado).

   

   

9. Conceder los permisos haciendo clic en "Permitir".

Configuración adicional en Slack

Al crear el canal, Lynn suministra dos datos: la URL de redirección y la URL de suscripción. Deben transcribirse en la configuración de la app en Slack:

• URL de redirección: sección OAuth & Permissions → agregar las URLs proporcionadas por Lynn → guardar.

  

• URL de suscripción: sección Event Subscriptions → activar suscripciones a eventos → agregar la URL de suscripción entregada por Lynn → seleccionar los eventos que el bot debe escuchar.

  

Eventos de suscripción recomendados para el bot:

• member_joined_channel
• member_left_channel
• message.channels
• message.groups
• message.im
• message.mpim

Asegurarse de seleccionar el scope adecuado para cada evento (generalmente la primera opción mostrada) y guardar los cambios.

App Home

En la sección App Home, habilitar a los usuarios para el envío de mensajes:

1. Activar "Show tabs" y asegurar que la pestaña "Messages tab" esté visible.
2. Activar el botón correspondiente (verde).
3. Si la aplicación requiere comandos, verificar también esa opción (por defecto, los bots de Lynn no la requieren).

Instalar la aplicación en Slack

1. Abrir la sección "Install App" en el panel de configuración de la app.

2. Pulsar "Install App to [Workspace]".

3. Autorizar la app en el espacio de trabajo.