

Aviso de fin de soporte: el 15 de septiembre de 2025, AWS dejaremos de ofrecer soporte para Amazon Lex V1. Después del 15 de septiembre de 2025, ya no podrá acceder a la consola de Amazon Lex V1 ni a los recursos de Amazon Lex V1. Si utiliza Amazon Lex V2, consulte en su lugar la [guía Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 

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 con Slack
<a name="slack-bot-association"></a>

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

1. crear un bot de Amazon Lex,

1. crear una aplicación de mensajería Slack, 

1. integrar la aplicación Slack con el bot de Amazon Lex,

1. Probar la integración entablando una conversación con el bot de Amazon Lex. Puede enviar mensajes con la aplicación Slack y realizar una prueba en una ventana del navegador.

**Topics**
+ [Paso 1: creación de un bot de Amazon Lex](slack-bot-assoc-create-bot.md)
+ [Paso 2: inscripción en Slack y creación de un equipo de Slack](slack-bot-assoc-create-team.md)
+ [Paso 3: creación de una aplicación Slack](slack-bot-assoc-create-app.md)
+ [Paso 4: integración de la aplicación Slack con el bot de Amazon Lex](slack-bot-assoc-create-assoc.md)
+ [Paso 5: finalización de la integración con Slack](slack-bot-back-in-slack-console.md)
+ [Paso 6: comprobación de la integración](slack-bot-test.md)

# Paso 1: creación de un bot de Amazon Lex
<a name="slack-bot-assoc-create-bot"></a>

Si aún no tiene un bot de Amazon Lex, cree uno e impleméntelo. En este tema, supongamos que está utilizando el bot que ha creado en el ejercicio de introducción 1. También puede utilizar cualquiera de los ejemplos de bot que se proporcionan en esta guía. Para el ejercicio de introducción 1, consulte [Ejercicio 1: creación de un bot de Amazon Lex mediante un esquema (consola)](gs-bp.md)

1. Cree un bot de Amazon Lex. Para obtener instrucciones, consulte [Ejercicio 1: creación de un bot de Amazon Lex mediante un esquema (consola)](gs-bp.md). 

1. Implemente el bot y cree un alias. Para obtener instrucciones, consulte [Ejercicio 3: publicación de una versión y creación de un alias](gettingstarted-ex3.md).

**Paso siguiente**  
[Paso 2: inscripción en Slack y creación de un equipo de Slack](slack-bot-assoc-create-team.md)

# Paso 2: inscripción en Slack y creación de un equipo de Slack
<a name="slack-bot-assoc-create-team"></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 Slack, que pueda instalar cualquier equipo de Slack.

**Paso siguiente**  
[Paso 3: creación de una aplicación Slack](slack-bot-assoc-create-app.md)

# Paso 3: creación de una aplicación Slack
<a name="slack-bot-assoc-create-app"></a>

En esta sección, hará lo siguiente:

1. Cree una aplicación 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, secreto de cliente y token de verificación). En la siguiente sección utilizará esta información para configurar la asociación de canal de bot en la consola de Amazon Lex.

1. Inicie sesión en la consola de la API de Slack en [http://api.slack.com ](http://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 

**Paso siguiente**  
[Paso 4: integración de la aplicación Slack con el bot de Amazon Lex](slack-bot-assoc-create-assoc.md)

# Paso 4: integración de la aplicación Slack con el bot de Amazon Lex
<a name="slack-bot-assoc-create-assoc"></a>

Ahora que ya tiene las credenciales de la aplicación Slack, puede integrar la aplicación con el bot de Amazon Lex. Para asociar la aplicación Slack con el bot, añada una asociación de canal de bot en Amazon Lex.

En la consola de Amazon Lex, active una asociación de canal de bot para asociar el bot con la aplicación Slack. Cuando se activa la asociación de canales de bots, Amazon Lex devuelve dos URLs (**URL de devolución y **OAuthURL****). Regístrelas URLs porque las necesitará más adelante.

**Integración de la aplicación Slack con el bot de Amazon Lex**

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. Elija el bot de Amazon Lex que ha creado en el paso 1.

1. Elija la pestaña **Canales**.

1. En el menú de la izquierda, elija **Slack**. 

1. En la página **Slack**, especifique lo siguiente:
   + Escriba un nombre. Por ejemplo, `BotSlackIntegration`.
   + Elija “aws/lex” en el menú desplegable **KMS key**.
   + En **Alias**, elija el alias del bot.
   + Rellene los campos **Client Id**, **Client secret** y **Verification Token**, cuyos datos registró en el paso anterior. Estas son las credenciales de la aplicación Slack.   
![\[La pantalla de configuración de Slack.\]](http://docs.aws.amazon.com/es_es/lex/latest/dg/images/slack-10a.png)

1. Seleccione **Activar**. 

   La consola crea la asociación de canales de bots y devuelve dos URLs (URL y OAuth URL de devolución). Regístrelas. En la siguiente sección, actualice la configuración de la aplicación Slack para utilizar estos puntos de conexión de la siguiente manera:
   + La dirección URL de Postback es el punto de conexión del bot de Amazon Lex que escucha los eventos de Slack. Utilice esta dirección URL: 
     + Como dirección URL de solicitud en la función **Event Subscriptions** de la aplicación Slack.
     + Para sustituir el valor del marcador de posición de la dirección URL solicitada en la función **Interactive Messages** de la aplicación Slack.
   + La OAuth URL es el punto de enlace de tu bot de Amazon Lex para un OAuth apretón de manos con Slack. 

**Paso siguiente**  
[Paso 5: finalización de la integración con Slack](slack-bot-back-in-slack-console.md)

# Paso 5: finalización de la integración con Slack
<a name="slack-bot-back-in-slack-console"></a>

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

1. Inicie sesión en la consola de la API de Slack en [http://api.slack.com](http://api.slack.com). Seleccione la aplicación que ha creado en el [Paso 3: creación de una aplicación Slack](slack-bot-assoc-create-app.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 la OAuth URL que Amazon Lex proporcionó en el paso anterior. Seleccione **Añadir una nueva URL de redireccionamiento** y, a continuación, seleccione **Guardar URLs**.

   1. En la sección **Ámbitos de los tokens de bots**, añade 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 característica **Interactividad y atajos** mediante la actualización del valor de **Solicitar URL** con la URL de Postback que Amazon Lex proporcionó en el paso anterior. Introduzca la dirección URL de postback que guardó en el paso 4 y, a continuación, elija **Save Changes (Guardar cambios)**.

1. Suscríbase a la función **Suscripciones de eventos** de la siguiente manera:
   + Habilite los eventos mediante la opción **On**.
   + Establezca como valor de **URL de solicitud** la dirección URL de Postback que Amazon Lex ha facilitado en el paso anterior. 
   + En la sección **Subscribe to Bot Events**, suscríbase al evento de bot `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**.



**Paso siguiente**  
[Paso 6: comprobación de la integración](slack-bot-test.md)

# Paso 6: comprobación de la integración
<a name="slack-bot-test"></a>

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

1. Seleccione **Administrar distribución** en **Configuración**. Seleccione **Añadir a Slack** para instalar la aplicación. Autorice que el bot responda a mensajes.

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

1. Entable un chat con la aplicación de Slack vinculada al bot de Amazon Lex. Ahora su bot responde a los mensajes.

   Si creó el bot en Ejercicio de introducción 1, puede utilizar los ejemplos de conversaciones proporcionados en dicho ejercicio. Para obtener más información, consulte [Paso 4: adición de la función de Lambda como enlace de código (consola)](gs-bp-create-integrate.md).