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
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, consulteMétodos de autenticação.
Antes de começar
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
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 Quickstartno site do Slack. -
Para obter os requisitos de assinatura do Amazon Quick, consulteConfigurar integrações no console.
Configuração do Slack
Se você estiver usando a autenticação padrão do aplicativo OAuth, pule esta seção e acesse. Configurando o conector no Amazon Quick
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
Crie um aplicativo Slack para obter as credenciais do cliente ou o token de bot que você precisa para o Amazon Quick.
-
Acesse o painel da API do Slack
no site do Slack e escolha Criar novo aplicativo. -
Escolha Do zero.
-
Insira o nome do aplicativo e selecione seu espaço de trabalho do Slack. Escolha Criar aplicativo.
-
Na barra lateral esquerda, escolha OAuth e permissões.
-
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/oauthcallbackEscolha Adicionar e, em seguida, selecione Salvar URLs.
-
Em Escopos, adicione os Escopos do Bot Token que sua integração exige. Para obter os escopos recomendados, consulteEscopos recomendados.
-
Na barra lateral esquerda, escolha Informações básicas. Em Credenciais do aplicativo, registre os seguintes valores:
-
ID do cliente
-
Segredo do cliente
-
-
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
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.
| 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 estars: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
Configurando o conector no Amazon Quick
Conecte-se a partir da guia Disponível
Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia Disponível sem configuração adicional.
-
No console do Amazon Quick, escolha Conectores.
-
Na guia Disponível, encontre o Slack e escolha Connect.
-
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
Depois de concluir qualquer configuração necessária do Slack, crie o conector no Amazon Quick.
-
No console do Amazon Quick, escolha Conectores.
-
Escolha a guia Criar para sua equipe.
-
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.
-
Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.
-
Em Tipo de conexão, escolha Rede pública.
-
Para Configuração do OAuth, escolha um dos métodos de autenticação a seguir e configure os campos obrigatórios.
-
Para o aplicativo OAuth padrão:
Nenhuma credencial adicional é necessária. Escolha Próximo para continuar.
-
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.
-
-
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-).
-
-
-
Escolha Próximo.
-
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.
-
Na página Revisar, revise as ações disponíveis para o conector. Escolha Próximo.
-
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.
-
Selecione Publish.
Ações disponíveis
Depois de configurar o conector, as ações a seguir estarão disponíveis.
| 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
Para editar, compartilhar ou excluir seu conector, consulteGerenciando integrações existentes.
Problemas de autenticação
-
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.
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.
-
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.
