Por que meu Amazon Q Developer não recebe mensagens do Amazon SNS?

Breve descrição

As notificações do seu tópico do Amazon SNS não chegaram ao Amazon Q Developer por um dos seguintes motivos:

• O canal de comunicação entre o Amazon Q Developer e o canal do Slack está configurado incorretamente.
• O canal de comunicação entre o tópico do SNS e o Amazon Q Developer está configurado incorretamente.

Resolução

Ative o CloudWatch Logs para o Amazon Q Developer

Se você ainda não fez isso, ative o Amazon CloudWatch Logs para o Amazon Q Developer em aplicações de bate-papo para analisar as mensagens de erro.

Verifique se configurou corretamente o canal de comunicação entre o Amazon Q Developer e o canal do Slack

Verifique se o canal do Slack não está arquivado ou excluído

Se um canal do Slack estiver arquivado ou excluído, o canal não poderá receber mensagens e o Slack desativa todas as aplicações.

Para desarquivar um canal, consulte Arquivar ou excluir um canal no site do Slack.

Observação: não é possível restaurar um canal excluído do Slack. Se o canal inscrito do Slack estiver excluído, crie um novo canal do Slack e configure o novo canal para receber notificações do seu tópico.

Verifique se você instalou a aplicação de bate-papo no seu espaço de trabalho do Slack

Analise suas aplicações de bate-papo no CloudWatch Logs para ver a mensagem de erro "account_inactive". Se você encontrar a mensagem de erro "account_inactive", sua aplicação de bate-papo não foi instalada no seu espaço de trabalho do Slack.

Para instalar a aplicação de bate-papo no seu espaço de trabalho do Slack, siga as instruções em Tutorial: Get started with Slack (Tutorial: conceitos básicos do Slack).

(Somente para canais privados do Slack) Verifique se adicionou a aplicação de bate-papo ao canal do Slack

Analise suas aplicações de bate-papo no CloudWatch Logs para ver a mensagem de erro "channel_not_found". Se você não adicionou sua aplicação de bate-papo ao canal privado, aparece essa mensagem de erro.

Para adicionar o Amazon Q Developer a um canal privado do Slack, execute o comando /invite @Amazon Q no canal privado.

(Para Slack, Amazon Chime e Microsoft Teams)

Verifique se você configurou corretamente o canal de comunicação entre o tópico do SNS e o Amazon Q Developer.

Verifique se você inscreveu o Amazon Q Developer no seu tópico do Amazon SNS

Conclua as etapas a seguir:

1. Abra o console do Amazon Q Developer.
2. No painel de navegação, em Clientes configurados, clique em Slack, Amazon Chime ou Microsoft Teams.
3. Selecione seu canal do Slack em Configuração do espaço de trabalho do Slack, webhook na lista de webhooks do Amazon Chime ou seu canal do Microsoft Teams.
4. Clique em Editar.
5. No painel Detalhes, em Tópicos, procure seu tópico do SNS. Se o tópico não estiver listado, inscreva seu tópico do SNS no Amazon Q Developer.

Verifique se você listou o endpoint do Amazon Q Developer como uma inscrição de tópico no seu tópico do Amazon SNS

Conclua as etapas a seguir:

1. Abra o console do Amazon SNS.
2. No painel de navegação, clique em Tópicos e selecione o nome do seu tópico do SNS.
3. Em Inscrições, procure o seguinte endpoint do Amazon Q Developer: https://global.sns-api.chatbot.amazonaws.com. Se o endpoint do Amazon Q Developer não estiver listado como uma inscrição de tópico, você deve inscrever seu tópico do SNS no Amazon Q Developer.
   Observação: use sua configuração do Amazon Q Developer para enviar uma notificação de teste.

Certifique-se de não publicar manualmente mensagens em um formato não compatível com seu tópico do SNS no Amazon Q Developer

O Amazon Q Developer recebe mensagens que são publicadas manualmente em um tópico do SNS. No entanto, o formato da mensagem deve ser compatível com o Amazon Q Developer. Qualquer serviço configurado para enviar mensagens deve enviar notificações do Amazon SNS para o Amazon Q Developer somente por meio dos serviços compatíveis com o Amazon Q Developer.

Verifique se o Amazon Q Developer é compatível com as mensagens do serviço da AWS publicadas em seu tópico do Amazon SNS

Analise suas aplicações de bate-papo no CloudWatch Logs para ver a mensagem de erro "Event Received is not supported". Se você receber uma mensagem de erro "Event Received is not supported", isso significa que o Amazon Q Developer não é compatível com a mensagem do serviço da AWS publicada em seu tópico.

Para obter uma lista dos serviços da AWS compatíveis com o Amazon Q Developer, consulte Monitoring AWS services using Amazon Q Developer in chat applications (Monitoramento dos serviços da AWS usando o Amazon Q Developer em aplicações de bate-papo).

Certifique-se de que seu tópico do Amazon SNS conceda as permissões necessárias para que outro serviço da AWS publique mensagens

Conclua as etapas a seguir:

1. Abra o console do Amazon SNS.
2. No painel de navegação, clique em Tópicos.
3. Selecione o tópico do SNS no qual você inscreveu o Amazon Q Developer.
4. Clique na guia Política de acesso.
5. Analise a seção Declaração da política de acesso. Certifique-se de que a política permita que o serviço correto da AWS execute a ação da API SNS:Publish.
6. Se sua política de acesso do Amazon SNS não permitir que o serviço correto da AWS publique eventos em seu tópico, atualize a política:
   Na seção Detalhes da página do seu tópico, clique em Editar.
   Expanda a seção Política de acesso e adicione o controle de acesso correto.

Observação: para obter exemplos de políticas de acesso do Amazon SNS, consulte Configurar tópicos do Amazon SNS para notificações.

Verifique se o seu tópico do Amazon SNS não tem a entrega de mensagens brutas ativada

O Amazon Q Developer não aceita a entrega de mensagens brutas. Para verificar se seu tópico do SNS não tem a entrega de mensagens brutas ativada, conclua as seguintes etapas:

1. Abra o console do Amazon SNS.
2. No painel de navegação, clique em Tópicos e selecione o nome do seu tópico do SNS.
3. No painel Detalhes, em Entrega de mensagens brutas, verifique se o status está ativado ou desativado.
4. Se o status estiver ativado, realize as seguintes ações:
   Clique em Editar.
   Desmarque a opção Ativar entrega de mensagens brutas para desativar a entrega de mensagens desse tipo.
   Clique em Salvar alterações.

Certifique-se de incluir as permissões necessárias da política de chave do AWS KMS

Observação: essa verificação só se aplica a tópicos do SNS com a criptografia do lado do servidor ativada.

Sua política de chave do AWS Key Management Service (AWS KMS) deve permitir que o serviço que envia mensagens publique em seus tópicos criptografados do SNS.

Sua política de chave do AWS KMS deve incluir a seguinte seção:

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

Importante: substitua events.amazonaws.com pela entidade principal do serviço da AWS para o serviço que publica seus tópicos de SNS criptografados.

Verifique se os serviços da AWS não publicam mensagens em seu tópico do Amazon SNS a uma taxa superior a 10 notificações por segundo

O Amazon Q Developer permite 10 eventos por segundo. Se o Amazon Q Developer receber mais de 10 eventos por segundo, as mensagens adicionais serão limitadas.

Para verificar se você limitou eventos, analise a métrica EventsThrottled em seu CloudWatch Logs para Amazon Q Developer.

(Para Amazon EventBridge) Certifique-se de que o EventBridge aceita notificações de eventos que os serviços da AWS enviam para seu destino de cliente do Amazon Q Developer

Use um transformador de entrada do EventBridge para gerar notificações personalizadas e, em seguida, encaminhe as notificações para um tópico do SNS. Monitore o tópico do SNS e envie notificações aos canais configurados do Microsoft Teams, Amazon Chime ou Slack com o Amazon Q Developer. As notificações personalizadas do Amazon Q Developer devem seguir o formato do esquema de eventos.

Para obter mais informações, consulte Supported services for Amazon Q Developer in chat applications (Serviços compatíveis com o Amazon Q Developer em aplicações de bate-papo).

Informações relacionadas

Troubleshooting Amazon Q Developer in chat channels (Solução de problemas do Amazon Q Developer em canais de bate-papo)

Como uso webhooks para publicar mensagens do Amazon SNS no Amazon Chime, Slack ou Microsoft Teams?