¿Por qué mi Amazon Q Developer no recibe mensajes de Amazon SNS?

Descripción corta

Las notificaciones de tu tema de Amazon SNS no llegaron a Amazon Q Developer por uno de los siguientes motivos:

• El canal de comunicación entre Amazon Q Developer y el canal de Slack está mal configurado.
• El canal de comunicación entre el tema de SNS y Amazon Q Developer está mal configurado.

Resolución

Activación de Registros de CloudWatch para Amazon Q Developer

Si aún no lo has hecho, activa Registros de Amazon CloudWatch para Amazon Q Developer en las aplicaciones de chat para revisar los mensajes de error.

Comprobar que se ha configurado correctamente el canal de comunicación entre Amazon Q Developer y el canal de Slack

Asegúrate de que el canal de Slack no esté archivado ni eliminado

Si un canal de Slack se archiva o se elimina, el canal no puede recibir mensajes y Slack desactiva todas las aplicaciones.

Para quitar del archivo un canal, consulta Cómo archivar o eliminar un canal en el sitio web de Slack.

Nota: No puedes restaurar un canal de Slack eliminado. Si se elimina el canal de Slack al que tienes una suscripción, crea un nuevo canal de Slack y, a continuación, configúralo para recibir notificaciones de tu tema.

Comprobar que se ha instalado la aplicación de chat en el espacio de trabajo de Slack

Revisa los registros de CloudWatch de las aplicaciones de chat para ver el mensaje de error «account_inactive». Si encuentras el mensaje de error «account_inactive», significa que la aplicación de chat no se instaló en tu espacio de trabajo de Slack.

Para instalar la aplicación de chat en tu espacio de trabajo de Slack, sigue las instrucciones del Tutorial: Get started with Slack (Tutorial: Introducción a Slack).

(Solo para canales privados de Slack) Comprobar que se ha agregado la aplicación de chat al canal de Slack

Revisa los registros de CloudWatch de las aplicaciones de chat para ver el mensaje de error «channel_not_found». Si no agregaste tu aplicación de chat al canal privado, aparecerá este mensaje de error.

Para agregar Amazon Q Developer a un canal privado de Slack, ejecuta el comando /invite @Amazon Q en el canal privado.

(Para Slack, Amazon Chime y Microsoft Teams)

Comprueba que has configurado correctamente el canal de comunicación entre el tema de SNS y Amazon Q Developer.

Comprobar que tienes una suscripción a Amazon Q Developer para tu tema de Amazon SNS

Sigue estos pasos:

1. Abre la consola de Amazon Q Developer.
2. En el panel de navegación, en Clientes configurados, elige Slack, Amazon Chime o Microsoft Teams.
3. Selecciona tu canal de Slack en la configuración del espacio de trabajo de Slack, el webhook en la lista de webhooks de Amazon Chime o tu canal de Microsoft Teams.
4. Selecciona Editar.
5. En el panel Detalles, en Temas, busca tu tema de SNS. Si el tema no aparece en la lista, suscríbete a tu tema de SNS a Amazon Q Developer.

Comprobar que se ha incluido el punto de enlace de Amazon Q Developer como una suscripción temática para tu tema de Amazon SNS

Sigue estos pasos:

1. Abre la consola de Amazon SNS.
2. En el panel de navegación, elige Temas y, a continuación, selecciona el nombre de tu tema de SNS.
3. En Suscripciones, busca el siguiente punto de enlace de Amazon Q Developer: https://global.sns-api.chatbot.amazonaws.com. Si el punto de enlace de Amazon Q Developer no aparece como una suscripción temática, debes suscribir tu tema de SNS a Amazon Q Developer.
   Nota: Usa tu configuración de Amazon Q Developer para enviar una notificación de prueba.

Asegúrate de no publicar manualmente mensajes en un formato no compatible desde el tema de SNS a Amazon Q Developer

Amazon Q Developer admite los mensajes que se publican manualmente en un tema de SNS. Sin embargo, el formato del mensaje debe ser compatible con Amazon Q Developer. Cualquier servicio configurado para enviar mensajes debe enviar notificaciones de Amazon SNS a Amazon Q Developer únicamente a través de los servicios compatibles con Amazon Q Developer.

Comprobar que Amazon Q Developer admite los mensajes de servicio de AWS publicados en el tema de Amazon SNS

Revisa los registros de CloudWatch de tu aplicación de chat para ver si aparece el mensaje de error «Event Received is not supported». Si aparece un mensaje de error «Event Received is not supported», significa que Amazon Q Developer no admite el mensaje de servicio de AWS publicado en tu tema.

Para obtener una lista de los servicios de AWS compatibles con Amazon Q Developer, consulta Supervisión de los servicios de AWS con Amazon Q Developer en las aplicaciones de chat.

Asegúrate de que el tema de Amazon SNS conceda los permisos necesarios para que otro servicio de AWS publique mensajes

Sigue estos pasos:

1. Abre la consola de Amazon SNS.
2. En el panel de navegación, elige Temas.
3. Selecciona el tema de SNS al que te suscribiste a Amazon Q Developer.
4. Selecciona la pestaña Política de acceso.
5. Revisa la sección Instrucción de la política de acceso. Asegúrate de que la política permita que el servicio de AWS correcto ejecute la acción de API SNS:Publish.
6. Si tu política de acceso a Amazon SNS no permite que el servicio de AWS correcto publique eventos sobre tu tema, actualiza la política:
   En la sección Detalles de la página del tema, selecciona Editar.
   Amplía la sección Política de acceso y, a continuación, agrega el control de acceso correcto.

Nota: Para ver ejemplos de políticas de acceso a Amazon SNS, consulta Configuración de temas de Amazon SNS para las notificaciones.

Comprobar que el tema de Amazon SNS no tenga activada la entrega de mensajes sin procesar

Amazon Q Developer no acepta el envío de mensajes sin procesar. Para comprobar que tu tema de SNS no tiene activada la entrega de mensajes sin procesar, sigue estos pasos:

1. Abre la consola de Amazon SNS.
2. En el panel de navegación, elige Temas y, a continuación, selecciona el nombre de tu tema de SNS.
3. En el panel Detalles, en Entrega de mensajes sin procesar, comprueba si el estado está activado o desactivado.
4. Si el estado está activado, realiza las siguientes acciones:
   Selecciona Editar.
   Desactiva Activar la entrega de mensajes sin procesar para desactivar la entrega de mensajes sin procesar.
   Selecciona Guardar cambios.

Asegúrate de incluir los permisos de política de claves de AWS KMS necesarios

Nota: Esta comprobación solo se aplica a los temas de SNS con el cifrado del lado del servidor activado.

Tu política de claves de AWS Key Management Service (AWS KMS) debe permitir que el servicio que envía mensajes publique en tus temas de SNS cifrados.

La política de claves de AWS KMS debe incluir la siguiente sección:

{  
  "Sid": "Allow CWE to use the key",  
  "Effect": "Allow",  
  "Principal": {  
    "Service": "service.amazonaws.com"  
  },  
  "Action": [  
    "kms:Decrypt",  
    "kms:GenerateDataKey"  
  ],  
  "Resource": "*"  
}

Importante: Sustituye events.amazonaws.com por la entidad principal de servicio de AWS para el servicio que publica tus temas de SNS cifrados.

Comprobar que los servicios de AWS no publiquen mensajes en tu tema de Amazon SNS a un ritmo superior a 10 notificaciones por segundo

Amazon Q Developer permite 10 eventos por segundo. Si Amazon Q Developer recibe más de 10 eventos por segundo, se limitan los mensajes adicionales.

Para comprobar si tienes eventos limitados, revisa la métrica EventsThrottled en los Registros de CloudWatch para Amazon Q Developer.

(Para Amazon EventBridge) Asegurarse de que EventBridge sea compatible con las notificaciones de eventos que los servicios de AWS envían al destino del cliente de Amazon Q Developer

Utiliza un transformador de entrada de EventBridge para generar notificaciones personalizadas y, a continuación, reenviar las notificaciones a un tema de SNS. Supervisa el tema de SNS y envía notificaciones a los canales configurados de Microsoft Teams, Amazon Chime o Slack con Amazon Q Developer. Las notificaciones personalizadas de Amazon Q Developer deben seguir el formato del esquema de eventos.

Para obtener más información, consulta Servicios compatibles para Amazon Q Developer en aplicaciones de chat.

Información relacionada

Solución de problemas de Amazon Q Developer en los canales de chat

¿Cómo puedo utilizar los webhooks para publicar mensajes de Amazon SNS en Amazon Chime, Slack o Microsoft Teams?