Versions Compared

Version Old Version 3 New Version Current
Changes made by

Adriana Rios

sneha.tripathi

Saved on

Key

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

...

Siga los pasos a continuación para configurar su bot para que se comunique con los usuarios finales a través de la aplicación de mensajería de Slack:

...

Paso 1:

...

crear una aplicación

  1. Inicie sesión en el espacio de trabajo de Slack en https://slack.com/signin . If a workspace doesn't exist yet, create a new one.

    Image Removed

    Once you're signed in to your workspace, click the link below to create a Slack app channelSi todavía no existe un espacio de trabajo, cree uno nuevo.

    Image Added

  2. Una vez que haya iniciado sesión en su espacio de trabajo, haga clic en el vínculo siguiente para crear un canal de aplicación de Slack.
    https://api.slack.com/apps?new_app=1

  3. On the En la pantalla “Create a Slack App” screen, add your Slack app details(Crear una aplicación de Slack), agregue los datos de la aplicación de Slack.

    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. App Name and select your Workspace .

    2. Click the Create App button .

      Image Removed

      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 Removed

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

    Image Removed

    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 Removed

Step 2: configure the Slack app

Once the application is created, the next step is to configure the application and provide the necessary permission to allow it to interact with the Luma bot. The required settings are shown below:

    1. Login to the Luma VSA tenant in the Bot Builder UI (Nombre de la aplicación) y seleccione su Workspace (Espacio de trabajo).

    2. Haga clic en el botón Create App (Crear aplicación).

      Image Added

      Nota: En el caso de que no acceda directamente a la página Create a Slack App (Crear una aplicación de Slack). Haga clic en el botón Create New App (Crear nueva aplicación) en la página principal de la API de Slack.

      Image Added

  2. Una vez creada la aplicación de Slack, se lo redirigirá a la siguiente pantalla:

    Image Added

  3. Desplácese hacia abajo hastaCredenciales de la aplicación. Esta sección contiene elApp ID(ID de la aplicación) único, el Client ID (ID del cliente), el Client Secret (Secreto de cliente) y el Signing Secret (Secreto de firma) asignados a la aplicación. La información se utiliza para configurar Slack como un canal de chat en el tenant de Luma VSA y permite al tenant acceder a la API de Slack.
    Copie el App ID (ID de la aplicación), el Client ID (ID del cliente), el Client Secret (Secreto de cliente) y el Signing Secret (Secreto de firma) y conserve la información en una ubicación de fácil acceso, como un bloc de notas o cualquier herramienta de edición de texto. La información se utilizará más adelante para configurar y activar Slack en Luma VSA.

    Image Added

Paso 2: configurar la aplicación de Slack

Una vez que se crea la aplicación, el siguiente paso es configurar la aplicación y proporcionar el permiso necesario para permitir que interactúe con el bot de Luma. A continuación se muestran las configuraciones necesarias:

  1. Agregue la dirección URL del punto de conexión en la aplicación de Slack. La RequestURL (URL de solicitud) de Luma VSA se agrega a la aplicación de Slack. Para agregar la URL, siga los pasos a continuación:

    1. Inicie sesión en el tenant de Luma VSA en la interfaz de usuario del Bot Builder (Consola de Administración de Luma).

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

    3. Haga clic en el ícono de Slack.

      Image RemovedImage Added

    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.

      Image RemovedImage Added

    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 Tenant.

  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

      • http://message.im

      • message.mpim

        Image RemovedImage Added

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

  3. El siguiente paso es agregar OAuth y permisos.

    1. Vaya al tabulador a la pestaña OAuth & PermissionsClick (OAuth y permisos).

    2. Haga clic en Add new Redirect URL (Agregar nueva URL de redirección). La redirect URL de redirección es requerida necesaria para la autenticación. Las URLs in URL en Luma VSA and y Slack deben coincidir para que la configuración de la aplicación sea correcta.

      Image RemovedImage Added

    3. Agregue la RequestURL copiada en el paso 2 → 1(d) en el campo Redirigir URL Redirect URLs (URL de redirección) y haga clic en Add (Agregar).

      Image RemovedImage Added

    4. Click Haga clic en el Botón botón Save URLs (Guardar URL).

      Image RemovedImage Added

    5. 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 los alcances solicitados.
      Sección En la sección Scopes (ScopesAlcances) → Bot Token Scope (alcance Alcance del token del bot), click haga clic en Add an OAuth Scope (agregar Agregar un rango alcance 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. Sección En la sección Scopes (ScopesAlcances) → UserToken Scope (alcance Alcance del token de del usuario), click haga clic en Add an OAuth Scope (agregar Agregar un rango alcance de OAuth) y agregue el siguiente alcance:

    • users.profile:read
      Note that Tenga en cuenta que users.profile:read permite que Luma VSA solicite información del usuario de usuario a Slack para autenticar automáticamente al usuario.

      Image RemovedImage Added

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

    1. vaya Vaya a la pestaña Interactivity & Shortcuts tab (Interactividad y accesos directos).

    2. Cambie en el botón Interactivity por On (Interactividad) a On (Activado).

    3. Agregue la RequestURL copiada en el paso 2 → 1(d) en el campo Request URL (URL de solicitud). Slack enviará una solicitud de con información a esta dirección URL cuando los usuarios interactúen con un componente interactivo.

      Image RemovedImage Added

    4. Click Haga clic en Save Changes (Guardar cambios).

  6. Vaya Ahora vaya a la pestaña App Home y habilite (Inicio de la aplicación) y active lo siguiente:

    1. En la sección Your App's App’s Presence in Slack, cambie (Presencia de la aplicación en Slack), active Always Show My Bot as Online para On (Mostrar siempre mi bot en línea) a activado.

    2. En la sección Show Tabs (Show tabsMostrar pestañas), Seleccione active la pestaña Home tab (Home tabPestaña de inicio).

      Image RemovedImage Added
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.

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

...

  1. Inicie sesión en el tenant de Luma VSA en la interfaz de usuario del Generador de botsBot Builder (Consola de Administración de Luma).

  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.

    Image RemovedImage Added

  5. Desplácese hacia abajo hasta la sección Reconciliación de usuarios para la autenticación de canalescanal, 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.

      Image RemovedImage Added

  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.

    Image RemovedImage Added

  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 Tenant. Los usuarios finales pueden comunicarse con Luma VSA a través de Slack como un canal de chat.

    Image RemovedImage Added

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

...