Slack

O Slack é uma ferramenta de comunicação de equipe, que reúne todas as comunicações de sua equipe em um só lugar, instantaneamente pesquisáveis e disponíveis onde quer que você vá.

Esse conector está disponível nos seguintes produtos e regiões:

Service	Class	Regions
Copilot Studio	Standard	Todas as regiões do Power Automate , exceto as seguintes: - China Cloud operado pela 21Vianet
Aplicativos Lógicos	Standard	Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD)
Power Apps	Standard	Todas as regiões do Power Apps , exceto as seguintes: - China Cloud operado pela 21Vianet
Power Automate	Standard	Todas as regiões do Power Automate , exceto as seguintes: - China Cloud operado pela 21Vianet

Contato
Nome	Microsoft
URL	https://support.microsoft.com/contactus

Metadados do conector
Publicador	Microsoft
Site	https://slack.com/
Política de privacidade	https://slack.com/privacy-policy
Categories	Colaboração; Comunicação

Problemas e limitações conhecidos

De acordo com a documentação da API do Slack, alguns métodos de API do Slack usados pelo conector 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. Portanto, 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 em uma mensagem é limitado a 4000. Para obter mais detalhes, consulte a documentação oficial do Slack.

Conector aprofundado

Para obter mais informações sobre o conector, consulte a seção detalhada.

Limitações

Nome	Chamadas	Período de renovação
Chamadas à API por conexão	100	60 segundos
Frequência das pesquisas de gatilho	1	120 segundos

Ações

Criar um canal	Crie um canal com folga.
Criar um canal [PRETERIDO]	Esta ação foi preterida. Em vez disso, use Criar um canal . ~~Crie um canal com folga.~~
Criar um grupo [PRETERIDO]	Cria um grupo com margem de atraso.
Definir não incomodar	Defina o status de não incomodar para o usuário.
Ingressar em um canal [PRETERIDO]	Esta ação foi preterida. Em vez disso, use Ingressar em um canal público . ~~Ingresse em um canal com folga.~~
Ingressar em um canal público	Ingresse em um canal público com folga.
Listar canais [PRETERIDO]	Esta ação foi preterida. Em vez disso, use canais públicos de lista (suporte à paginação ). ~~Liste os canais com folga.~~
Listar canais públicos	Liste os canais públicos com folga.
Listar canais públicos (suporte à paginação) (versão prévia)	Liste os canais públicos com folga.
Listar mensagens de conversa (versão prévia)	Liste as mensagens postadas em uma conversa (canal público, canal privado, mensagem direta ou mensagem direta de grupo).
Listar respostas de mensagem (versão prévia)	Liste as respostas em um thread de mensagem, incluindo a mensagem pai.
Obter o perfil do usuário (versão prévia)	Obtenha informações de perfil para um usuário do Slack. Útil para resolver o autor de uma mensagem retornada por mensagens de conversa de lista ou respostas de mensagem de lista.
Postar mensagem (V2)	Essa operação é usada para postar uma mensagem no canal especificado.
Postar mensagem [PRETERIDO]	Esta ação foi preterida. Em vez disso, use a Mensagem de Postagem (V2 ). ~~Essa operação é usada para postar uma mensagem no canal especificado.~~

Criar um canal

ID da operação:: CreateChannel_V2

Crie um canal com folga.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome	name		string	O nome do novo canal.
O canal privado é?	is_private		boolean	O canal é privado ou não

Retornos

Corpo: CreateChannel_Response

Criar um canal [PRETERIDO]

ID da operação:: CreateChannel

Esta ação foi preterida. Em vez disso, use Criar um canal .

~~Crie um canal com folga.~~

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome	name		string	O nome do novo canal.

Retornos

Corpo: CreateChannel_Response

Criar um grupo [PRETERIDO]

ID da operação:: CreateGroup

Cria um grupo com margem de atraso.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome	name		string	O nome do grupo.

Retornos

Nome	Caminho	Tipo	Description
ID	group.id	string	A ID do grupo.
Nome	group.name	string	O nome do grupo.

Definir não incomodar

ID da operação:: SetDND

Defina o status de não incomodar para o usuário.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Número de minutos	num_minutes		string	O número de minutos a serem definidos não incomoda.

Retornos

Nome	Caminho	Tipo	Description
Soneca Habilitada	snooze_enabled	boolean	Se o soneca está habilitado.

Ingressar em um canal [PRETERIDO]

ID da operação:: JoinChannel

Esta ação foi preterida. Em vez disso, use Ingressar em um canal público .

~~Ingresse em um canal com folga.~~

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome	name		string	O nome do canal.

Retornos

Corpo: JoinChannel_Response

Ingressar em um canal público

ID da operação:: JoinChannel_V2

Ingresse em um canal público com folga.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome do Canal	channel		string	O nome do canal.

Retornos

Corpo: JoinChannel_ResponseV2

Listar canais [PRETERIDO]

ID da operação:: ListChannels

Esta ação foi preterida. Em vez disso, use canais públicos de lista (suporte à paginação ).

~~Liste os canais com folga.~~

Retornos

Corpo: ListChannels_Response

Listar canais públicos

ID da operação:: ListChannels_V2

Liste os canais públicos com folga.

Parâmetros

Nome	Chave	Tipo	Description
Tipos de conversa	types	string	Tipos de conversa separados por vírgula a serem incluídos. O padrão é public_channel. Inclua explicitamente private_channel, mensagens instantâneas ou mpim para listar outros tipos de conversa.
Excluir Arquivado	exclude_archived	boolean	Defina como true para excluir conversas arquivadas.
Resultados máximos	limit	integer	O número máximo de conversas a serem retornadas.
ID da equipe	team_id	string	ID de equipe codificada. Necessário apenas para um token de toda a organização.
Cursor	cursor	string	Cursor de paginação retornado pela solicitação anterior.

Retornos

Corpo: ListChannels_Response

Listar canais públicos (suporte à paginação) (versão prévia)

ID da operação:: ListChannels_V3

Liste os canais públicos com folga.

Retornos

Corpo: ListChannels_ResponseV3

Listar mensagens de conversa (versão prévia)

ID da operação:: ListConversationMessages

Liste as mensagens postadas em uma conversa (canal público, canal privado, mensagem direta ou mensagem direta de grupo).

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID da Conversa	channel	True	string	A conversa da qual buscar mensagens.
Resultados máximos	limit		integer	O número máximo de mensagens a serem retornadas por página.
Carimbo de data/hora mais antigo	oldest		string	Somente as mensagens após esse carimbo de data/hora do Unix serão incluídas nos resultados.
Carimbo de data/hora mais recente	latest		string	Somente as mensagens antes desse carimbo de data/hora do Unix serão incluídas nos resultados.
Inclusivo	inclusive		boolean	Inclua mensagens com os carimbos de data/hora mais antigos ou mais recentes nos resultados.
Incluir todos os metadados	include_all_metadata		boolean	Retorne todos os metadados associados a cada mensagem.

Retornos

Corpo: ListMessages_Response

Listar respostas de mensagem (versão prévia)

ID da operação:: ListMessageReplies

Liste as respostas em um thread de mensagem, incluindo a mensagem pai.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID da Conversa	channel	True	string	A conversa que contém o thread.
Carimbo de data/hora da mensagem pai	ts	True	string	Carimbo de data/hora da mensagem pai que inicia o thread. Disponível como o `ts` campo em uma mensagem retornada por Listar mensagens de conversa.
Resultados máximos	limit		integer	O número máximo de mensagens a serem retornadas por página.
Carimbo de data/hora mais antigo	oldest		string	Somente as mensagens após esse carimbo de data/hora do Unix serão incluídas nos resultados.
Carimbo de data/hora mais recente	latest		string	Somente as mensagens antes desse carimbo de data/hora do Unix serão incluídas nos resultados.
Inclusivo	inclusive		boolean	Inclua mensagens com os carimbos de data/hora mais antigos ou mais recentes nos resultados.

Retornos

Corpo: ListMessages_Response

Obter o perfil do usuário (versão prévia)

ID da operação:: GetUserProfile

Obtenha informações de perfil para um usuário do Slack. Útil para resolver o autor de uma mensagem retornada por mensagens de conversa de lista ou respostas de mensagem de lista.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Id do usuário	user	True	string	A ID do usuário para o qual obter informações de perfil.

Retornos

Corpo: GetUserProfile_Response

Postar mensagem (V2)

ID da operação:: PostMessage_V2

Essa operação é usada para postar uma mensagem no canal especificado.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome do Canal	channel	True	string	Canal, grupo privado ou canal de mensagens instantâneas para o qual enviar mensagem. Pode ser um nome(ex: #general) ou uma ID codificada.
Texto da mensagem	text	True	string	Corpo da mensagem a ser enviada. A API do Slack truncará mensagens que contêm mais de 40.000 caracteres. Para opções de formatação, consulte https://api.slack.com/docs/formatting
Carimbo de data/hora da mensagem pai	thread_ts		string	Carimbo de data/hora da mensagem pai ao postar uma resposta em um thread.
Transmissão para Canal	reply_broadcast		boolean	Passe true para também enviar uma resposta encadeada 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 do Slack	mrkdwn		boolean	Configuração de análise de marcação do Slack. Habilitado por padrão.
Nomes de link	link_names		integer	Localize e vincule nomes de canal e nomes de usuário.
Cancelar vínculos	unfurl_links		boolean	Passe true para habilitar a desenrolamento de conteúdo baseado em texto principalmente.
Mídia desenrolada	unfurl_media		boolean	Passe false para desabilitar a distribuição de conteúdo de mídia.
URL do ícone	icon_url		uri	URL para uma imagem a ser usada como um ícone para esta mensagem.
Ícone emoji	icon_emoji		string	Emoji a ser usado como um ícone para esta mensagem.

Retornos

Detalhes da mensagem postada em um canal do Slack.

Corpo: PostMessageResponse

Postar mensagem [PRETERIDO]

ID da operação:: PostMessage

Esta ação foi preterida. Em vez disso, use a Mensagem de Postagem (V2 ).

~~Essa operação é usada para postar uma mensagem no canal especificado.~~

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome do Canal	channel	True	string	Canal, grupo privado ou canal de mensagens instantâneas para o qual enviar mensagem. Pode ser um nome(ex: #general) ou uma ID codificada.
Texto da mensagem	text	True	string	Corpo da mensagem a ser enviada (menos de 4.000 caracteres). Para 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 link	link_names		integer	Localize e vincule nomes de canal e nomes de usuário.
Cancelar vínculos	unfurl_links		boolean	Passe true para habilitar a desenrolamento de conteúdo baseado em texto principalmente.
Mídia desenrolada	unfurl_media		boolean	Passe false para desabilitar a distribuição de conteúdo de mídia.
URL do ícone	icon_url		uri	URL para uma imagem a ser usada como um ícone para esta mensagem.
Ícone emoji	icon_emoji		string	Emoji a ser usado como um ícone para esta mensagem.

Retornos

Nome	Caminho	Tipo	Description
Resultado do êxito	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	yyyyy-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 postou a mensagem.
Hora de Criação	message.created	integer	Unix timestamp for when the message is created.
Está Excluído	message.is_user-deleted	boolean	Se a mensagem foi excluída ou não.
Mensagens de erro	error	string	Detalhes das mensagens de erro, se houver.

Gatilhos

Quando um arquivo é criado

ID da operação:: OnNewFile

Quando um arquivo é criado

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Channel	channel	True	string	O nome do canal.

Retornos

Nome	Caminho	Tipo	Description
ID	id	string	ID do arquivo
Criado	created	integer	Quando o arquivo foi criado.
Nome	name	string	O nome do arquivo.
Title	title	string	O título do arquivo.

Definições

Channel

O Canal

Nome	Caminho	Tipo	Description
ID	id	string	A ID do canal.
Nome	name	string	O nome do canal.
É Canal Público	is_channel	boolean	Se essa conversa é um canal público.
É Um Canal Privado	is_group	boolean	Se essa conversa é um canal privado.
É Mensagem Direta	is_im	boolean	Se essa conversa é uma mensagem direta entre dois usuários.
É Mensagem Direta do Grupo	is_mpim	boolean	Se essa conversa é uma mensagem direta de grupo.
É privado	is_private	boolean	Se essa conversa é privada.
É Arquivado	is_archived	boolean	Se essa conversa foi arquivada.
É Membro	is_member	boolean	Se o usuário autenticado é membro dessa conversa.
Id do usuário	user	string	Para mensagens diretas, a ID do outro usuário na conversa.
Contagem de Membros	num_members	integer	O número de membros nesta conversa.

ListChannels_Response

Nome	Caminho	Tipo	Description
canais	channels	array of Channel
Próximo Cursor	response_metadata.next_cursor	string	Cursor a ser passado para a próxima solicitação. Vazio quando não houver mais resultados.

ListChannels_ResponseV3

Nome	Caminho	Tipo	Description
value	value	array of Channel

SlackMessage

Uma mensagem postada em uma conversa do Slack.

Nome	Caminho	Tipo	Description
ID da mensagem	ts	string	Identificador de carimbo de data/hora exclusivo da mensagem.
ID do autor	user	string	A ID do usuário que postou a mensagem. Use Obter perfil de usuário para resolver isso para um usuário.
Texto da mensagem	text	string	Corpo da mensagem.
Tipo de Mensagem	type	string	Tipo da mensagem.
ID do tópico	thread_ts	string	O carimbo de data/hora da mensagem pai, se essa mensagem fizer parte de um thread.
Contagem de respostas	reply_count	integer	O número de respostas a essa mensagem, se ela iniciar um thread.

ListMessages_Response

Nome	Caminho	Tipo	Description
value	value	array of SlackMessage

SlackUserProfile

Detalhes adicionais do perfil para um usuário do Slack.

Nome	Caminho	Tipo	Description
Nome de exibição	display_name	string	O nome de exibição escolhido pelo usuário para seu perfil.
Nome Real	real_name	string	O nome e o sobrenome do usuário.
Email	email	string	O endereço de email do usuário.
Avatar Url	image_72	string	URL de uma versão de 72 x 72 pixels do avatar do usuário.

SlackUser

Um usuário do Slack.

Nome	Caminho	Tipo	Description
ID	id	string	A ID do usuário.
Nome de usuário	name	string	O nome de usuário do Slack do usuário.
Nome Real	real_name	string	O nome e o sobrenome do usuário.
É Bot	is_bot	boolean	Se o usuário é um bot.
Está desativado	deleted	boolean	Se a conta do usuário foi desativada.
Fuso horário	tz	string	O fuso horário legível humano do usuário.
Profile	profile	SlackUserProfile	Detalhes adicionais do perfil para um usuário do Slack.

GetUserProfile_Response

Nome	Caminho	Tipo	Description
Resultado do êxito	ok	boolean	Indica se a operação foi bem-sucedida.
User	user	SlackUser	Um usuário do Slack.
Mensagens de erro	error	string	Detalhes das mensagens de erro, se houver.

CreateChannel_Response

Nome	Caminho	Tipo	Description
Channel	channel	Channel	O Canal

JoinChannel_Response

Nome	Caminho	Tipo	Description
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	Description
Channel	channel	Channel	O Canal
Aviso	warning	string	Se o usuário já está no canal ou não.

PostMessageResponse

Detalhes da mensagem postada em um canal do Slack.

Nome	Caminho	Tipo	Description
Resultado do êxito	ok	boolean	Indica se a operação foi bem-sucedida.
Channel	channel	string	O canal no qual a mensagem foi postada.
Hora de Criação	ts	string	Unix timestamp for when the message was created.
Tipo de Mensagem	message.type	string	Tipo da mensagem.
Texto da mensagem	message.text	string	Corpo da mensagem.
Hora de Criação	message.ts	string	Unix timestamp for when the message was created.
Mensagens de erro	error	string	Detalhes das mensagens de erro, se houver.