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

# Integrar um bot de Amazon Lex V2 com o Slack
<a name="deploy-slack"></a>

Este tópico fornece instruções para integrar um bot Amazon Lex V2 com o aplicativo de sistema de mensagens Slack. Execute as seguintes etapas:

**Topics**
+ [Etapa 1: cadastrar-se no Slack e criar uma equipe do Slack](slack-step-1.md)
+ [Etapa 2: criar um aplicativo do Slack](slack-step-2.md)
+ [Etapa 3: integrar o aplicativo do Slack com o bot Amazon Lex V2](slack-step-3.md)
+ [Etapa 4: concluir a integração do Slack com seu bot do Lex V2](slack-step-4.md)
+ [Etapa 5: testar a integração entre seu bot do Lex V2 e o Slack](slack-step-5.md)

# Etapa 1: cadastrar-se no Slack e criar uma equipe do Slack
<a name="slack-step-1"></a>

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
<a name="slack-step-1-next"></a>

[Etapa 2: criar um aplicativo do Slack](slack-step-2.md)

# Etapa 2: criar um aplicativo do Slack
<a name="slack-step-2"></a>

Nesta seção, faça o seguinte: 

1. Crie um aplicativo do Slack no console da API do Slack.

1. Configure o aplicativo para adicionar mensagens interativas ao 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 etapa, você usará essas informações para integrar o bot no console do Amazon Lex V2.

**Como criar um aplicativo do Slack**

1. Faça login no console de API do Slack em [https://api.slack.com](https://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
<a name="slack-step-2-next"></a>

[Etapa 3: integrar o aplicativo do Slack com o bot Amazon Lex V2](slack-step-3.md)

# Etapa 3: integrar o aplicativo do Slack com o bot Amazon Lex V2
<a name="slack-step-3"></a>

 Nesta seção, integre o aplicativo do Slack que você criou com o bot Amazon Lex V2 criado com integrações de canais. 

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. Na lista de bots, escolha o bot Amazon Lex V2 que você criou.

1. No menu à esquerda, selecione **Integrações de canais** e, em seguida, selecione **Adicionar canal**.

1. Em **Criar canal**, faça o seguinte:

   1. Em **Plataforma**, escolha **Slack**.

   1. Para **políticas de identidade**, escolha a AWS KMS chave para proteger as informações do canal. A chave padrão é fornecida pelo Amazon Lex V2.

   1. Em **Configuração de integração**, dê ao canal um nome e uma descrição opcional. Selecione o alias que aponta para a versão do bot a ser usada e escolha o idioma compatível com o canal.
**nota**  
 Se o bot estiver disponível em vários idiomas, será necessário criar um canal diferente e um aplicativo diferente para cada idioma. 

   1. Em **Configuração adicional**, faça o seguinte:
      + **ID do cliente** – insira o ID do cliente do Slack. 
      + **Segredo do cliente** – insira o segredo do cliente no Slack. 
      + **Token de verificação** – insira o token de verificação do Slack.
      + **URL da página de êxito** – a URL da página que o Slack deve abrir quando o usuário é autenticado. Normalmente, você deixa este campo em branco.

1. Escolha **Criar** para criar o canal.

1. O Amazon Lex V2 mostra a lista de canais do bot. Na lista, escolha o canal que você acabou de criar.

1. Em **Callback URL**, registre o endpoint e o OAuth endpoint.

## Próxima etapa
<a name="slack-step-3-next"></a>

[Etapa 4: concluir a integração do Slack com seu bot do Lex V2](slack-step-4.md)

# Etapa 4: concluir a integração do Slack com seu bot do Lex V2
<a name="slack-step-4"></a>

Nesta seção, use o console da API do Slack para completar a integração com o aplicativo do Slack.

1. Faça login no console da API Slack em [https://api.slack.com](https://api.slack.com). Selecione o aplicativo que você criou em [Etapa 2: criar um aplicativo do Slack](slack-step-2.md).

1. Atualize o recurso **OAuth & Permissões** da seguinte forma:

   1. No menu à esquerda, escolha **OAuth & Permissões**.

   1. Na URLs seção **Redirecionamento**, adicione o OAuth endpoint que o Amazon Lex forneceu na etapa anterior. Escolha **Add** e, em seguida, escolha **Save 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 endpoint que o Amazon Lex forneceu na etapa anterior. Insira o endpoint que você salvou na etapa 3 e selecione **Salvar alterações**.

1. Assine o atributo **Assinaturas de Eventos** da seguinte forma:
   + Ative eventos escolhendo a opção **Ativar**.
   + Defina o valor **URL da solicitação** para o endpoint que o Amazon Lex forneceu na etapa anterior. 
   + Na seção **Assinar eventos do bot**, selecione **Adicionar evento de usuário do bot** e adicione o evento do 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 na guia de mensagens**.

1. Escolha **Gerenciar distribuição** em **Configurações**. Escolha **Adicionar ao Slack** para instalar o aplicativo. Se você estiver autenticado em vários espaços de trabalho, primeiro escolha o espaço de trabalho correto no canto superior direito da lista suspensa. Em seguida, selecione **Permitir** para autorizar o bot a responder às mensagens. 
**nota**  
Se você fizer alguma alteração nas configurações do aplicativo do Slack posteriormente, será necessário refazer essa subetapa.

## Próxima etapa
<a name="slack-step-4-next"></a>

[Etapa 5: testar a integração entre seu bot do Lex V2 e o Slack](slack-step-5.md)

# Etapa 5: testar a integração entre seu bot do Lex V2 e o Slack
<a name="slack-step-5"></a>

Agora, use uma janela do navegador para testar a integração do Slack com o bot do Amazon Lex V2.

**Como testar o aplicativo do Slack**

1. Inicie o Slack. No menu esquerdo, na seção **Mensagens diretas**, selecione o bot. Se você não vir o bot, escolha o ícone de mais (\$1) ao lado de **Mensagens diretas** para procurá-lo.

1. Participe de um bate-papo com o aplicativo do Slack. O bot responde a mensagens.

   Se você criou o bot usando [Exercício 1: criar um chatbot a partir de um modelo](exercise-1.md), poderá usar os exemplos de conversas nesse exercício.