Slack
O Slack é uma ferramenta de comunicação de equipe, que reúne todas as comunicações da sua equipe em um só lugar, instantaneamente pesquisável e disponível onde quer que você vá.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Standard | Todas as regiões do Power Automatic , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Standard | Todas as regiões do Power Apps , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Automatize o poder | Standard | Todas as regiões do Power Automatic , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL | https://support.microsoft.com/contactus |
| Metadados do conector | |
|---|---|
| Editora | Microsoft |
| Sítio Web | https://slack.com/ |
| Política de privacidade | https://slack.com/privacy-policy |
| Categorias | Colaboração; Comunicação |
Problemas conhecidos e limitações
De acordo com a documentação da API do Slack, alguns métodos da API do Slack que o conector usa deixarão de funcionar em fevereiro de 2021 e não funcionarão com aplicativos recém-criados após 10 de junho de 2020. Então, use as versões mais recentes das ações abaixo.
Ações:
Criar um grupo foi preterido, use a versão mais recente de Criar um canal para criar canais privados.
O número máximo de caracteres numa mensagem está limitado a 4000. Para mais detalhes, consulte a documentação oficial do Slack.
Conector em profundidade
Para obter mais informações sobre o conector, consulte a seção detalhada.
Limites de Limitação
| Nome | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
| Frequência das sondagens de desencadeamento | 1 | 120 segundos |
Ações
| Conjunto não perturbe |
Defina o status não perturbar para o usuário. |
| Criar um canal |
Crie um canal no slack. |
| Criar um canal [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use Criar um canal .
|
| Criar um grupo [DEPRECATED] |
Cria um grupo na folga. |
| Junte-se a um canal [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use Participe de um canal público .
|
| Junte-se a um canal público |
Junte-se a um canal público no slack. |
| Listar canais [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use Listar canais públicos (suporte de paginação).
|
| Listar canais públicos |
Liste os canais públicos no slack. |
| Listar canais públicos (suporte de paginação) (Visualização) |
Liste os canais públicos no slack. |
| Listar mensagens de conversa (Pré-visualização) |
Liste as mensagens publicadas numa conversa (canal público, privado, mensagem direta ou mensagem direta em grupo). |
| Obter perfil de utilizador (Pré-visualização) |
Obtenha informações do perfil de um utilizador do Slack. Útil para resolver o autor de uma mensagem devolvida por mensagens de conversa de lista ou respostas de mensagens de lista. |
| Postar mensagem (V2) |
Esta operação é usada para postar uma mensagem para o canal especificado. |
| Postar mensagem [DEPRECATED] |
Esta ação foi preterida. Em vez disso, use a mensagem Post (V2).
|
| Respostas às mensagens da lista (Pré-visualização) |
Liste as respostas num tópico de mensagens, incluindo a mensagem principal. |
Conjunto não perturbe
Defina o status não perturbar para o usuário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Número de minutos
|
num_minutes | string |
O número de minutos a definir não perturba. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Snooze ativado
|
snooze_enabled | boolean |
Se a soneca está ativada. |
Criar um canal
Crie um canal no slack.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Nome
|
name | string |
O nome do novo canal. |
|
|
É canal privado?
|
is_private | boolean |
Canal é privado ou não |
Devoluções
Criar um canal [DEPRECATED]
Esta ação foi preterida. Em vez disso, use Criar um canal .
Crie um canal no slack.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Nome
|
name | string |
O nome do novo canal. |
Devoluções
Criar um grupo [DEPRECATED]
Cria um grupo na folga.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Nome
|
name | string |
O nome do grupo. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Id
|
group.id | string |
O id do grupo. |
|
Nome
|
group.name | string |
O nome do grupo. |
Junte-se a um canal [DEPRECATED]
Esta ação foi preterida. Em vez disso, use Participe de um canal público .
Junte-se a um canal no slack.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Nome
|
name | string |
O nome do canal. |
Devoluções
- Body
- JoinChannel_Response
Junte-se a um canal público
Junte-se a um canal público no slack.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Nome do canal
|
channel | string |
O nome do canal. |
Devoluções
Listar canais [DEPRECATED]
Esta ação foi preterida. Em vez disso, use Listar canais públicos (suporte de paginação).
Liste os canais no slack.
Devoluções
Listar canais públicos
Liste os canais públicos no slack.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Tipos de Conversa
|
types | string |
Tipos de conversa separados por vírgulas para incluir. Por defeito, é public_channel. Inclua explicitamente private_channel, IM ou MPIM para listar outros tipos de conversa. |
|
|
Excluir Arquivado
|
exclude_archived | boolean |
Define para true para excluir conversas arquivadas. |
|
|
Resultados Máximos
|
limit | integer |
O número máximo de conversas para regressar. |
|
|
ID da Equipa
|
team_id | string |
ID de equipa codificado. Necessário apenas para um token de toda a organização. |
|
|
Cursor
|
cursor | string |
Cursor de paginação devolvido pelo pedido anterior. |
Devoluções
Listar canais públicos (suporte de paginação) (Visualização)
Listar mensagens de conversa (Pré-visualização)
Liste as mensagens publicadas numa conversa (canal público, privado, mensagem direta ou mensagem direta em grupo).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
ID da Conversação
|
channel | True | string |
A conversa para ir buscar mensagens. |
|
Resultados Máximos
|
limit | integer |
O número máximo de mensagens a devolver por página. |
|
|
Carimbo temporal mais antigo
|
oldest | string |
Apenas mensagens após este carimbo temporal Unix serão incluídas nos resultados. |
|
|
Carimbo de data/hora mais recente
|
latest | string |
Apenas mensagens anteriores a este carimbo temporal Unix serão incluídas nos resultados. |
|
|
Inclusivo
|
inclusive | boolean |
Inclua mensagens com os carimbos temporais mais antigos ou mais recentes nos resultados. |
|
|
Incluir Todos os Metadados
|
include_all_metadata | boolean |
Devolva todos os metadados associados a cada mensagem. |
Devoluções
Obter perfil de utilizador (Pré-visualização)
Obtenha informações do perfil de um utilizador do Slack. Útil para resolver o autor de uma mensagem devolvida por mensagens de conversa de lista ou respostas de mensagens de lista.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
ID do Utilizador
|
user | True | string |
O ID do utilizador para obter informações de perfil. |
Devoluções
Postar mensagem (V2)
Esta operação é usada para postar uma mensagem para o canal especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Nome do canal
|
channel | True | string |
Canal, grupo privado ou canal de mensagens instantâneas para o qual enviar mensagens. Pode ser um nome(ex: #general) ou um ID codificado. |
|
Texto da mensagem
|
text | True | string |
Corpo da mensagem a enviar. A API do Slack truncará mensagens contendo mais de 40.000 caracteres. Para obter opções de formatação, consulte https://api.slack.com/docs/formatting |
|
Carimbo temporal da Mensagem Principal
|
thread_ts | string |
Carimbo temporal da mensagem principal ao publicar uma resposta num tópico. |
|
|
Transmissão para o canal
|
reply_broadcast | boolean |
Passa a ser verdadeiro para também enviar uma resposta em tópicos para o canal. |
|
|
Nome do Bot
|
username | string |
Nome do bot. |
|
|
Postar como usuário
|
as_user | boolean |
Passe true para postar a mensagem como o usuário autenticado, em vez de como um bot. |
|
|
Modo de análise
|
parse | string |
Altere a forma como as mensagens são tratadas. Para obter detalhes, consulte https://api.slack.com/docs/formatting |
|
|
Análise de marcação Slack
|
mrkdwn | boolean |
Configuração de análise de marcação do Slack. Ativado por padrão. |
|
|
Nomes de links
|
link_names | integer |
Encontre e vincule nomes de canais e nomes de usuário. |
|
|
Unfral Links
|
unfurl_links | boolean |
Passe true para permitir o desfraldar de conteúdo baseado principalmente em texto. |
|
|
Mídia Unfral
|
unfurl_media | boolean |
Passe false para desativar o desfraldar de conteúdo de mídia. |
|
|
URL do ícone
|
icon_url | uri |
URL para uma imagem a ser usada como ícone para esta mensagem. |
|
|
Ícone Emoji
|
icon_emoji | string |
Emoji para usar como um ícone para esta mensagem. |
Devoluções
Detalhes da mensagem publicada em um canal do Slack.
- Body
- PostMessageResponse
Postar mensagem [DEPRECATED]
Esta ação foi preterida. Em vez disso, use a mensagem Post (V2).
Esta operação é usada para postar uma mensagem para o canal especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Nome do canal
|
channel | True | string |
Canal, grupo privado ou canal de mensagens instantâneas para o qual enviar mensagens. Pode ser um nome(ex: #general) ou um ID codificado. |
|
Texto da mensagem
|
text | True | string |
Corpo da mensagem a enviar (menos de 4000 caracteres). Para obter opções de formatação, consulte https://api.slack.com/docs/formatting. |
|
Nome do Bot
|
username | string |
Nome do bot. |
|
|
Postar como usuário
|
as_user | boolean |
Passe true para postar a mensagem como o usuário autenticado, em vez de como um bot. |
|
|
Modo de análise
|
parse | string |
Altere a forma como as mensagens são tratadas. Para obter detalhes, consulte https://api.slack.com/docs/formatting. |
|
|
Nomes de links
|
link_names | integer |
Encontre e vincule nomes de canais e nomes de usuário. |
|
|
Unfral Links
|
unfurl_links | boolean |
Passe true para permitir o desfraldar de conteúdo baseado principalmente em texto. |
|
|
Mídia Unfral
|
unfurl_media | boolean |
Passe false para desativar o desfraldar de conteúdo de mídia. |
|
|
URL do ícone
|
icon_url | uri |
URL para uma imagem a ser usada como ícone para esta mensagem. |
|
|
Ícone Emoji
|
icon_emoji | string |
Emoji para usar como um ícone para esta mensagem. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Resultado de Sucesso
|
ok | boolean |
Indica se a operação foi bem-sucedida. |
|
Channel
|
channel | string |
O canal no qual a mensagem foi postada. |
|
Criado Date-Time
|
ts | string |
aaaa-MM-ddTHH:mm:ss.fffZ |
|
Texto da mensagem
|
message.text | string |
Corpo da mensagem. |
|
ID da mensagem
|
message.id | string |
Identificador exclusivo da mensagem. |
|
ID do criador
|
message.user | string |
Identificador exclusivo do usuário que publicou a mensagem. |
|
Tempo de Criação
|
message.created | integer |
Carimbo de data/hora Unix para quando a mensagem é criada. |
|
É suprimido
|
message.is_user-deleted | boolean |
Se a mensagem foi ou não apagada. |
|
Mensagens de erro
|
error | string |
Detalhes das mensagens de erro, se houver. |
Respostas às mensagens da lista (Pré-visualização)
Liste as respostas num tópico de mensagens, incluindo a mensagem principal.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
ID da Conversação
|
channel | True | string |
A conversa que continha o fio. |
|
Carimbo temporal da Mensagem Principal
|
ts | True | string |
Carimbo temporal da mensagem pai que inicia o tópico. Disponível como campo |
|
Resultados Máximos
|
limit | integer |
O número máximo de mensagens a devolver por página. |
|
|
Carimbo temporal mais antigo
|
oldest | string |
Apenas mensagens após este carimbo temporal Unix serão incluídas nos resultados. |
|
|
Carimbo de data/hora mais recente
|
latest | string |
Apenas mensagens anteriores a este carimbo temporal Unix serão incluídas nos resultados. |
|
|
Inclusivo
|
inclusive | boolean |
Inclua mensagens com os carimbos temporais mais antigos ou mais recentes nos resultados. |
Devoluções
Acionadores
| Quando um arquivo é criado |
Quando um arquivo é criado |
Quando um arquivo é criado
Quando um arquivo é criado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Channel
|
channel | True | string |
O nome do canal. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Id
|
id | string |
ID do ficheiro |
|
Criado
|
created | integer |
Quando o arquivo foi criado. |
|
Nome
|
name | string |
O nome do arquivo. |
|
Title
|
title | string |
O título do ficheiro. |
Definições
Channel
O Canal
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Id
|
id | string |
O id do canal. |
|
Nome
|
name | string |
O nome do canal. |
|
Is Public Channel
|
is_channel | boolean |
Se esta conversa é um canal público. |
|
É um canal privado
|
is_group | boolean |
Se esta conversa é um canal privado. |
|
É Mensagem Direta
|
is_im | boolean |
Se esta conversa é uma mensagem direta entre dois utilizadores. |
|
É Mensagem Direta em Grupo
|
is_mpim | boolean |
Se esta conversa é uma mensagem direta de grupo. |
|
É privado
|
is_private | boolean |
Se esta conversa é privada. |
|
Está arquivado
|
is_archived | boolean |
Se esta conversa foi arquivada. |
|
É Membro
|
is_member | boolean |
Se o utilizador autenticado faz parte desta conversa. |
|
ID do Utilizador
|
user | string |
Para mensagens diretas, o ID do outro utilizador na conversa. |
|
Contagem de Membros
|
num_members | integer |
O número de membros nesta conversa. |
ListChannels_Response
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
channels
|
channels | array of Channel | |
|
Cursor seguinte
|
response_metadata.next_cursor | string |
Cursor para passar para o próximo pedido. Vazio quando já não há mais resultados. |
ListChannels_ResponseV3
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
valor
|
value | array of Channel |
SlackMessage
Uma mensagem publicada numa conversa no Slack.
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
ID da mensagem
|
ts | string |
Identificador único de carimbo temporal da mensagem. |
|
ID do autor
|
user | string |
O ID do utilizador que publicou a mensagem. Use Obter perfil de utilizador para resolver isto para um utilizador. |
|
Texto da mensagem
|
text | string |
Corpo da mensagem. |
|
Tipo de mensagem
|
type | string |
Tipo de mensagem. |
|
Thread Id
|
thread_ts | string |
O carimbo temporal da mensagem pai, se esta mensagem fizer parte de um fio. |
|
Contagem de respostas
|
reply_count | integer |
O número de respostas a esta mensagem, se iniciar um tópico. |
ListMessages_Response
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
valor
|
value | array of SlackMessage |
SlackUserProfile
Detalhes adicionais do perfil para um utilizador do Slack.
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Nome de Exibição
|
display_name | string |
O nome de exibição que o utilizador escolheu para o seu perfil. |
|
Nome verdadeiro
|
real_name | string |
O primeiro e apelido do utilizador. |
|
Email
|
string |
O endereço de correio eletrónico do utilizador. |
|
|
Avatar Url
|
image_72 | string |
URL de uma versão de 72x72 píxeis do avatar do utilizador. |
SlackUser
Um utilizador do Slack.
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Id
|
id | string |
O id do usuário. |
|
Nome de utilizador
|
name | string |
O nome de utilizador do utilizador no Slack. |
|
Nome verdadeiro
|
real_name | string |
O primeiro e apelido do utilizador. |
|
É Bot
|
is_bot | boolean |
Se o utilizador é um bot. |
|
É desativado
|
deleted | boolean |
Se a conta do utilizador foi desativada. |
|
Fuso Horário
|
tz | string |
O fuso horário legível para humanos do utilizador. |
|
Profile
|
profile | SlackUserProfile |
Detalhes adicionais do perfil para um utilizador do Slack. |
GetUserProfile_Response
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Resultado de Sucesso
|
ok | boolean |
Indica se a operação foi bem-sucedida. |
|
Utilizador
|
user | SlackUser |
Um utilizador do Slack. |
|
Mensagens de erro
|
error | string |
Detalhes das mensagens de erro, se houver. |
CreateChannel_Response
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Channel
|
channel | Channel |
O Canal |
JoinChannel_Response
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Já no canal
|
already_in_channel | boolean |
Se o usuário já está no canal ou não. |
|
Channel
|
channel | Channel |
O Canal |
JoinChannel_ResponseV2
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Channel
|
channel | Channel |
O Canal |
|
Advertência
|
warning | string |
Se o usuário já está no canal ou não. |
PostMessageResponse
Detalhes da mensagem publicada em um canal do Slack.
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Resultado de Sucesso
|
ok | boolean |
Indica se a operação foi bem-sucedida. |
|
Channel
|
channel | string |
O canal no qual a mensagem foi postada. |
|
Tempo de Criação
|
ts | string |
Carimbo de data/hora Unix para quando a mensagem foi criada. |
|
Tipo de mensagem
|
message.type | string |
Tipo de mensagem. |
|
Texto da mensagem
|
message.text | string |
Corpo da mensagem. |
|
Tempo de Criação
|
message.ts | string |
Carimbo de data/hora Unix para quando a mensagem foi criada. |
|
Mensagens de erro
|
error | string |
Detalhes das mensagens de erro, se houver. |