

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.

# Configura la integración entre las notificaciones y el AWS Chatbot
<a name="notifications-chatbot"></a>

AWS El Chatbot es un AWS servicio que permite a los equipos de desarrollo de software utilizar las salas de chat de Amazon Chime, los canales de Slack DevOps y los canales de Microsoft Team para monitorear y responder a los eventos operativos en el. Nube de AWS Puedes configurar la integración entre los objetivos de las reglas de notificación y el AWS Chatbot para que las notificaciones sobre eventos aparezcan en la sala de Amazon Chime, el canal de Slack o el canal de Microsoft Teams que elijas. Para obtener más información, consulte la [documentación de AWS Chatbot](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html).

Antes de configurar la integración con el AWS Chatbot, debe configurar una regla de notificación y un objetivo de la regla. Para obtener más información, consulte [Configuración](setting-up.md) y [Creación de una regla de notificación](notification-rule-create.md). También debe configurar un canal de Slack, un canal de Microsoft Teams o una sala de chat de Amazon Chime en AWS Chatbot. Para obtener más información, consulte la documentación de estos servicios.

**Topics**
+ [Configurar un cliente de AWS Chatbot para un canal de Slack](#notifications-chatbot-configure-client)
+ [Configurar un cliente de AWS Chatbot para un canal de Microsoft Teams](#notifications-chatbot-configure-client-ts)
+ [Configuración manual de clientes para Slack o Amazon Chime](#notifications-chatbot-configure-manual-client)

## Configurar un cliente de AWS Chatbot para un canal de Slack
<a name="notifications-chatbot-configure-client"></a>

Puedes crear reglas de notificación que usen un cliente de AWS Chatbot como objetivo. Si crea un cliente para un canal de Slack, puede utilizarlo directamente como destino en el flujo de trabajo para crear una regla de notificación. Esta es la forma más fácil de configurar las notificaciones que aparecen en los canales de Slack.

## Para crear un cliente de AWS Chatbot con Slack para usarlo como objetivo


1. Siga las instrucciones que se muestran en [Configuración de AWS Chatbot con Slack](https://docs.aws.amazon.com/chatbot/latest/adminguide/slack-setup.html#slack-client-setup) en la *Guía del administrador de AWS Chatbot*. Al hacerlo, estudie las siguientes opciones para realizar una integración óptima con las notificaciones:
   + Cuando se crea un rol de IAM, es conveniente elegir un nombre de rol que permita identificar fácilmente el propósito de este rol (por ejemplo, **AWSCodeStarNotifications-Chatbot-Slack-Role**). Esto puede ayudarle a identificar el propósito del rol en el futuro.
   + En **los temas de redes** sociales, no tienes que elegir un tema o una región. AWS Al elegir el cliente de AWS Chatbot como [destino](concepts.md#targets), se crea y configura un tema de Amazon SNS con todos los permisos necesarios para el cliente de AWS Chatbot como parte del proceso de creación de reglas de notificación.

1. Complete el proceso de creación del cliente. Este cliente estará disponible para que pueda elegirlo como destino al crear reglas de notificación. Para obtener más información, consulte [Creación de una regla de notificación](notification-rule-create.md).
**nota**  
No elimines el tema de Amazon SNS del cliente de AWS Chatbot después de haberlo configurado para ti. Si lo hace, impedirá que las notificaciones se envíen a Slack.

## Configurar un cliente de AWS Chatbot para un canal de Microsoft Teams
<a name="notifications-chatbot-configure-client-ts"></a>

Puedes crear reglas de notificación que usen un cliente de AWS Chatbot como objetivo. Si crea un cliente para un canal de Microsoft Teams, puede utilizarlo directamente como destino en el flujo de trabajo para crear una regla de notificación. Esta es la forma más fácil de configurar las notificaciones que aparecen en los canales de Microsoft Teams.

## Para crear un cliente de AWS Chatbot con Microsoft Teams para usarlo como objetivo


1. Siga las instrucciones que se muestran en [Configuración de AWS Chatbot con Microsoft Teams](https://docs.aws.amazon.com/chatbot/latest/adminguide/teams-setup.html#teams-client-setup) en la *Guía del administrador de AWS Chatbot*. Al hacerlo, estudie las siguientes opciones para realizar una integración óptima con las notificaciones:
   + Cuando se crea un rol de IAM, es conveniente elegir un nombre de rol que permita identificar fácilmente el propósito de este rol (por ejemplo, **AWSCodeStarNotifications-Chatbot-Microsoft-Teams-Role**). Esto puede ayudarle a identificar el propósito del rol en el futuro.
   + En **los temas de SNS**, no tienes que elegir un tema o una AWS región. Al elegir el cliente de AWS Chatbot como [destino](concepts.md#targets), se crea y configura un tema de Amazon SNS con todos los permisos necesarios para el cliente de AWS Chatbot como parte del proceso de creación de reglas de notificación.

1. Complete el proceso de creación del cliente. Este cliente estará disponible para que pueda elegirlo como destino al crear reglas de notificación. Para obtener más información, consulte [Creación de una regla de notificación](notification-rule-create.md).
**nota**  
No elimines el tema de Amazon SNS del cliente de AWS Chatbot después de haberlo configurado para ti. Si lo hace, impedirá que las notificaciones se envíen a Microsoft Teams.

## Configuración manual de clientes para Slack o Amazon Chime
<a name="notifications-chatbot-configure-manual-client"></a>

Puede elegir crear la integración entre las notificaciones y Slack o Amazon Chime directamente. Este es el único método disponible para configurar notificaciones en las salas de chat de Amazon Chime. Al configurar esta integración manualmente, se crea un cliente de AWS Chatbot que utiliza un tema de Amazon SNS que se haya configurado previamente como destino de una regla de notificación.<a name="notification-rule-chatbot-console-manual"></a>

## Para integrar manualmente las notificaciones con AWS Chatbot y Slack
<a name="notification-rule-chatbot-console-manual"></a>

1. [Abre la consola de herramientas AWS para desarrolladores en https://console.aws.amazon.com/codesuite/ la sección de configuración/notificaciones.](https://console.aws.amazon.com/codesuite/settings/notifications/)

1. Elija **Settings (Configuración)** y, a continuación, elija **Notification rules (Reglas de notificación)**.

1. En **Notification rule targets (Destinos de regla de notificación)**, busque y copie el destino.
**nota**  
Puede configurar más de una regla de notificación para utilizar el mismo tema de Amazon SNS que su destino. Esto puede ayudarle a consolidar la mensajería, pero puede tener consecuencias no deseadas si la lista de suscripciones está destinada a un recurso o regla de notificación. 

1. Abre la consola del AWS Chatbot en. [https://console.aws.amazon.com/chatbot/](https://console.aws.amazon.com/chatbot/)

1. Elija **Configure new client (Configurar nuevo cliente)** y, a continuación, seleccione **Slack**.

1. Elija **Configurar**.

1. Inicie sesión en su espacio de trabajo de Slack.

1. Si se le pide que confirme las opciones, elija **Allow (Permitir)**.

1. Elija **Configure new channel (Configurar nuevo canal)**.

1. En **Configuration details (Detalles de configuración)**, escriba el nombre para el cliente en **Configuration name (Nombre de configuración)**. Este es el nombre que aparecerá en la lista de destinos disponibles para el tipo de destino de **AWS Chatbot (Slack)** cuando se crean reglas de notificación.

1. En **Configure Slack Channel** (Configurar canal de Slack), en **Channel type** (Tipo de canal), elija **Public** (Público) o **Private** (Privado), en función del tipo de canal que desee integrar. 
   + En **Public channel (Canal público)**, elija el nombre del canal Slack de la lista.
   + En **Private channel ID (ID de canal privado)**, introduzca el código de canal o la URL.

1. En **IAM permissions** (Permisos de IAM), en **Role** (Rol), elija **Create an IAM role using a template** (Crear un rol de IAM con una plantilla). En **Policy template (Plantillas de políticas)**, elija **Notification permissions (Permisos de notificación)**. En **Role name (Nombre del rol)**, introduzca un nombre para este rol (por ejemplo, **AWSCodeStarNotifications-Chatbot-Slack-Role**). En **Policy template (Plantillas de políticas)**, elija **Notification permissions (Permisos de notificación)**.

1. En **los temas de SNS**, en la **región de SNS**, elige el Región de AWS lugar donde creaste el objetivo de la regla de notificación. En **SNS topics** (Temas de SNS), elija el nombre del tema de Amazon SNS que ha configurado como el destino de regla de notificación.
**nota**  
Este paso no es necesario si va a crear una regla de notificación utilizando este cliente como destino.

1. Elija **Configurar**.
**nota**  
Si configuró la integración con un canal privado, debe invitar a AWS Chatbot a ese canal para poder ver las notificaciones que aparecen en él. Para obtener más información, consulte la [documentación de AWS Chatbot](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html).

1. (Opcional) Para probar la integración, realice un cambio en el recurso que coincida con un tipo de evento de una regla de notificación configurada para utilizar el tema de Amazon SNS como destino. Por ejemplo, si tiene una regla de notificación configurada para enviar notificaciones cuando se realizan comentarios sobre una solicitud de extracción, realice un comentario sobre una solicitud de extracción y, a continuación, vea el canal de Slack en el navegador para ver cuándo aparece la notificación.<a name="notifications-chatbot-chime"></a>

## Para integrar las notificaciones con AWS Chatbot y Amazon Chime
<a name="notifications-chatbot-chime"></a>

1. [Abra la consola de herramientas AWS para desarrolladores en https://console.aws.amazon.com/codesuite/ la sección de configuración/notificaciones.](https://console.aws.amazon.com/codesuite/settings/notifications/)

1. Elija **Settings (Configuración)** y, a continuación, elija **Notification rules (Reglas de notificación)**.

1. En **Notification rule targets (Destinos de regla de notificación)**, busque y copie el destino.
**nota**  
Puede configurar más de una regla de notificación para utilizar el mismo tema de Amazon SNS que su destino. Esto puede ayudarle a consolidar la mensajería, pero también puede tener consecuencias no deseadas si la lista de suscripciones está destinada a un recurso o regla de notificación.

1. En Amazon Chime, abra la sala de chat que desea configurar para la integración.

1. Elija el icono de engranaje en la esquina superior derecha y, a continuación, seleccione **Manage webhooks (Administrar webhooks)**. 

1. En el cuadro de diálogo **Manage webhooks (Administrar webhooks)**, elija **New (Nuevo)**, escriba un nombre para el webhook y a continuación elija **Create (Crear)**. 

1. Compruebe que aparece el webhook y, a continuación, elija **Copy webhook URL (Copiar URL del webhook)**. 

1. Abre la consola del AWS Chatbot en. [https://console.aws.amazon.com/chatbot/](https://console.aws.amazon.com/chatbot/)

1. Elija **Configure new client** (Configurar nuevo cliente) y, a continuación, elija **Amazon Chime**.

1. En **Configuration details (Detalles de configuración)**, escriba el nombre para el cliente en **Configuration name (Nombre de configuración)**. 

1. En **Webhook URL (URL de webhook)**, pegue la URL. En **Webhook description (descripción de Webhook)**, proporcione una descripción opcional.

1. En **IAM permissions** (Permisos de IAM), en **Role** (Rol), elija **Create an IAM role using a template** (Crear un rol de IAM con una plantilla). En **Policy template (Plantillas de políticas)**, elija **Notification permissions (Permisos de notificación)**. En **Role name (Nombre del rol)**, introduzca un nombre para este rol (por ejemplo, **AWSCodeStarNotifications-Chatbot-Chime-Role**). 

1. En **los temas de SNS**, en la **región de SNS**, elige el Región de AWS lugar donde creaste el objetivo de la regla de notificación. En **SNS topics** (Temas de SNS), elija el nombre del tema de Amazon SNS que ha configurado como el destino de regla de notificación.

1. Elija **Configurar**.

1. (Opcional) Para probar la integración, realice un cambio en el recurso que coincida con un tipo de evento de una regla de notificación configurada para utilizar el tema de Amazon SNS como destino. Por ejemplo, si tiene una regla de notificación configurada para enviar notificaciones cuando se realizan comentarios sobre una solicitud de extracción, realice un comentario sobre una de ellas y, a continuación, consulte la sala de chat de Amazon Chime para comprobar cuándo aparece la notificación.