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 do Slack
<a name="slack-integration"></a>

Com o conector de ação do Slack, você pode acessar a plataforma Slack diretamente no Amazon Quick por meio de linguagem natural. Você pode enviar mensagens, gerenciar canais, pesquisar conteúdo e interagir com usuários e grupos de usuários sem sair do Amazon Quick.

O Amazon Quick oferece suporte a vários métodos de autenticação para o Slack. Escolha o método que melhor se adapta aos requisitos de segurança da sua organização.
+ Aplicativo **OAuth padrão — usa um aplicativo** OAuth AWS gerenciado. Nenhuma credencial adicional é necessária. Você se autentica diretamente no seu espaço de trabalho do Slack.
+ Aplicativo **OAuth personalizado — usa um aplicativo** Slack gerenciado pelo cliente. Essa opção dá à sua organização controle total sobre a configuração do OAuth.
+ **Token do portador — usa um token** de bot do Slack para autenticação. Esse método é adequado para acesso em nível de bot a um espaço de trabalho.

Para obter mais informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulte[Métodos de autenticação](quick-action-auth.md).

## Antes de começar
<a name="slack-integration-prerequisites"></a>

Verifique se você tem o seguinte antes de configurar a integração.
+ Um espaço de trabalho do Slack com acesso aos canais e dados que você deseja usar.
+ Para um **aplicativo OAuth personalizado**: acesso ao [painel da API do Slack](https://api.slack.com/apps) no site do Slack para criar um aplicativo.
+ Para **Bearer Token**: um token de bot (começa com`xoxb-`) de um aplicativo Slack. Para obter mais informações, consulte as [configurações do aplicativo Quickstart](https://docs.slack.dev/app-management/quickstart-app-settings) no site do Slack.
+ Para obter os requisitos de assinatura do Amazon Quick, consulte[Configurar integrações no console](integration-console-setup-process.md).

## Configuração do Slack
<a name="slack-source-setup"></a>

Se você estiver usando a autenticação **padrão do aplicativo OAuth**, pule esta seção e acesse. [Configurando o conector no Amazon Quick](#slack-quicksuite-setup)

Para autenticação personalizada do aplicativo OAuth ou do token do portador, conclua as etapas aplicáveis no Slack antes de configurar o Amazon Quick.

### Crie um aplicativo Slack para aplicativo OAuth personalizado ou token de portador
<a name="slack-register-oauth"></a>

Crie um aplicativo Slack para obter as credenciais do cliente ou o token de bot que você precisa para o Amazon Quick.

1. Acesse o [painel da API do Slack](https://api.slack.com/apps) no site do Slack e escolha **Criar novo** aplicativo.

1. Escolha **Do zero**.

1. Insira o **nome do aplicativo** e selecione seu espaço de trabalho do Slack. Escolha **Criar aplicativo**.

1. Na barra lateral esquerda, escolha **OAuth e permissões.**

1. Em **URLs de redirecionamento**, escolha **Adicionar nova URL de redirecionamento e insira a URL** de retorno de chamada do Amazon Quick: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

   Escolha **Adicionar** e, em seguida, selecione **Salvar URLs.**

1. Em **Escopos**, adicione os Escopos do Bot Token que sua integração exige. Para obter os escopos recomendados, consulte[Escopos recomendados](#slack-oauth-scopes).

1. Na barra lateral esquerda, escolha **Informações básicas**. Em **Credenciais do aplicativo**, registre os seguintes valores:
   + **ID do cliente**
   + **Segredo do cliente**

1. Para **Bearer Token**: instale o aplicativo em seu espaço de trabalho a partir da página **OAuth** e permissões. Após a instalação, copie o **Bot User OAuth Token** (começa com`xoxb-`).

### Escopos recomendados
<a name="slack-oauth-scopes"></a>

Os escopos a seguir são solicitados quando você se conecta ao Slack. Ao criar um app personalizado do Slack, adicione esses escopos na página **OAuth** e permissões. Para o aplicativo OAuth personalizado, adicione-os como escopos de **token de usuário**. Para Bearer Token, adicione-os como **escopos de token de bot**.


**Escopos recomendados pelo Slack**  

| Escopo | Description | 
| --- | --- | 
| calls:read | Lê as informações da chamada. | 
| calls:write | Cria e gerencia chamadas. | 
| channels:history | Lê o histórico de mensagens em canais públicos. | 
| channels:read | Lê informações sobre canais públicos. | 
| channels:write | Gerencia canais públicos. | 
| chat:write | Envia mensagens para canais e conversas. | 
| dnd:read | Lê as configurações de Não perturbe. | 
| dnd:write | Atualiza as configurações do Não perturbe. | 
| emoji:read | Lê emojis personalizados. | 
| files:read | Lê arquivos compartilhados em canais. | 
| files:write | Carrega e gerencia arquivos. | 
| groups:history | Lê o histórico de mensagens em canais privados. | 
| groups:read | Lê informações sobre canais privados. | 
| groups:write | Gerencia canais privados. | 
| im:history | Lê o histórico de mensagens em mensagens diretas. | 
| im:read | Lê informações sobre mensagens diretas. | 
| im:write | Inicia mensagens diretas. | 
| links:read | Lê visualizações de links. | 
| links:write | Gerencia visualizações de links. | 
| mpim:history | Lê o histórico de mensagens em mensagens diretas em grupo. | 
| mpim:read | Lê informações sobre mensagens diretas em grupo. | 
| mpim:write | Inicia mensagens diretas em grupo. | 
| pins:read | Lê mensagens fixadas. | 
| pins:write | Fixa e desfixa mensagens. | 
| reactions:read | Lê as reações de emojis nas mensagens. | 
| reactions:write | Adiciona e remove reações de emoji. | 
| reminders:read | Lê lembretes. | 
| reminders:write | Cria lembretes. | 
| remote\_files:read | Lê arquivos remotos. | 
| remote\_files:share | Compartilha arquivos remotos. | 
| search:read | Pesquisa mensagens e arquivos. | 
| stars:read | Lê itens marcados com estrela. | 
| stars:write | Itens com e sem estrelas. | 
| team:read | Lê as informações do espaço de trabalho. | 
| usergroups:read | Lê as informações do grupo de usuários. | 
| usergroups:write | Gerencia grupos de usuários. | 
| users:read | Lê as informações do usuário. | 
| users:read.email | Lê os endereços de e-mail do usuário. | 
| users:write | Atualiza as informações do usuário. | 
| users.profile:read | Lê as informações do perfil do usuário. | 
| users.profile:write | Atualiza as informações do perfil do usuário. | 

**nota**  
Nem todos os escopos estão disponíveis tanto para os escopos do token do usuário quanto para os escopos do token do bot. Alguns escopos, como `search:read` e`stars:read`, estão disponíveis somente como escopos de token de usuário. Ao configurar escopos para a autenticação do Bearer Token, verifique a disponibilidade do escopo na [referência de escopos da API Slack](https://api.slack.com/scopes) no site do Slack.

## Configurando o conector no Amazon Quick
<a name="slack-quicksuite-setup"></a>

### Conecte-se a partir da guia Disponível
<a name="slack-quick-connect"></a>

Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia **Disponível** sem configuração adicional.

1. No console do Amazon Quick, escolha **Conectores**.

1. Na guia **Disponível**, encontre o **Slack** e escolha **Connect**.

1. Conclua o fluxo de login do Slack e conceda as permissões solicitadas.

Em vez disso, para configurar um conector com o aplicativo OAuth personalizado ou o token do portador, use a guia **Criar para sua equipe**, conforme descrito abaixo.

### Crie a partir da guia Criar para sua equipe
<a name="slack-full-setup"></a>

Depois de concluir qualquer configuração necessária do Slack, crie o conector no Amazon Quick.

1. No console do Amazon Quick, escolha **Conectores**.

1. Escolha a guia **Criar para sua equipe**.

1. Encontre e escolha o **Slack**.
**nota**  
Se um conector do Slack já existir, uma caixa de diálogo será exibida com seus conectores existentes. Para usar um conector existente, escolha-o. Para criar um novo, escolha **Não, criar novo**.

1. Insira um **nome** para seu conector. Opcionalmente, escolha **\+ Adicionar descrição** para adicionar uma descrição.

1. Em **Tipo de conexão**, escolha **Rede pública**.

1. Para **Configuração do OAuth**, escolha um dos métodos de autenticação a seguir e configure os campos obrigatórios.

   1. Para o **aplicativo OAuth padrão**:

      Nenhuma credencial adicional é necessária. Escolha **Próximo** para continuar.

   1. Para o **aplicativo OAuth personalizado**, configure os seguintes campos:
      + **URL base** (opcional) — A URL base da API Slack. Exemplo: `https://slack.com/api`
      + **ID do cliente** — O ID do cliente do seu aplicativo Slack.
      + **Segredo do cliente** — O segredo do cliente do seu aplicativo Slack.
      + **URL do token** — O endpoint do token. Exemplo: `https://slack.com/api/oauth.v2.access`
      + **URL de autorização** — O endpoint de autorização. Exemplo: `https://slack.com/oauth/v2/authorize`
      + URL de **redirecionamento — Pre-filled com o URL** de retorno de chamada do Amazon Quick.

   1. Para **Bearer Token**, configure os seguintes campos:
      + **URL base** (opcional) — A URL base da API Slack. Exemplo: `https://slack.com/api`
      + **Token de bot** — Seu token de bot do Slack (começa com`xoxb-`).

1. Escolha **Próximo**.

1. Se você escolher o aplicativo **OAuth padrão ou o aplicativo** **OAuth personalizado, uma janela de autorização do** Slack será aberta. Revise as permissões solicitadas, selecione seu espaço de trabalho e escolha **Permitir**.

1. Na página **Revisar**, revise as ações disponíveis para o conector. Escolha **Próximo**.

1. Na página **Publicar**, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos.

1. Selecione **Publish**.

## Ações disponíveis
<a name="slack-integration-actions"></a>

Depois de configurar o conector, as ações a seguir estarão disponíveis.


**Ações disponíveis do Slack**  

| Categoria | Ação | Description | 
| --- | --- | --- | 
| Mensagens | Mensagem de postagem de bate-papo | Publica uma mensagem em um canal, mensagem direta ou grupo privado. | 
| Mensagens | Envie-me uma mensagem | Envia uma mensagem de ação em terceira pessoa para um canal. | 
| Mensagens | Obter link permanente da mensagem | Recupera um URL de link permanente para uma mensagem específica. | 
| Canais | Criação de conversas | Cria um canal público ou privado. | 
| Canais | Histórico de conversas | Recupera o histórico de mensagens de um canal. Retorna somente mensagens da linha do tempo principal, não respostas encadeadas. | 
| Canais | Respostas de conversas | Recupera respostas encadeadas para uma mensagem principal específica. | 
| Canais | Convite para conversas | Convida usuários para um canal existente. | 
| Canais | Conversas Participe | Ingressa em um canal existente. | 
| Canais | Início de conversas | Remove um usuário de um canal. | 
| Canais | Conversas saem | Sai de um canal. | 
| Canais | Membros de conversas | Lista os IDs dos membros de um canal. | 
| Canais | Conversas abertas | Abre ou retoma uma mensagem direta ou uma mensagem direta para várias pessoas. | 
| Canais | Conversas Definir tópico | Define ou atualiza o tópico de um canal. | 
| Canais | Obtenha uma conversa | Recupera metadados de um canal por ID. | 
| Canais | Listar canais | Lista os canais disponíveis para o usuário. | 
| Canais | Listar conversas para o usuário | Lista canais e mensagens diretas acessíveis a um usuário. | 
| Reações | Criar reação | Adiciona uma reação de emoji a uma mensagem. | 
| Reações | Excluir reação | Remove uma reação de emoji de uma mensagem. | 
| Reações | Listar reações | Lista as reações em uma mensagem, arquivo ou comentário de arquivo. | 
| Arquivos | Carregar ou criar arquivo | Carrega arquivos ou mídia em canais ou tópicos. | 
| Arquivos | Carregar para URL externo | Adiciona uma referência a um arquivo externo para compartilhamento no Slack. | 
| Arquivos | Baixar arquivo | Baixa um arquivo compartilhado no Slack. | 
| Arquivos | Informações sobre arquivos | Recupera metadados e comentários de um arquivo. | 
| Arquivos | Lista de arquivos | Lista arquivos em um espaço de trabalho com filtros opcionais. | 
| Pesquisa | Pesquisar tudo | Pesquisa mensagens e arquivos em todo o espaço de trabalho. | 
| Pesquisa | Pesquisar mensagens | Pesquisa mensagens com intervalos de datas e filtros. | 
| Pesquisa | Canais de pesquisa | Pesquisa canais por nome, tópico ou finalidade. | 
| Pesquisa | Pesquisar usuários | Pesquisa usuários por e-mail, nome ou nome de exibição. | 
| Pesquisa | Contexto de pesquisa | Pesquisa mensagens, arquivos, canais e usuários. Oferece suporte à pesquisa semântica em espaços de trabalho com a IA do Slack. | 
| Pesquisa | Obter configuração de pesquisa | Verifica se a pesquisa semântica está disponível no espaço de trabalho. | 
| Usuários | Obter detalhes do usuário | Recupera informações de um usuário por ID. | 
| Usuários | Obter perfil de usuário | Recupera as informações do perfil de um usuário. | 
| Usuários | Conjunto de perfis de usuários | Atualiza os campos do perfil de um usuário. | 
| Usuários | Lista de usuários | Lista todos os usuários no espaço de trabalho. | 
| User groups (Grupos de usuários) | Grupos de usuários criados | Cria um novo grupo de usuários. | 
| User groups (Grupos de usuários) | Lista de grupos de usuários | Lista os grupos de usuários no espaço de trabalho. | 
| User groups (Grupos de usuários) | Grupos de usuários Atualização de usuários | Substitui todos os membros de um grupo de usuários. | 
| Lembretes | Lembretes Adicionar | Cria um lembrete com texto e hora especificados. | 
| Espaço de trabalho | Obtenha a equipe | Recupera metadados sobre o espaço de trabalho do Slack. | 

**nota**  
As ações que você pode usar dependem dos escopos configurados para seu aplicativo Slack e dos canais acessíveis ao usuário autenticado.

## Gerenciamento e solução de problemas
<a name="slack-integration-troubleshooting"></a>

Para editar, compartilhar ou excluir seu conector, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations).

### Problemas de autenticação
<a name="slack-troubleshooting-auth"></a>
+ **Sign-in falha (aplicativo OAuth padrão ou aplicativo OAuth personalizado)** [— Verifique se seu espaço de trabalho do Slack está ativo e se você pode entrar diretamente no site do Slack.](https://slack.com) Para o aplicativo OAuth personalizado, confirme se o URL de redirecionamento no seu aplicativo Slack corresponde ao URL de retorno de chamada do Amazon Quick.
+ **Credenciais de cliente inválidas (aplicativo OAuth personalizado)** — Verifique se o ID do cliente e o segredo do cliente correspondem aos valores na seção Informações básicas do seu aplicativo Slack.
+ **Token do portador rejeitado** — Verifique se o token do seu bot está ativo e começa com`xoxb-`. Os tokens podem ser revogados no painel da API Slack.
+ **Permissões insuficientes** — verifique se os escopos configurados para seu aplicativo Slack incluem as permissões necessárias para as ações que você deseja usar. Consulte [Escopos recomendados](#slack-oauth-scopes).
+ **Canal não encontrado ou não está no canal** — Verifique se o bot foi adicionado ao canal. Convide o bot para o canal antes de tentar postar mensagens ou ler o histórico.