

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Integración de un bot de Amazon Lex V2 con Slack
<a name="deploy-slack"></a>

Este tema proporciona instrucciones para la integración de un bot de Amazon Lex V2 con la aplicación de mensajería Slack. Debe realizar los pasos siguientes:

**Topics**
+ [Paso 1: Registrarse en Slack y crear un equipo de Slack](slack-step-1.md)
+ [Paso 2: Crear una aplicación de Slack](slack-step-2.md)
+ [Paso 3: Integrar la aplicación de Slack con el bot de Amazon Lex V2](slack-step-3.md)
+ [Paso 4: Finalizar la integración con su bot Lex V2](slack-step-4.md)
+ [Paso 5: Comprobar la integración entre su bot Lex V2 y Slack](slack-step-5.md)

# Paso 1: Registrarse en Slack y crear un equipo de Slack
<a name="slack-step-1"></a>

Inscríbase para obtener una cuenta de Slack y crear un equipo. Para obtener instrucciones, consulte [Uso de Slack](https://get.slack.help/hc/en-us/articles/212675257-Creating-a-Slack-account). En la siguiente sección, debe crear una aplicación de Slack, que pueda instalar cualquier equipo de Slack.

## Siguiente paso
<a name="slack-step-1-next"></a>

[Paso 2: Crear una aplicación de Slack](slack-step-2.md)

# Paso 2: Crear una aplicación de Slack
<a name="slack-step-2"></a>

En esta sección, hará lo siguiente: 

1. Cree una aplicación de Slack en la consola API de Slack.

1. Configure la aplicación para añadir mensajes interactivos a su bot:

Al final de esta sección, obtendrá las credenciales de la aplicación (ID de cliente, clave secreta de cliente y token de verificación). En el siguiente paso, utilizará esta información para integrar el bot en la consola de Amazon Lex V2.

**Para crear una aplicación de Slack**

1. Inicia sesión en la consola de API de Slack en [https://api.slack.com](https://api.slack.com).

1. Cree una aplicación. 

   Si ha creado la aplicación correctamente, Slack muestra la página **Información básica** de la aplicación. 

1. Configure las características de la aplicación de la siguiente manera:

   1. En el menú de la izquierda, seleccione **Interactividad y atajos**.
     + Deslice el interruptor para activar los componentes interactivos.
     + En el cuadro **Solicitar URL**, especifique cualquier URL válida. Por ejemplo, puede utilizar **https://slack.com**.
**nota**  
Por ahora, introduzca cualquier dirección URL válida para obtener el token de verificación que necesita en el siguiente paso. Deberá actualizar esta URL después de añadir la asociación de canal de bot en la consola de Amazon Lex. 
     + Seleccione **Guardar cambios**.

1. En el menú izquierdo, en **Configuración**, seleccione **Información básica**. Registre las siguientes credenciales de la aplicación:
   + ID de cliente 
   + Clave secreta del cliente
   + Token de verificación 

## Siguiente paso
<a name="slack-step-2-next"></a>

[Paso 3: Integrar la aplicación de Slack con el bot de Amazon Lex V2](slack-step-3.md)

# Paso 3: Integrar la aplicación de Slack con el bot de Amazon Lex V2
<a name="slack-step-3"></a>

 En esta sección, integre la aplicación de Slack que creó con el bot de Amazon Lex V2 que creó mediante integraciones de canales. 

1. Inicie sesión en la consola de administración de AWS y abra la consola de Amazon Lex en [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).

1. De la lista de bots, seleccione el bot de Amazon Lex V2 que creó.

1. En el menú de la izquierda, seleccione **Integraciones de canales** y, a continuación, seleccione **Añadir canal**.

1. En **Crear un canal**, haga lo siguiente:

   1. En **Plataforma**, seleccione **Slack**.

   1. Para **las políticas de identidad**, elija la AWS KMS clave para proteger la información del canal. Amazon Lex V2 proporciona la clave predeterminada.

   1. Para **Configurar la integración**, asigne un nombre al canal y, si lo desea, una descripción. Seleccione el alias dirigido a la versión del bot que se va a utilizar y seleccione el idioma compatible con el canal.
**nota**  
 Si su bot está disponible en varios idiomas, debe crear un canal diferente y una aplicación diferente para cada idioma. 

   1. En **Configuración adicional**, haga lo siguiente:
      + **ID de cliente**: introduzca el ID de cliente de Slack. 
      + **Clave secreta de cliente**: introduzca la clave secreta de cliente de Slack. 
      + **Token de verificación**: introduzca el token de verificación de Slack.
      + **URL de la página de éxito**: la URL de la página que Slack debe abrir cuando el usuario se autentica. Normalmente, puede dejarlo en blanco.

1. Seleccione **Crear** para crear el canal.

1. Amazon Lex V2 muestra la lista de canales de su bot. En la lista, seleccione el canal que acaba de crear.

1. En la **URL de devolución de llamada**, registre el punto final y el OAuth punto final.

## Siguiente paso
<a name="slack-step-3-next"></a>

[Paso 4: Finalizar la integración con su bot Lex V2](slack-step-4.md)

# Paso 4: Finalizar la integración con su bot Lex V2
<a name="slack-step-4"></a>

En esta sección, utilice la consola de la API de Slack para completar la integración de la aplicación de Slack.

1. Inicia sesión en la consola de la API de Slack en. [https://api.slack.com](https://api.slack.com) Seleccione la aplicación que ha creado en el [Paso 2: Crear una aplicación de Slack](slack-step-2.md).

1. Actualiza la función **OAuth y permisos** de la siguiente manera:

   1. En el menú de la izquierda, selecciona **OAuth & Permisos**.

   1. En la URLs sección **Redirigir**, añada el OAuth punto de conexión que Amazon Lex proporcionó en el paso anterior. Elija **Add (Añadir)** y, a continuación, elija **Save (Guardar) URLs**.

   1. En la sección Ámbitos de **los tokens de bots**, añada dos permisos con el botón **Añadir un OAuth ámbito**. Filtre la lista con el siguiente texto:
      + **chat:write**
      + **team:read**

1. Actualice la función **Interactividad y atajos** mediante la actualización del valor de **Solicitar URL** con el punto de conexión que Amazon Lex proporcionó en el paso anterior. Introduzca el punto de conexión que guardó en el paso 3 y, a continuación, seleccione **Guardar cambios**.

1. Suscríbase a la función **Suscripciones de eventos** de la siguiente manera:
   + Habilite los eventos mediante la opción **On**.
   + Defina el valor de **Solicitar URL** en el punto de conexión que Amazon Lex ha facilitado en el paso anterior. 
   + En la sección **Suscribirse a eventos de bot**, suscríbase a **Añadir evento para usuarios de bot** y añada el evento del bot de **message.im** para permitir la mensajería directa entre el usuario final y el bot de Slack.
   + Guarde los cambios.

1. Habilite el envío de mensajes desde la pestaña de mensajes de la siguiente manera:
   + En el menú izquierdo, seleccione **Inicio de la aplicación**.
   + En la sección **Mostrar pestañas**, seleccione **Permitir a los usuarios enviar comandos y mensajes desde la pestaña de mensajes**.

1. Seleccione **Administrar distribución** en **Configuración**. Seleccione **Añadir a Slack** para instalar la aplicación. Si está autenticado en varios espacios de trabajo, seleccione primero el espacio de trabajo correcto en la esquina superior derecha de la lista desplegable. A continuación, seleccione **Permitir** para autorizar al bot a responder a los mensajes. 
**nota**  
Si realiza algún cambio en la configuración de la aplicación de Slack más adelante, debe volver a realizar este subpaso.

## Siguiente paso
<a name="slack-step-4-next"></a>

[Paso 5: Comprobar la integración entre su bot Lex V2 y Slack](slack-step-5.md)

# Paso 5: Comprobar la integración entre su bot Lex V2 y Slack
<a name="slack-step-5"></a>

Ahora utilice una ventana de navegador para probar la integración de Slack con el bot de Amazon Lex V2.

**Para probar las aplicaciones de Slack**

1. Abra Slack. En el menú de la izquierda, en la sección **Mensajes directos**, seleccione su bot. Si no ve su bot, seleccione el icono más (\$1) junto a **Mensajes directos** para buscarlo.

1. Participe en un chat con su aplicación de Slack. Ahora su bot responde a los mensajes.

   Si creó el bot usando [Ejercicio 1: Crear un chatbot a partir de una plantilla](exercise-1.md), puede utilizar los ejemplos de conversaciones proporcionados en dicho ejercicio.