Configuración de la integración entre las notificaciones y AWS Chatbot

AWS Chatbot es un servicio de AWS que permite a los equipos de desarrollo de software y DevOps utilizar las salas de chat de Amazon Chime, los canales de Slack y los canales de Microsoft Teams para monitorizar eventos operativos en la Nube de AWS y responder a ellos. Puede configurar la integración entre los destinos de reglas de notificación y AWS Chatbot para que las notificaciones sobre los eventos aparezcan en la sala de chat de Amazon Chime, en el canal de Slack o en el canal de Microsoft Teams que elija. Para obtener más información, consulte la documentación de AWS Chatbot.

Antes de configurar la integración con AWS Chatbot, debe configurar una regla de notificación y un destino de regla. Para obtener más información, consulte Configuración y Creación de una regla de notificación. 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.

Configuración de un cliente de AWS Chatbot para un canal de Slack

Puede crear reglas de notificación que utilicen un cliente de AWS Chatbot como destino. 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 destino

1. Siga las instrucciones que se muestran en Configuración de AWS Chatbot con Slack 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 SNS topics (Temas de SNS), no tiene que elegir un tema o una región de AWS. Cuando se elige el cliente de AWS Chatbot como destino, se crea un tema de Amazon SNS con todos los permisos necesarios y se configura para el cliente de AWS Chatbot durante el proceso de creación de las reglas de notificación.

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

   nota

   No elimine el tema de Amazon SNS del cliente de AWS Chatbot después de configurarlo. Si lo hace, impedirá que las notificaciones se envíen a Slack.

Configuración de un cliente de AWS Chatbot para un canal de Microsoft Teams

Puede crear reglas de notificación que utilicen un cliente de AWS Chatbot como destino. 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 destino

1. Siga las instrucciones que se muestran en Configuración de AWS Chatbot con Microsoft Teams 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 SNS topics (Temas de SNS), no tiene que elegir un tema o una región de AWS. Cuando se elige el cliente de AWS Chatbot como destino, se crea un tema de Amazon SNS con todos los permisos necesarios y se configura para el cliente de AWS Chatbot durante el proceso de creación de las reglas de notificación.

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

   nota

   No elimine el tema de Amazon SNS del cliente de AWS Chatbot después de configurarlo. Si lo hace, impedirá que las notificaciones se envíen a Microsoft Teams.

Configuración manual de clientes para Slack o Amazon Chime

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. Cuando configura esta integración de forma manual, se crea un cliente de AWS Chatbot que utiliza un tema de Amazon SNS configurado previamente como destino para una regla de notificación.

Para integrar notificaciones manualmente en AWS Chatbot y Slack

1. Abra la consola de las herramientas para desarrolladores de AWS en https://console.aws.amazon.com/codesuite/settings/notifications.

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

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

4. Abra la consola de AWS Chatbot en https://console.aws.amazon.com/chatbot/.

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

6. Elija Configure.

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

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

9. Elija Configure new channel (Configurar nuevo canal).

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

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

12. 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).

13. En SNS topics (Temas de SNS), en SNS Region (Región de SNS), elija la Región de AWS en la que creó el destino de 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.

14. Elija Configure.

    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.

15. (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.

Para integrar notificaciones en AWS Chatbot y Amazon Chime

1. Abra la consola de las herramientas para desarrolladores de AWS en https://console.aws.amazon.com/codesuite/settings/notifications.

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

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

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

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

6. 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).

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

8. Abra la consola de AWS Chatbot en https://console.aws.amazon.com/chatbot/.

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

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

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

12. 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).

13. En SNS topics (Temas de SNS), en SNS Region (Región de SNS), elija la Región de AWS en la que creó el destino de 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.

14. Elija Configure.

15. (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.