Pular para o conteúdo

Slackbot

Slackbot

O Slackbot concede aos agentes acesso de leitura em todo um workspace Slack em nome do usuário que instalou a integração — permitindo pesquisar mensagens e arquivos, navegar pelo histórico de canais e threads, e consultar usuários por e-mail. Enquanto lê como o usuário, ele continua publicando e reagindo como bot, e ainda suporta mensagens diretas (DMs).

Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar.

Você vai precisar autorizar o acesso à sua conta Slack durante o fluxo de conexão hospedado pela Composio.

CampoObrigatórioDescrição
OAuth 2.0SimAutorização via conta Slack na página segura da Composio.
  1. Acesse Ferramentas no menu lateral (/admin/tools).
  2. Abra a aba Disponíveis e procure por Slackbot.
  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) à sua conta 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.)

SLACKBOT_SEND_MESSAGE

Publica 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.

NomeTipoObrigatórioDescrição
channelstringSimID ou nome do canal, grupo privado ou IM para enviar a mensagem. Não inclua o prefixo ’#’. Para DMs, use o ID de canal retornado por SLACKBOT_OPEN_DM.
markdown_textstringNãoUse para conteúdo de mensagem normal escrito por LLM. Suporta Markdown: cabeçalhos, negrito, itálico, links, listas, código, citações, divisores, tabelas.
blocksarrayNãoUse em vez de markdown_text somente quando precisar de capacidades do Slack Block Kit (botões, menus, checkboxes, etc.).
thread_tsstringNãoTimestamp de uma mensagem existente para fazer esta uma resposta em thread.
fallback_textstringNãoApenas ao usar blocks. Texto de fallback para notificações e acessibilidade.
unfurl_linksbooleanNãoHabilitar unfurling de URLs baseadas em texto.
unfurl_mediabooleanNãoHabilitar pré-visualizações de mídia de URLs.
reply_broadcastbooleanNãoSe true para uma resposta em thread, também publica no canal principal.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_FETCH_CONVERSATION_HISTORY

Recupera uma lista cronológica de mensagens e eventos de uma conversa Slack especificada, com opções de paginação e filtragem por intervalo de tempo. Atenção: apenas retorna mensagens da linha do tempo principal do canal; respostas em thread requerem SLACKBOT_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION.

NomeTipoObrigatórioDescrição
channelstringSimID do canal público, privado, DM ou multi-pessoa para buscar o histórico.
limitintegerNãoNúmero máximo de mensagens a retornar nesta chamada (1–1000). Padrão: 100.
cursorstringNãoCursor de paginação de response_metadata.next_cursor de uma resposta anterior.
oldeststringNãoInício do intervalo de tempo. Aceita timestamp Unix ou Slack.
lateststringNãoFim do intervalo de tempo. Aceita timestamp Unix ou Slack.
inclusivebooleanNãoQuando true, inclui mensagens nos timestamps exatos de oldest ou latest.
include_all_metadatabooleanNãoRetornar todos os metadados associados às mensagens.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION

Recupera as respostas de uma mensagem pai específica em uma conversa Slack, usando o ID do canal e o timestamp da mensagem pai. Se o array de mensagens retornar menos respostas do que o reply_count indica, verifique paginação ou permissões.

NomeTipoObrigatórioDescrição
channelstringNãoID da conversa para buscar a thread. Deve ser ID de canal, não nome.
tsstringNãoTimestamp da mensagem pai da thread. Deve ser a string de timestamp completa da mensagem raiz.
limitintegerNãoNúmero máximo de mensagens a retornar.
cursorstringNãoCursor de paginação de response_metadata.next_cursor.
oldeststringNãoTimestamp mais antigo do intervalo de tempo.
lateststringNãoTimestamp mais recente do intervalo de tempo.
inclusivebooleanNãoIncluir mensagens nos timestamps de oldest ou latest.
include_all_metadatabooleanNãoRetornar todos os metadados das mensagens.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_FIND_CHANNELS

Encontra canais em um workspace Slack por qualquer critério — nome, tópico, propósito ou descrição. Retorna IDs de canal (prefixo C*/G*) necessários pela maioria das ferramentas Slack.

NomeTipoObrigatórioDescrição
querystringSimConsulta de busca para encontrar canais. Busca por nome, tópico, propósito e descrição (correspondência parcial sem distinção de maiúsculas/minúsculas).
limitintegerNãoNúmero máximo de canais a retornar (1 a 999). Padrão: 50.
typesstringNãoLista separada por vírgulas de tipos de canal: public_channel, private_channel, mpim, im.
team_idstringNãoID do workspace ao usar token de nível organizacional.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_SEARCH_MESSAGES

Pesquisa 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 e paginação.

NomeTipoObrigatórioDescrição
querystringSimConsulta de busca com suporte a modificadores para filtragem precisa. Ex.: "atualização do projeto" on:2025-09-25 in:#marketing from:@joao.
sortstringNãoOrdenar por score (relevância) ou timestamp (cronológico).
sort_dirstringNãoDireção da ordenação: asc ou desc.
countintegerNãoNúmero de mensagens por página (máx. 100).
cursorstringNãoCursor de paginação; use * na primeira chamada, depois next_cursor das respostas seguintes.
pageintegerNãoNúmero de página para paginação manual. Não pode ser usado com auto_paginate.
auto_paginatebooleanNãoQuando habilitado, count torna-se o total de mensagens desejado e a paginação é automática.
highlightbooleanNãoHabilitar destaque dos termos de busca nos resultados.
team_idstringNãoID do workspace para busca. Relevante apenas com token de nível organizacional.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_SEARCH_ALL

Pesquisa todas as mensagens e arquivos. Use quando precisar de busca de conteúdo unificado em canais e arquivos em uma única chamada.

NomeTipoObrigatórioDescrição
querystringSimConsulta de busca com suporte a modificadores e booleanos do Slack.
sortstringNãoOrdenar por score (relevância) ou timestamp (cronológico).
sort_dirstringNãoDireção da ordenação: asc ou desc.
countintegerNãoNúmero de resultados por página; padrão 20; máx. 100.
pageintegerNãoNúmero de página dos resultados a retornar; padrão 1.
highlightbooleanNãoSe true, os termos de busca são marcados para destaque no lado do cliente.
team_idstringNãoID do workspace codificado para busca; necessário ao usar token de nível organizacional.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_LIST_ALL_CHANNELS

Lista todos os canais de um workspace Slack acessíveis ao token autenticado, com suporte a paginação e filtragem por tipo.

NomeTipoObrigatórioDescrição
limitintegerNãoNúmero máximo de canais a retornar por página.
cursorstringNãoCursor de paginação para buscar páginas específicas de resultados.
typesstringNãoTipos de canal a incluir: public_channel, private_channel, mpim, im.
team_idstringNãoID do workspace ao usar token de nível organizacional.
exclude_archivedbooleanNãoExcluir canais arquivados dos resultados.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_LIST_ALL_USERS

Lista todos os usuários de um workspace Slack. Suporta paginação e filtro de equipe.

NomeTipoObrigatórioDescrição
limitintegerNãoNúmero máximo de usuários a retornar por página.
cursorstringNãoCursor de paginação de response_metadata.next_cursor.
team_idstringNãoID do workspace ao usar token de nível organizacional.
include_localebooleanNãoIncluir o locale preferido do usuário na resposta.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_LOOKUP_USERS_BY_EMAIL

Busca um usuário Slack pelo endereço de e-mail e retorna o ID e os dados do perfil.

NomeTipoObrigatórioDescrição
emailstringSimEndereço de e-mail do usuário a buscar.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_OPEN_DM

Abre ou retoma uma mensagem direta (DM) ou mensagem direta multipessoal (MPIM) no Slack, fornecendo IDs de usuário ou um ID de canal existente. Retorna already_open=true quando o DM já existe.

NomeTipoObrigatórioDescrição
usersstringNãoString de IDs de usuário separados por vírgula (1 para DM, ou 2–8 para MPIM). Apenas IDs Slack (U0123456789), não e-mails nem nomes.
channelstringNãoID ou nome de um canal DM ou MPIM existente para abrir/retomar.
return_imbooleanNãoSe true, retorna o objeto completo do canal DM.
prevent_creationbooleanNãoNão criar um novo DM ou MPIM; apenas verificar se já existe.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_CREATE_CHANNEL

Cria um canal público ou privado em um workspace Slack. Cria o canal imediatamente; invoque apenas após confirmação explícita do usuário.

NomeTipoObrigatórioDescrição
namestringSimNome do canal público ou privado a criar. Deve ser em minúsculas, único e sem espaços ou pontos; máx. 80 caracteres.
is_privatebooleanNãoCriar um canal privado em vez de público.
team_idstringNãoID de equipe codificado para criar o canal, necessário ao usar token de organização.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_INVITE_USERS_TO_A_CHANNEL

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

NomeTipoObrigatórioDescrição
channelstringNãoID do canal público ou privado para convidar usuários. O bot já deve ser membro de canais privados.
usersstringNãoString de IDs de usuário Slack válidos separados por vírgula, com até 1000 IDs.
forcebooleanNãoQuando true e vários IDs são fornecidos, continua convidando os válidos ignorando IDs inválidos.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_ADD_REACTION_TO_AN_ITEM

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

NomeTipoObrigatórioDescrição
namestringSimNome do emoji a adicionar como reação (ex.: thumbsup). Sem dois-pontos. Para modificadores de tom de pele, adicione ::skin-tone-X onde X é de 2 a 6.
channelstringSimID do canal onde a mensagem foi postada.
timestampstringSimTimestamp da mensagem à qual a reação será adicionada. Deve ser o timestamp exato da mensagem.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_SCHEDULE_MESSAGE

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

NomeTipoObrigatórioDescrição
channelstringNãoID ou nome do canal, grupo privado ou DM para enviar a mensagem. O bot deve ser membro do canal alvo.
post_atstringNãoTimestamp UNIX EPOCH (segundos inteiros desde 1970-01-01 00:00:00 UTC) para o horário futuro de envio. Deve ser estritamente maior que o horário atual.
markdown_textstringNãoEscreva sua mensagem agendada em Markdown para exibição bem formatada.
textstringNãoEnvia apenas texto bruto; use markdown_text para formatação.
thread_tsstringNãoTimestamp da mensagem pai para que a mensagem agendada seja uma resposta em thread.
blocksstringNãoDescontinuado: use markdown_text. Array JSON de blocos estruturados.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_UPDATES_A_MESSAGE

Atualiza uma mensagem Slack por 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.

NomeTipoObrigatórioDescrição
tsstringSimTimestamp da mensagem a atualizar (string, hora Unix com microssegundos, ex.: 1234567890.123456).
channelstringSimID ou nome do canal, grupo privado ou IM contendo a mensagem a atualizar.
markdown_textstringNãoUse para conteúdo de mensagem atualizado normal. Suporta Markdown nativo do Slack.
blocksarrayNãoUse em vez de markdown_text para capacidades do Slack Block Kit.
fallback_textstringNãoApenas ao usar blocks. Texto de fallback para notificações e acessibilidade.
as_userbooleanNãoPasse true para atualizar a mensagem como o usuário autenticado.
file_idsarrayNãoArray de IDs de arquivo a anexar à mensagem atualizada.
reply_broadcastbooleanNãoSe true e a mensagem é uma resposta em thread, transmite a mensagem atualizada para o canal.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_DELETE_A_MESSAGE_FROM_A_CHAT

Exclui uma mensagem de um canal Slack, identificada pelo timestamp.

NomeTipoObrigatórioDescrição
tsstringSimTimestamp da mensagem a excluir.
channelstringSimID do canal que contém a mensagem a excluir.
as_userbooleanNãoPasse true para excluir a mensagem como o usuário autenticado.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_RETRIEVE_CONVERSATION_INFORMATION

Recupera metadados de uma conversa Slack por ID (ex.: nome, propósito, data de criação), excluindo conteúdo de mensagens.

NomeTipoObrigatórioDescrição
channelstringNãoID da conversa (canal, mensagem direta ou MPIM) para recuperar informações. Efetivamente obrigatório.
include_localebooleanNãoSe true, a resposta incluirá a configuração de locale da conversa.
include_num_membersbooleanNãoSe true, a resposta incluirá o número de membros na conversa.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_RETRIEVE_CONVERSATION_MEMBERS_LIST

Recupera uma lista paginada de IDs de membros ativos de um canal público, privado, DM ou MPIM do Slack. Retorna apenas IDs de usuário; use uma ferramenta de consulta de usuário para enriquecer os dados.

NomeTipoObrigatórioDescrição
channelstringNãoID da conversa para recuperar a lista de membros. Nomes de canal não são aceitos — apenas IDs.
limitintegerNãoNúmero máximo de membros a retornar por página.
cursorstringNãoCursor de paginação. Passe next_cursor de chamadas anteriores para não truncar listas grandes.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_RETRIEVE_DETAILED_USER_INFORMATION

Recupera informações abrangentes para um ID de usuário Slack válido, excluindo histórico de mensagens e memberships de canal. Campos sensíveis como email e phone exigem o escopo users:read.email.

NomeTipoObrigatórioDescrição
userstringNãoID do usuário para recuperar informações. Deve ser um ID Slack (prefixo U ou W); e-mails ou nomes de exibição retornam erro user_not_found.
include_localebooleanNãoDefinir como true para incluir o locale do usuário na resposta.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_SEND_EPHEMERAL_MESSAGE

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

NomeTipoObrigatórioDescrição
userstringSimID do usuário para enviar a mensagem efêmera.
channelstringSimCanal, grupo privado ou DM para enviar a mensagem. Passe o ID do canal (ex.: C0ABC12345).
textstringNãoTexto da mensagem a exibir. Obrigatório a menos que blocks ou attachments seja fornecido.
markdown_textstringNãoPreferido: escreva a mensagem efêmera em Markdown para exibição bem formatada.
blocksstringNãoArray JSON de blocos estruturados.
thread_tsstringNãoTimestamp de outra mensagem para tornar esta uma resposta em thread.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_PIN_ITEM

Fixa uma mensagem em um canal Slack especificado; a mensagem não deve estar fixada ainda.

NomeTipoObrigatórioDescrição
channelstringSimID do canal onde a mensagem será fixada.
timestampstringSimTimestamp da mensagem a fixar, no formato epoch_time.microseconds.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_UPLOAD_OR_CREATE_A_FILE_IN_SLACK

Envia 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.

NomeTipoObrigatórioDescrição
channelsstringNãoID do canal onde o arquivo será compartilhado; se omitido, o arquivo fica privado para o uploader.
contentstringNãoConteúdo de texto do arquivo; use para arquivos baseados em texto. Pelo menos um de content ou file deve ser fornecido.
filestringNãoArquivo(s) a enviar. Pelo menos um de content ou file deve ser fornecido.
filenamestringNãoNome do arquivo a exibir no Slack. Obrigatório ao usar o parâmetro content.
titlestringNãoTítulo do arquivo exibido no Slack.
thread_tsstringNãoTimestamp de uma mensagem pai para enviar este arquivo como resposta em thread.
initial_commentstringNãoMensagem opcional para apresentar o arquivo nos channels especificados.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_SET_THE_TOPIC_OF_A_CONVERSATION

Define ou atualiza o tópico de uma conversa Slack especificada.

NomeTipoObrigatórioDescrição
channelstringNãoID do canal, DM ou MPIM para o qual definir o tópico. Deve ser um ID de canal (prefixo C/G/D), não um nome legível.
topicstringNãoNovo tópico para a conversa. Máx. 250 caracteres. Formatação de texto e linkificação não são suportadas.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_CREATE_A_REMINDER

Cria um lembrete no Slack para o usuário autenticado ou para outro usuário.

NomeTipoObrigatórioDescrição
textstringSimO conteúdo do lembrete.
timestringSimQuando o lembrete deve ser enviado. Aceita timestamp Unix ou string de tempo relativa (ex.: in 5 minutes, at 3pm).
userstringNãoID do usuário para o qual o lembrete é criado. Padrão: usuário autenticado.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_RENAME_A_CONVERSATION

Renomeia um canal Slack. O usuário chamador deve ser membro do canal.

NomeTipoObrigatórioDescrição
namestringSimNovo nome para o canal. Deve ser em minúsculas, sem espaços ou pontos.
channelstringSimID do canal a renomear.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

SLACKBOT_RETRIEVE_USER_PROFILE_INFORMATION

Recupera informações de perfil de um usuário Slack especificado (padrão: usuário autenticado se user for omitido). Campos sensíveis como e-mail podem ser omitidos silenciosamente por políticas de privacidade do workspace.

NomeTipoObrigatórioDescrição
userstringNãoID do usuário para recuperar informações de perfil; padrão: usuário autenticado.
include_labelsbooleanNãoIncluir rótulos legíveis para campos de perfil personalizados.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.