Slack

Visão geral

Slack é uma plataforma de mensagens baseada em canais que conecta equipes e ferramentas em um único ambiente. Com a integração Slack no SquadOS, seus agentes podem enviar e ler mensagens, criar e arquivar canais, fazer buscas em conversas, fazer upload de arquivos e gerenciar usuários — tudo de forma programática, sem intervenção manual.

• Site oficial: https://slack.com/
• Documentação na Composio: docs.composio.dev/toolkits/slack

Autenticação

Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar.

A autenticação é gerenciada pela Composio via fluxo OAuth hospedado. Você autoriza o acesso ao seu workspace Slack na página de conexão segura da Composio — nenhuma chave de API manual é necessária.

Campo	Obrigatório	Descrição
oauth_token	Sim	Token OAuth gerado automaticamente pelo fluxo de autorização do Slack. Gerenciado pela Composio.

Como obter a credencial

1. Acesse Ferramentas no menu lateral (/admin/tools), abra a aba Disponíveis e clique no card do Slack.
2. Clique em Conectar — você será redirecionado para a página de autorização segura da Composio.
3. Clique em Allow (Permitir) para autorizar o acesso da Composio ao seu workspace Slack.
4. Após a autorização, você volta ao SquadOS com a conta Slack conectada.

Dica

Para usar credenciais OAuth próprias (app Slack personalizado), consulte o guia How to create OAuth credentials for Slack na Composio. Isso é recomendado para workspaces com políticas de aprovação de apps.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Slack.
3. Clique no card para abrir o modal de detalhes e em Conectar.
4. Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso (OAuth) ao seu workspace Slack.
5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Perguntas frequentes

O que faz a integração Composio + Slack?

A Composio transforma a API do Slack em ferramentas prontas para uso por agentes de IA e automações. Com a integração você pode enviar e ler mensagens, gerenciar canais, fazer upload de arquivos, reagir a eventos, pesquisar conversas e muito mais. A Composio oferece dois toolkits: Slack (autenticação como usuário para ações no nível do workspace) e Slackbot (autenticação como bot para mensagens em canais, menções a apps e slash commands).

Preciso ser Workspace Owner para instalar?

Em alguns casos, sim. Para apps fora do Slack Marketplace, você precisará ser owner para instalar diretamente. Como membro, você precisará solicitar aprovação ou pedir ao owner que desabilite a exigência de apps aprovados.

Por que estou sendo solicitado a enviar uma solicitação durante a autenticação?

Porque Require approved apps está habilitado nas configurações do workspace. O Slack está pedindo aprovação de admin/owner antes de concluir a instalação. Consulte o guia da Composio para usar credenciais OAuth próprias como alternativa.

Qual a diferença entre os toolkits Slack e Slackbot?

O toolkit Slack é para acesso à API no nível do workspace (canais, arquivos, usuários) e pode postar como o app. O toolkit Slackbot é centrado em bot (mensagens, interatividade) e posta como o usuário bot. Os triggers do Slack cobrem eventos do workspace; o Slackbot cobre pontos de entrada do bot como menções a apps, DMs e slash commands.

O que faz o parâmetro as_user nas ferramentas Slack?

Para o toolkit Slack, defina as_user=true para postar como o usuário autenticado. Para o Slackbot, deixe em branco (padrão false). Um erro missing_charset geralmente indica as_user inválido, ID de canal incorreto ou campos obrigatórios ausentes.

Ações disponíveis

Nota

Esta integração expõe 150 ações no total. Abaixo estão as principais; a lista completa está na documentação da Composio.

Enviar mensagem

SLACK_SEND_MESSAGE

Posta uma mensagem em um canal Slack, DM ou grupo privado. Forneça exatamente um modo de conteúdo visível: markdown_text para conteúdo Markdown normal, ou blocks para layouts Slack Block Kit brutos. Use fallback_text apenas com blocks. Não é idempotente — chamadas duplicadas postam mensagens duplicadas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
channel	string	Sim	ID ou nome do canal, grupo privado ou canal IM para enviar a mensagem. Não inclua o prefixo ’#’. Para DMs, use o ID do canal retornado por SLACK_OPEN_DM.
markdown_text	string	Não	Use para conteúdo de mensagem normal escrito por LLM. Passe Markdown padrão; suporta títulos, negrito, itálico, links, listas, código, citações, divisores e tabelas.
blocks	array	Não	Use apenas quando precisar de capacidades do Slack Block Kit que o Markdown não suporta: botões, menus de seleção, checkboxes, seletores de data/hora, etc. Não use junto com markdown_text.
thread_ts	string	Não	Timestamp (ts) de uma mensagem existente para tornar esta uma resposta em thread.
fallback_text	string	Não	Obrigatório apenas ao usar blocks. Texto simples para notificações e clientes que não renderizam blocks.
unfurl_links	boolean	Não	Habilita o desdobramento de URLs baseadas em texto.
unfurl_media	boolean	Não	Habilita pré-visualizações de mídia de URLs.
reply_broadcast	boolean	Não	Se true para uma resposta em thread, também posta no canal principal.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Enviar mensagem (legado)

SLACK_CHAT_POST_MESSAGE

(DESCONTINUADO: use SLACK_SEND_MESSAGE) Posta uma mensagem em um canal Slack, DM ou grupo privado. Requer pelo menos um campo de conteúdo (markdown_text, text, blocks ou attachments). Limite de corpo de ~4000 caracteres. Taxa limitada em ~1 req/seg.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
channel	string	Sim	ID ou nome do canal, grupo privado ou canal IM.
markdown_text	string	Não	PREFERIDO: Escreva sua mensagem em markdown para exibição formatada.
text	string	Não	DESCONTINUADO: Envia texto simples apenas; use o campo markdown_text.
blocks	string	Não	DESCONTINUADO: Use o campo markdown_text. Blocks do Block Kit como string JSON.
thread_ts	string	Não	Timestamp de uma mensagem existente para resposta em thread.
link_names	boolean	Não	Vincula automaticamente nomes de canais e usuários no texto.
unfurl_links	boolean	Não	Habilita o desdobramento de URLs.
unfurl_media	boolean	Não	Habilita pré-visualizações de mídia.
reply_broadcast	boolean	Não	Se true para resposta em thread, posta no canal principal também.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Agendar mensagem

SLACK_SCHEDULE_MESSAGE

Agenda uma mensagem para um canal, DM ou grupo privado Slack em um horário futuro (post_at). Limite de agendamento de 120 dias no futuro.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
channel	string	Não	ID ou nome do canal (ex.: C1234567890). O bot deve ser membro do canal alvo.
post_at	string	Não	Timestamp Unix EPOCH (segundos inteiros desde 1970-01-01 00:00:00 UTC) para o horário futuro de envio.
markdown_text	string	Não	PREFERIDO: Escreva sua mensagem agendada em markdown.
text	string	Não	Texto principal da mensagem; use markdown_text para formatação.
thread_ts	string	Não	Timestamp da mensagem pai para resposta em thread agendada.
unfurl_links	boolean	Não	Desativa o desdobramento automático de links se false.
unfurl_media	boolean	Não	Desativa o desdobramento automático de mídia se false.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Enviar mensagem efêmera

SLACK_SEND_EPHEMERAL_MESSAGE

Envia uma mensagem efêmera visível apenas para o user especificado em um canal; outros membros do canal não podem vê-la. Tanto o bot quanto o usuário alvo devem ser membros do canal especificado.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
user	string	Sim	ID do usuário para enviar a mensagem efêmera.
channel	string	Sim	Canal, grupo privado ou DM para enviar a mensagem.
markdown_text	string	Não	PREFERIDO: Escreva sua mensagem efêmera em markdown. Máximo de 12.000 caracteres.
text	string	Não	Texto da mensagem. Obrigatório a menos que blocks ou attachments seja fornecido.
thread_ts	string	Não	Timestamp de uma mensagem pai para tornar esta uma resposta.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar canal

SLACK_CREATE_CHANNEL

Inicia uma conversa baseada em canal pública ou privada em um workspace Slack. Cria o canal imediatamente; invoque apenas após confirmação explícita do usuário.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome do canal público ou privado a criar. Deve ser minúsculo, único e sem espaços ou pontos; máximo de 80 caracteres.
is_private	boolean	Não	Criar um canal privado em vez de um público.
team_id	string	Não	ID do time codificado para criar o canal, obrigatório se usar token org.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Excluir canal

SLACK_DELETE_CHANNEL

Exclui permanente e irreversivelmente um canal público ou privado especificado, incluindo todas as suas mensagens e arquivos, em uma organização Slack Enterprise Grid.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
channel_id	string	Sim	ID do canal a ser excluído permanentemente.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Arquivar conversa

SLACK_ARCHIVE_CONVERSATION

Arquiva uma conversa Slack pelo seu ID, tornando-a somente leitura e ocultada enquanto retém o histórico. Ideal para limpar canais inativos; observe que alguns canais (como #general ou certos DMs) não podem ser arquivados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
channel	string	Não	ID da conversa Slack a arquivar.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Desarquivar canal

SLACK_UNARCHIVE_CHANNEL

Reverte o arquivamento de uma conversa.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
channel	string	Sim	ID da conversa a desarquivar.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Renomear conversa

SLACK_RENAME_CONVERSATION

Renomeia um canal Slack, ajustando automaticamente o novo nome para atender às convenções de nomenclatura (ex.: conversão para minúsculas), o que pode afetar integrações que usam o nome antigo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
channel	string	Não	ID da conversa (canal) a renomear.
name	string	Não	Novo nome para a conversa. Deve ter 80 caracteres ou menos e conter apenas letras minúsculas, números, hífens e underscores.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar todos os canais

SLACK_LIST_ALL_CHANNELS

Lista conversas disponíveis para o usuário com filtros e opções de busca variados. Sempre use channel_id resolvidos (não nomes de exibição) para operações subsequentes, pois os nomes podem não ser únicos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
limit	integer	Não	Número máximo de canais a retornar por página (1 a 1000).
types	string	Não	Lista separada por vírgulas de tipos de conversa: public_channel, private_channel, im, mpim. Padrão: public_channel.
cursor	string	Não	Cursor de paginação (de next_cursor de uma resposta anterior).
team_id	string	Não	ID do time codificado para listar canais. Obrigatório com token org.
exclude_archived	boolean	Não	Exclui canais arquivados se true.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar conversas

SLACK_LIST_CONVERSATIONS

Lista conversas (canais/DMs) acessíveis a um usuário especificado (ou ao usuário autenticado se nenhum ID de usuário for fornecido). Retorna IDs de conversa (C* para canais, G* para DMs em grupo), não nomes de exibição.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
user	string	Não	ID do usuário cujas conversas serão listadas. Se não fornecido, retorna conversas do usuário autenticado.
limit	integer	Não	Número máximo de itens a retornar por página.
types	string	Não	Lista separada por vírgulas de tipos de conversa a incluir: public_channel, private_channel, im, mpim.
cursor	string	Não	Cursor de paginação para recuperar o próximo conjunto de resultados.
team_id	string	Não	ID do time para filtrar conversas.
exclude_archived	boolean	Não	Define como true para excluir canais arquivados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Buscar histórico de conversa

SLACK_FETCH_CONVERSATION_HISTORY

Busca uma lista cronológica de mensagens e eventos de uma conversa Slack especificada. LIMITAÇÃO IMPORTANTE: esta ação retorna apenas mensagens da linha do tempo principal do canal. Respostas em thread NÃO são retornadas — use SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION para isso.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
channel	string	Sim	ID do canal público, privado, mensagem direta ou multi-pessoa do qual buscar o histórico.
limit	integer	Não	Número máximo de mensagens a solicitar nesta chamada (1-1000). Padrão: 100.
cursor	string	Não	Cursor de paginação de response_metadata.next_cursor de uma resposta anterior.
oldest	string	Não	Início do intervalo de tempo das mensagens. Aceita timestamp Unix ou timestamp Slack.
latest	string	Não	Fim do intervalo de tempo das mensagens.
inclusive	boolean	Não	Quando true, inclui mensagens nos timestamps exatos de oldest ou latest.
include_all_metadata	boolean	Não	Retorna todos os metadados associados às mensagens.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Recuperar respostas de conversa

SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION

Recupera respostas a uma mensagem pai específica em uma conversa Slack, usando o ID do canal e o timestamp da mensagem pai (ts).

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
channel	string	Não	ID da conversa para buscar a thread. Deve ser um ID de canal, não um nome.
ts	string	Não	Timestamp da mensagem pai na thread. Deve ser a string de timestamp exata da mensagem raiz/pai.
limit	integer	Não	Número máximo de mensagens a retornar.
cursor	string	Não	Cursor de paginação de response_metadata.next_cursor de uma resposta anterior.
oldest	string	Não	Timestamp mais antigo das mensagens a incluir nos resultados.
latest	string	Não	Timestamp mais recente das mensagens a incluir nos resultados.
inclusive	boolean	Não	Inclui mensagens com os timestamps de latest ou oldest nos resultados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Adicionar reação a mensagem

SLACK_ADD_REACTION_TO_AN_ITEM

Adiciona uma reação de emoji especificada a uma mensagem existente em um canal Slack, identificada pelo seu timestamp. Não remove nem recupera reações.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome do emoji a adicionar como reação (ex.: ‘thumbsup’). Nome sem dois-pontos. Para emojis com modificadores de tom de pele, acrescente ‘::skin-tone-X’.
channel	string	Sim	ID do canal onde a mensagem foi postada.
timestamp	string	Sim	Timestamp da mensagem à qual a reação será adicionada (ex.: ‘1234567890.123456’).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Remover reação de item

SLACK_REMOVE_REACTION_FROM_ITEM

Remove uma reação de emoji de uma mensagem, arquivo ou comentário de arquivo no Slack. Forneça exatamente um método de destino: channel+timestamp juntos, file ou file_comment.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome da reação de emoji a remover (ex.: ‘thumbsup’), sem dois-pontos.
channel	string	Não	ID do canal da mensagem. Obrigatório se timestamp for fornecido.
timestamp	string	Não	Timestamp da mensagem. Obrigatório se channel for fornecido.
file	string	Não	ID do arquivo para remover a reação.
file_comment	string	Não	ID do comentário do arquivo para remover a reação.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Fazer upload ou criar arquivo no Slack

SLACK_UPLOAD_OR_CREATE_A_FILE_IN_SLACK

Faz upload de arquivos, imagens, capturas de tela, documentos ou qualquer mídia para canais ou threads Slack. Suporta todos os tipos de arquivo incluindo imagens (PNG, JPG, JPEG, GIF), documentos (PDF, DOCX, TXT), arquivos de código e mais.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
file	string	Não	Arquivo(s) para upload. Pelo menos um de ‘content’ ou ‘file’ deve ser fornecido.
content	string	Não	Conteúdo de texto do arquivo; use para arquivos baseados em texto.
channels	string	Não	ID do canal onde o arquivo será compartilhado. Use ID do canal (ex.: C1234567890), não o nome.
title	string	Não	Título do arquivo, exibido no Slack.
filename	string	Não	Nome do arquivo a exibir no Slack. Obrigatório ao usar o parâmetro ‘content’.
thread_ts	string	Não	Timestamp de uma mensagem pai para fazer upload como resposta.
initial_comment	string	Não	Mensagem opcional para introduzir o arquivo nos ‘channels’ especificados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar arquivos do Slack

SLACK_LIST_FILES_WITH_FILTERS_IN_SLACK

Lista arquivos e seus metadados em um workspace Slack, filtráveis por usuário, canal, timestamp ou tipo. Retorna apenas metadados, não o conteúdo do arquivo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
channel	string	Não	Filtra arquivos que aparecem em um canal específico, indicado pelo seu ID.
user	string	Não	Filtra arquivos criados por um único usuário. Forneça o ID de usuário Slack.
types	string	Não	Filtra por tipo de arquivo (separado por vírgulas): all, spaces, snippets, images, pdfs, gdocs, zips. Padrão: ‘all’.
ts_from	integer	Não	Filtra arquivos criados após este timestamp Unix (inclusivo).
ts_to	integer	Não	Filtra arquivos criados antes deste timestamp Unix (inclusivo).
count	string	Não	Número de arquivos a retornar por página. Padrão: 100, máximo: 1000.
page	string	Não	Número da página dos resultados ao paginar. Padrão: 1.
team_id	string	Não	ID do time/workspace. Obrigatório para workspaces Enterprise Grid.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar todos os usuários

SLACK_LIST_ALL_USERS

Recupera uma lista paginada de todos os usuários com detalhes de perfil, status e memberships de time em um workspace Slack. Filtre os campos is_bot, is_app_user e deleted para construir listas apenas de humanos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
limit	integer	Não	Número máximo de itens a retornar por página. Recomendado definir um valor (ex.: 100).
cursor	string	Não	Cursor de paginação para buscar páginas subsequentes.
team_id	string	Não	ID do workspace/time. Obrigatório ao usar token org (Enterprise Grid).
include_locale	boolean	Não	Inclui o campo locale para cada usuário. Padrão: false.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Buscar usuários

SLACK_FIND_USERS

Busca usuários em um workspace Slack por qualquer critério — e-mail, nome, nome de exibição ou outro texto. Inclui busca otimizada por e-mail para correspondências exatas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
search_query	string	Não	Consulta de busca para encontrar usuários. Pode ser um ID de usuário Slack, endereço de e-mail ou nome. Obrigatório se email não for fornecido.
email	string	Não	Endereço de e-mail para buscar. Parâmetro de conveniência para busca baseada em e-mail.
limit	integer	Não	Número máximo de usuários a retornar (1 a 1000). Padrão: 50.
exact_match	boolean	Não	Quando true, retorna apenas usuários com correspondências exatas (sem distinção de maiúsculas/minúsculas).
include_bots	boolean	Não	Inclui usuários bot nos resultados. Padrão: false.
team_id	string	Não	ID do workspace Slack. Obrigatório com token org.
include_deleted	boolean	Não	Inclui usuários excluídos/desativados. Padrão: false.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Buscar usuários por e-mail

SLACK_FIND_USER_BY_EMAIL_ADDRESS

Recupera o objeto de usuário Slack de um usuário ativo pelo seu endereço de e-mail registrado. Requer o escopo OAuth users:read.email. Falha com ‘users_not_found’ se o e-mail não estiver registrado ou o usuário estiver inativo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
email	string	Sim	O endereço de e-mail do usuário a buscar.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Convidar usuários para canal Slack

SLACK_INVITE_USERS_TO_A_SLACK_CHANNEL

Convida usuários para um canal Slack existente usando seus IDs de usuário Slack válidos. A resposta é sempre HTTP 200; inspecione os campos ok, error e errors para confirmar que os usuários foram adicionados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
channel	string	Não	ID do canal público ou privado Slack para convidar usuários; deve ser um canal existente.
users	string	Não	String de IDs de usuário Slack válidos separados por vírgula. Até 1000 IDs de usuário.
force	boolean	Não	Quando true e múltiplos IDs são fornecidos, continua convidando os válidos ignorando os inválidos.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Remover usuário de conversa

SLACK_REMOVE_USER_FROM_CONVERSATION

Remove um usuário especificado de uma conversa Slack (canal). O chamador deve ter permissões para remover usuários e não pode se remover usando esta ação.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
channel	string	Não	ID da conversa (canal) para remover o usuário.
user	string	Não	O ID do usuário a ser removido da conversa.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar mensagem Slack

SLACK_UPDATES_A_SLACK_MESSAGE

Atualiza uma mensagem Slack pelo timestamp. Forneça exatamente um modo de conteúdo visível: markdown_text para conteúdo Markdown normal, ou blocks para layouts Slack Block Kit brutos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
ts	string	Sim	Timestamp da mensagem a atualizar (ex.: '1234567890.123456').
channel	string	Sim	ID ou nome do canal, grupo privado ou canal IM contendo a mensagem a atualizar.
markdown_text	string	Não	Use para conteúdo de mensagem atualizado normal. Suporta Markdown padrão.
blocks	array	Não	Use quando precisar de capacidades do Slack Block Kit. Não use junto com markdown_text.
fallback_text	string	Não	Obrigatório apenas ao usar blocks. Texto simples para notificações.
as_user	boolean	Não	Passe true para atualizar a mensagem como o usuário autenticado.
reply_broadcast	boolean	Não	Se true e a mensagem for uma resposta em thread, transmite a mensagem atualizada para o canal.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Excluir mensagem do chat

SLACK_DELETES_A_MESSAGE_FROM_A_CHAT

Exclui uma mensagem, identificada pelo ID do canal e timestamp, de um canal Slack, grupo privado ou conversa de mensagem direta. O usuário autenticado ou bot deve ser o autor original.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
channel	string	Não	O ID do canal, grupo privado ou conversa de mensagem direta que contém a mensagem a excluir.
ts	string	Não	Timestamp da mensagem a excluir. Deve ser a string exata do timestamp Slack com precisão fracionária (ex.: ‘1234567890.123456’).
as_user	boolean	Não	Parâmetro legado. Passe true para excluir a mensagem como o usuário autenticado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Buscar mensagens

SLACK_SEARCH_MESSAGES

Busca mensagens em todo o workspace Slack com intervalos de datas e filtros. Use modificadores de query (ex.: in:#canal, from:@usuario, before/after:AAAA-MM-DD), ordenação (score/timestamp) e paginação.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
query	string	Sim	Consulta de busca com suporte a vários modificadores: in:#nome-canal, from:@usuario, "frase exata", before:AAAA-MM-DD, after:AAAA-MM-DD, has:link, has:file.
sort	string	Não	Ordena os resultados por score (relevância) ou timestamp (cronológico).
sort_dir	string	Não	Direção da ordenação: asc (crescente) ou desc (decrescente).
count	integer	Não	Número de mensagens por página (máx. 100). Com auto_paginate, total de mensagens desejadas.
page	integer	Não	Número da página para controle manual de paginação.
cursor	string	Não	Cursor para paginação por cursor. Use * para a primeira chamada.
highlight	boolean	Não	Habilita destaque dos termos de busca nos resultados.
auto_paginate	boolean	Não	Quando habilitado, count torna-se o total de mensagens desejadas e o sistema gerencia a paginação automaticamente.
team_id	string	Não	ID do workspace para buscar. Relevante apenas com token org.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.