Aviso de fim do suporte: em 15 de setembro de 2025, o suporte para o Amazon Lex V1 AWS será interrompido. Após 15 de setembro de 2025, você não poderá mais acessar o console do Amazon Lex V1 nem os respectivos recursos. Se você estiver usando o Amazon Lex V2, consulte o [guia do Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) em vez disso.
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Integração de um bot de Amazon Lex com o Slack
Este exercício fornece instruções para integrar um bot do Amazon Lex com o aplicativo de sistema de mensagens Slack. Execute as seguintes etapas:
1. Crie um bot do Amazon Lex.
1. Crie um aplicativo de mensagem do Slack
1. Integre o aplicativo do Slack ao bot do Amazon Lex.
1. Teste a integração iniciando uma conversa com seu bot do Amazon Lex. Você envia mensagens com o aplicativo do Slack e testa em uma janela do navegador.
**Topics**
+ [Etapa 1: criar um bot do Amazon Lex](slack-bot-assoc-create-bot.md)
+ [Etapa 2: cadastre-se no Slack e crie uma equipe do Slack](slack-bot-assoc-create-team.md)
+ [Etapa 3: crie uma aplicação do Slack](slack-bot-assoc-create-app.md)
+ [Etapa 4: Integrar o aplicativo do Slack com o bot do Amazon Lex](slack-bot-assoc-create-assoc.md)
+ [Etapa 5: Completar a integração do Slack](slack-bot-back-in-slack-console.md)
+ [Etapa 6: teste a integração](slack-bot-test.md)
# Etapa 1: criar um bot do Amazon Lex
Se você ainda não tem um bot do Amazon Lex, crie e implante um. Neste tópico, pressupomos que você esteja usando o bot que criou no Exercício 1 dos Conceitos básicos. No entanto, você pode usar qualquer um dos bots de exemplo fornecidos neste guia. Para o Exercício 1 dos Conceitos básicos, consulte [Exercício 1: Criar um bot do Amazon Lex usando um esquema (Console).](gs-bp.md)
1. Crie um bot do Amazon Lex. Para instruções, consulte [Exercício 1: Criar um bot do Amazon Lex usando um esquema (Console).](gs-bp.md).
1. Implante o bot e crie um alias. Para instruções, consulte [Exercício 3: publique uma versão e crie um alias](gettingstarted-ex3.md).
**Próxima etapa**
[Etapa 2: cadastre-se no Slack e crie uma equipe do Slack](slack-bot-assoc-create-team.md)
# Etapa 2: cadastre-se no Slack e crie uma equipe do Slack
Cadastre-se em uma conta do Slack e crie uma equipe do Slack. Para obter instruções, consulte [Uso do Slack](https://get.slack.help/hc/en-us/articles/212675257-Creating-a-Slack-account). Na próxima seção, você criará uma aplicação do Slack que qualquer equipe do Slack pode instalar.
**Próxima etapa**
[Etapa 3: crie uma aplicação do Slack](slack-bot-assoc-create-app.md)
# Etapa 3: crie uma aplicação do Slack
Nesta seção, faça o seguinte:
1. Crie uma aplicação do Slack no console da API do Slack
1. Configure o aplicativo para adicionar mensagens interativas ao seu bot:
No final desta seção, você obterá as credenciais do aplicativo (ID do cliente, segredo do cliente e token de verificação). Na próxima seção, você usará essas informações para configurar a associação do canal do bot no console do Amazon Lex.
1. Faça login no console da API do Slack em [http://api.slack.com API ](http://api.slack.com).
1. Crie um aplicativo.
Depois de que você cria o aplicativo com êxito, o Slack exibe a página **Informações básicas** do aplicativo.
1. Configure os atributos da aplicação da seguinte forma:
1. No menu à esquerda, escolha **Interatividade e atalhos**.
+ Selecione o seletor para ativar os componentes interativos.
+ Na caixa **URL da solicitação** especifique qualquer URL válido. Por exemplo, você poderá usar o **https://slack.com**.
**nota**
Por enquanto, insira qualquer URL válida para obter o token de verificação necessário na próxima etapa. Você atualizará essa URL depois de adicionar a associação de canal do bot no console do Amazon Lex.
+ Escolha **Salvar alterações**.
1. No menu esquerdo, em **Configurações**, escolha **Informações básicas**. Registre as seguintes credenciais do aplicativo:
+ ID de cliente
+ Segredo do cliente
+ Token de verificação
**Próxima etapa**
[Etapa 4: Integrar o aplicativo do Slack com o bot do Amazon Lex](slack-bot-assoc-create-assoc.md)
# Etapa 4: Integrar o aplicativo do Slack com o bot do Amazon Lex
Agora que tem as credenciais do aplicativo do Slack, você pode integrar o aplicativo com o bot do Amazon Lex. Para associar o aplicativo do Slack a seu bot, adicione uma associação de canal do bot no Amazon Lex.
No console do Amazon Lex, ative uma associação de canal do bot para associar o bot ao aplicativo do Slack. Quando a associação do canal do bot é ativada, o Amazon Lex retorna dois URLs (URL do **Postback e **OAuthURL****). Grave-os URLs porque você precisará deles mais tarde.
**Para integrar o aplicativo do Slack ao bot do Amazon Lex**
1. Faça login no AWS Management Console e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).
1. Selecione o bot do Amazon Lex que você criou na Etapa 1.
1. Escolha a guia **Canais**.
1. No menu esquerdo, selecione **Slack**.
1. Na página **Slack**, forneça os valores a seguir:
+ Digite um nome. Por exemplo, .`BotSlackIntegration`
+ No menu suspenso **Chave do KMS**, escolha "aws/lex".
+ Para **Alias**, escolha o alias bot.
+ Digite o **ID do cliente**, o **Segredo do cliente**e o **Token de verificação**, que você registrou na etapa anterior. Essas são as credenciais da aplicação do Slack.
![\[A tela de configuração do Slack.\]](http://docs.aws.amazon.com/pt_br/lex/latest/dg/images/slack-10a.png)
1. Selecione **Ativar**.
O console cria a associação do canal do bot e retorna duas URLs (URL do postback e OAuth URL). Anote-os. Na próxima seção, você atualizará a configuração da sua aplicação do Slack para usar esses endpoints conforme o seguinte:
+ A URL do Postback é o endpoint do bot do Amazon Lex que ouve aos eventos do Slack. Você usa este URL:
+ Como o URL de solicitação no atributo **Assinaturas de eventos** do aplicativo do Slack.
+ Para substituir o valor do espaço reservado para o URL solicitado no atributo **Mensagens interativas** do aplicativo do Slack.
+ A OAuth URL é o endpoint do seu bot Amazon Lex para um OAuth handshake com o Slack.
**Próxima etapa**
[Etapa 5: Completar a integração do Slack](slack-bot-back-in-slack-console.md)
# Etapa 5: Completar a integração do Slack
Nesta seção, use o console da API do Slack para completar a integração do aplicativo do Slack.
1. Faça login no console da API do Slack em [http://api.slack.com API](http://api.slack.com). Selecione o aplicativo que você criou em [Etapa 3: crie uma aplicação do Slack](slack-bot-assoc-create-app.md).
1. Atualize o recurso **OAuth & Permissões** da seguinte forma:
1. No menu à esquerda, escolha **OAuth & Permissões**.
1. Na URLs seção **Redirecionar**, adicione a OAuth URL que o Amazon Lex forneceu na etapa anterior. Escolha **Adicionar um novo URL de redirecionamento** e, em seguida, escolha **Salvar URLs**.
1. Na seção **Escopos do Bot Token**, adicione duas permissões com o botão **Adicionar um OAuth escopo**. Filtre a lista com o seguinte texto:
+ **chat:write**
+ **team:read**
1. Atualize o atributo **Interatividade e atalhos** atualizando o valor **URL da solicitação** para o URL do Postback que o Amazon Lex forneceu na etapa anterior. Insira o URL Postback que você salvou na etapa 4 e selecione **Salvar alterações**.
1. Assine o atributo **Assinaturas de eventos** da seguinte forma:
+ Habilite eventos escolhendo a opção **Ligado**.
+ Defina o valor da **URL da solicitação** como URL de Postback que o Amazon Lex forneceu na etapa anterior.
+ Na seção **Inscreva-se nos eventos do bot**, inscreva-se no evento de bot `message.im` para habilitar mensagens diretas entre o usuário final e o bot do Slack.
+ Salve as alterações.
1. Ative o envio de mensagens a partir da guia de mensagens da seguinte maneira:
+ No menu à esquerda, escolha **Página inicial do aplicativo**.
+ Na seção **Mostrar guias**, escolha **Permitir que os usuários enviem comandos e mensagens com barras a partir da guia de mensagens**.
**Próxima etapa**
[Etapa 6: teste a integração](slack-bot-test.md)
# Etapa 6: teste a integração
Agora, use uma janela do navegador para testar a integração do Slack com o bot do Amazon Lex.
1. Escolha **Gerenciar distribuição** em **Configurações**. Escolha **Adicionar ao Slack** para instalar o aplicativo. Autorize o bot a responder a mensagens.
1. Você é redirecionado para sua equipe do Slack. No menu esquerdo, na seção **Mensagens diretas**, escolha o bot. Se você não vir o bot, escolha o ícone de mais (\$1) ao lado de **Mensagens diretas** para procurá-lo.
1. Inicie um bate-papo com o aplicativo do Slack, que está vinculado ao bot do Amazon Lex. Seu bot agora responde a mensagens.
Se você criou o bot usando o Exercício 1 dos Conceitos básicos, pode usar as conversas de exemplo fornecidas no exercício. Para obter mais informações, consulte [Etapa 4: Adicione a função do Lambda como hook de código (console)](gs-bp-create-integrate.md).