Versions Compared

Version Old Version 2 New Version 3
Changes made by

haritha.kothapalem (Unlicensed)

Adriana Rios

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Sign in to the Slack workspace at https://slack.com/signin . If a workspace doesn't exist yet, create a new one.

    Image RemovedImage Added

  2. Once you're signed in to your workspace, click the link below to create a Slack app channel.
    https://api.slack.com/apps?new_app=1

  3. On the “Create a Slack App” screen, add your Slack app details.

    1. App Name and select your Workspace .

    2. Click the Create App button .

      Image RemovedImage Added

      Note: In case you don't go directly to the Create a Slack App page . Click the Create New App button on the main Slack API page.

      Image RemovedImage Added

  4. Once the Slack app is created, you will be redirected to the following screen:

    Image RemovedImage Added

  5. Scroll down to App Credentials . This section contains the unique App ID , Client ID, Client Secret, and Signing Secret assigned to the application. The information is used to configure Slack as a chat channel in the Luma VSA tenant and allows the tenant to access the Slack API. Copy the App ID , Client ID, Client Secret, and Signing Secret
    (Signature Secret) and keep the information in an easily accessible location, such as a notepad or any text editing tool. The information will later be used to configure and activate Slack in the Luma VSA.

    Image RemovedImage Added

Step 2: configure the Slack app

...

  1. Add the endpoint URL in the Slack app. The Luma VSA RequestURL (Request URL) is added to the Slack app. To add the URL, follow the steps below:

    1. Login to the Luma VSA tenant in the Bot Builder UI.

    2. Vaya a la pestaña Channel (Canal) en el menú Bot (Bot) → Configurations (Configuraciones).

    3. Haga clic en el ícono de Slack.

    4. Ahora se lo redirigirá a la página Configure Channel (Configurar canal). Copie el valor en el campo RequestURL/RedirectURL y consérvelo en un bloc de notas o en alguna herramienta de edición de texto. La dirección URL se agregará a la aplicación de Slack en el paso siguiente.

    5. Ahora en la página Slack API (API de Slack), vaya a la pestaña Event Subscription (Suscripción de eventos).

      Image RemovedImage Added

    6. Cambie el botón Enable Events (Activar eventos) a On (Activado).

    7. Agregue la RequestURL copiada en el paso 2 → 1(d) en el campo Request URL (URL de solicitud). La API de Slack enviará una solicitud al punto de conexión y verificará la dirección URL. Recién después de la verificación, Slack podrá conectarse con su inquilino .

  2. Ahora, desplácese hacia abajo hasta Subscribe (Suscribirse) a eventos de bot.
    Aquí nos suscribimos al bot “recibir eventos” como nuevos mensajes en el canal. Esto permite que Slack se comunique con Luma VSA. Puede suscribirse a eventos en función de las necesidades de su organización. Para obtener más información sobre todos los tipos de eventos, consulte https://api.slack.com/events. Para suscribirse a los eventos, haga lo siguiente:

    1. Haga clic en el botón Add Bot User Event (Agregar evento de usuario del bot).

    2. Busque y agregue las siguientes suscripciones a eventos una por una.

      • member_joined_channel

      • member_left_channel

      • message.channels

      • message.groups

      • message.im

      • message.mpim

    3. Haga clic en Save Changes (Guardar cambios).

  3. The next step is to add OAuth and permissions.

    Go to the

    El siguiente paso es agregar OAuth y permisos

    1. Vaya al tabulador OAuth & Permissions tab .

    2. Click Add new Redirect URL . The La redirect URL is required for authentication. The es requerida para la autenticación. Las URLs in Luma VSA and Slack must match for the application configuration to be correctdeben coincidir para que la configuración de la aplicación sea correcta.

      Add

    3. the RequestURL copied in step Agregue la RequestURL copiada en el paso 2 → 1 (d) in the Redirect URLs field and click Add .

      Image Removed

    4. Click the Save URLs button .

      Image Removed

    5. After adding the URL, we add the scope. The app's capabilities and permissions to interact with Luma VSA are governed by the scopes requested.
      Section en el campo Redirigir URL y haga clic en Agregar.

      Image Added

    6. Click en el Botón Save URLs.

      Image Added

    7. Después de agregar la URL, agregamos el alcance. Las capacidades y los permisos de la aplicación para interactuar con Luma VSA se rigen por los ámbitos solicitados.
      Sección Scopes (Scopes) → Bot Token Scope (Scope of the token of the alcance del token del bot) , click Add an OAuth Scope (Add a range of OAuth) and add the following scopes one by one agregar un rango de OAuth) y agregue los siguientes alcances uno por uno .

      • channels:history

      • channels:read

      • groups:history

      • groups:read

      • im:history

      • mpim:history

        Image RemovedImage Added

  4. Section Sección Scopes (Scopes) → UserToken Scope (Scope of the token of the useralcance del token de usuario) , click Add an OAuth Scope (Add a range of OAuth) and add the following scopeagregar un rango de OAuth) y agregue el siguiente alcance:

    Go to the

    • users.profile: read
      Note that users.profile: read allows the permite que Luma VSA to request user information from Slack to automatically authenticate the user.

      Image Removed

    The next step is to configure the interactive components, that is, activate the interactions between Slack and Luma VSA with the interactive components such as buttons, pick list, and more. To do this, follow the steps below:

    • solicite información de usuario a Slack para autenticar automáticamente al usuario.

      Image Added

  5. El siguiente paso es configurar los componentes interactivos, es decir, activar las interacciones entre Slack y Luma VSA con los componentes interactivos como botones, lista de selección y más. Para hacer esto, siga los pasos a continuación:

    1. vaya a la pestaña Interactivity & Shortcuts tab .

    2. Change the Interactivity button to Cambie en el botón Interactivity por On .

    3. Add the RequestURL copied in step Agregue la RequestURL copiada en el paso 2 → 1 (d) in the en el campo Request URL field. Slack will send an information request to this URL when users interact with an interactive component.

      Image Removed

    4. Click Save Changes .

    Now go to the App Home tab and enable the following:

    1. In the enviará una solicitud de información a esta URL cuando los usuarios interactúen con un componente interactivo.

      Image Added

    2. Click en Save Changes .

  6. Vaya a la pestaña App Home y habilite lo siguiente:

    1. En la sección Your App's Presence in Slack section , turn cambie Always Show My Bot as Online to para On .

    2. Section En la sección Show Tabs (Show tabs), select the tab Seleccione Home tab (Home tab) .

Info

Cuando se actualizan los permisos de alcance de OAuth, es necesario volver a instalar la aplicación para que se apliquen los cambios. Haga clic en Reinstall your app (Reinstalar su aplicación), en caso de que Slack presente la siguiente solicitud. Luma VSA solicitará permiso para acceder a su espacio de trabajo de Slack. Se lo redirigirá a la página de solicitud de permiso (similar al Paso 3-->punto 7). Haga clic en el botón Allow(Permitir)para aceptar la solicitud de acceso.

  • Image RemovedImage Added

    **Esto puede no ser necesario al agregar los permisos por primera vez.

...

Ahora que la aplicación de Slack está lista, el siguiente paso es activar el canal de chat de Slack y enviar las credenciales en Luma VSA. Para ello, siga los siguientes pasos:

  1. Inicie sesión en el inquilino tenant de Luma VSA en la interfaz de usuario del Generador de bots.

  2. Vaya a la pestaña Channel (Canal) en el menú Bot (Bot) → Configurations (Configuraciones).

  3. Haga clic en el ícono de Slack.

  4. En la página Configure Channel (Configurar canal), pegue los valores deApp ID (ID de la aplicación), Client ID (ID del cliente), Client Secret (Secreto de cliente) y Signing Secret (Secreto de firma) (conservados en el bloc de notas en el Paso 1 → 5) en sus respectivos campos.

  5. Desplácese hacia abajo hasta la sección Reconciliación de usuarios para la autenticación de canales, para especificar los detalles del usuario que Luma VSA utilizará para conciliar y autenticar automáticamente a los usuarios que se conectan a través de Slack. Dado que Luma VSA utiliza la dirección de correo electrónico para autenticar a los usuarios a través de Slack, agregue los campos de Luma que pueden contener la dirección de correo electrónico del usuario.

    1. Seleccione la información de usuario requerida en User Fields (Campos de usuario)

    2. Haga clic en el botón Set (Establecer).
      Puede agregar uno o más campos. Durante la conciliación o autenticación.

  6. Una vez que se agregan los detalles, haga clic en el botón Configure (Configurar) para activar el canal.

    Image RemovedImage Added

  7. Luma VSA solicitará permiso para acceder a su espacio de trabajo de Slack. Se lo redirigirá a la siguiente página.

  8. Haga clic en el botón Allow(Permitir)para aceptar la solicitud de acceso. Aparecerá la siguiente página con un mensaje de confirmación.

  9. Slack ahora está habilitado para su inquilinoTenant. Los usuarios finales pueden comunicarse con Luma VSA a través de Slack como un canal de chat.

Slack ahora está configurado para su inquilino tenant y los usuarios registrados pueden comunicarse con Luma VSA a través de Slack.

...