Table of Contents

Configuración del canal Slack

A continuación se describen los pasos necesarios para configurar el canal Slack y conectarlo con Lynn. A través de esta integración, es posible habilitar la recepción y el envío de mensajes entre un espacio de trabajo de Slack y la plataforma Lynn, permitiendo gestionar interacciones directamente desde esta herramienta de colaboración. La configuración incluye ajustes tanto en Slack como en la plataforma de administración de canales de Lynn.

Requisitos previos

  • Tener un espacio de trabajo en Slack (es necesario contar con una cuenta activa).

  • Crear una nueva aplicación en Slack desde Slack API: Applications | Slack.

    1. Puedes agregar más de una aplicación al mismo espacio de trabajo si lo necesitas.
    2. Acepta los términos y condiciones del Marketplace de Slack.

    Crear aplicación en espacio de trabajo de slack

    1. Al solicitar una nueva aplicación, puedes crearla desde cero o usar un manifiesto de configuración.

    En este caso, seleccionaremos la opción From scratch para crearla desde cero:

    seleccionar tipo de aplicación a configurar: from manifest o from scratch

    Ingresa los datos de la aplicación:

    formulario para establecer nombre de la aplicación y seleccionar espacio de trabajo en Slack formulario para establecer nombre de la aplicación y seleccionar espacio de trabajo en Slack

    1. Una vez creada, se mostrará la interfaz con las credenciales de la aplicación. Copia los siguientes datos (no los compartas con terceros):
    • Client ID
    • Client Secret
    • Signing Secret
    • Verification Token

    muestra los campos que contiene client id, client secret, verification token

    1. Personaliza la información de tu bot o canal en Slack. En la misma interfaz, desplázate hacia abajo y completa los campos de descripción, imagen y (opcional) una descripción extendida.

    campos para completar la información del Marketplace de Slack

Pasos para la creacion del canal

  1. Inicia sesión en Lynn.
  2. Seleccionar la opción Diseñador desde el menú principal de Lynn.
  3. Hacer clic derecho sobre el área libre del diseñador.

menú contextual para agregar canal a diseñador Lynn

Se mostrará un menú contextual.

  1. Seleccionar Configurar canal y luego Agregar canal a [Ambiente].
  2. Elegir Slack de la lista de canales disponibles en Lynn.

lista de canales en Lynn

  1. Hacer clic en Crear.

Se mostrará una ventana con los campos requeridos para configurar el canal.

campos de configuración del canal

campos de configuración del canal

Para completar esta información, copia los datos obtenidos desde la interfaz de configuración de la app en Slack y pégalos en el configurador de canales de Lynn. Consulta la sección Requisitos previos para más detalles.

  1. Hacer clic en el botón Verificar para inicializar el proceso de validación de parámetros. Luego, pulsa Crear.

El sistema mostrará un mensaje emergente confirmando la creación exitosa del canal.

  1. Activar el canal: haz clic derecho sobre la burbuja del canal creado. Se mostrará un menú contextual. Selecciona Activar. El canal cambiará a un estado blanco sólido, indicando que está activo.

  2. Autoriza el canal: una vez que el canal haya sido activado, haz clic derecho sobre el canal para volver a acceder al menú contextual vinculado al canal. Selecciona la opción Autorizar.

opciones del menú contextual vinculado al canal Slack

Serás redirigido en otra pestaña hacia la interfaz web de la API de Slack. Si estás autenticado, se mostrará la solicitud de permisos.

Pantalla de solicitud de permisos de slack

  1. Si estás de acuerdo en conceder los permisos, haz clic en el botón Permitir.

Configuración adicional en Slack

  1. Al crear el canal en Lynn, este suministra dos datos importantes: la URL de redirección y la URL de suscripción. Copia estos valores y transcríbelos en la interfaz de configuración de tu aplicación en Slack.

    Url de redirección y de consulta de eventos

    Para agregar la URL de redirección:

    • Accede a la sección OAuth & Permissions dentro del panel de configuración de la app en Slack.

    • Agrega las URLs proporcionadas por Lynn en los campos correspondientes.

    • Guarda los cambios.

      Campos en Slack Api para establecer las url de redirección

    Para configurar la URL de suscripción:

    • Ir a la sección Event Subscriptions.

    • Activar las suscripciones a eventos.

    • Agregar la URL de suscripción entregada por Lynn en el campo correspondiente.

    • Selecciona los eventos que deseas que tu bot escuche.

      Eventos de suscripción recomendados para el bot:

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

      sección Event Subscriptions

    • Asegrarse de seleccionar el scope adecuado para cada evento (generalmente la primera opción que se muestra).

    • Guarda los cambios.

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

    1. Activa la opción Show tabs y asegúrate de que la pestaña Messages tab esté visible.
    2. Desliza el botón de encendido a color verde para habilitarla.
    3. Si tu aplicación requiere el uso de comandos, verifica también la opción correspondiente. (Por defecto, los bots de Lynn no requieren esta funcionalidad).

  3. Instalar la aplicación en Slack

    En el panel de configuración de tu app en Slack:

    1. Abrir la sección Install App.
    2. Pulsar el botón Install App to [Workspace] para instalar la aplicación en tu espacio de trabajo.
    3. Autorice la app en su escritorio de trabajo.

    Instalar aplicación Slack