Slackbot
Visão geral
Seção intitulada “Visão geral”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).
- Site oficial: https://slack.com/
- Documentação na Composio: docs.composio.dev/toolkits/slackbot
Autenticação
Seção intitulada “Autenticação”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.
| Campo | Obrigatório | Descrição |
|---|---|---|
| OAuth 2.0 | Sim | Autorização via conta Slack na página segura da Composio. |
Como conectar no SquadOS
Seção intitulada “Como conectar no SquadOS”- Acesse Ferramentas no menu lateral (
/admin/tools). - Abra a aba Disponíveis e procure por
Slackbot. - Clique no card para abrir o modal de detalhes e em Conectar.
- Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso (OAuth) à sua conta Slack.
- 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.)
Ações disponíveis
Seção intitulada “Ações disponíveis”Enviar mensagem
Seção intitulada “Enviar mensagem”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
channel | string | Sim | ID 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_text | string | Não | Use para conteúdo de mensagem normal escrito por LLM. Suporta Markdown: cabeçalhos, negrito, itálico, links, listas, código, citações, divisores, tabelas. |
blocks | array | Não | Use em vez de markdown_text somente quando precisar de capacidades do Slack Block Kit (botões, menus, checkboxes, etc.). |
thread_ts | string | Não | Timestamp de uma mensagem existente para fazer esta uma resposta em thread. |
fallback_text | string | Não | Apenas ao usar blocks. Texto de fallback para notificações e acessibilidade. |
unfurl_links | boolean | Não | Habilitar unfurling de URLs baseadas em texto. |
unfurl_media | boolean | Não | Habilitar pré-visualizações de mídia de URLs. |
reply_broadcast | boolean | Não | Se true para uma resposta em thread, também publica no canal principal. |
| 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
Seção intitulada “Buscar histórico de conversa”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
channel | string | Sim | ID do canal público, privado, DM ou multi-pessoa para buscar o histórico. |
limit | integer | Não | Número máximo de mensagens a retornar 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. Aceita timestamp Unix ou Slack. |
latest | string | Não | Fim do intervalo de tempo. Aceita timestamp Unix ou Slack. |
inclusive | boolean | Não | Quando true, inclui mensagens nos timestamps exatos de oldest ou latest. |
include_all_metadata | boolean | Não | Retornar todos os metadados associados às mensagens. |
| 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
Seção intitulada “Recuperar respostas de conversa”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
channel | string | Não | ID da conversa para buscar a thread. Deve ser ID de canal, não nome. |
ts | string | Não | Timestamp da mensagem pai da thread. Deve ser a string de timestamp completa da mensagem raiz. |
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. |
oldest | string | Não | Timestamp mais antigo do intervalo de tempo. |
latest | string | Não | Timestamp mais recente do intervalo de tempo. |
inclusive | boolean | Não | Incluir mensagens nos timestamps de oldest ou latest. |
include_all_metadata | boolean | Não | Retornar todos os metadados das mensagens. |
| 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 canais
Seção intitulada “Buscar canais”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | Consulta 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). |
limit | integer | Não | Número máximo de canais a retornar (1 a 999). Padrão: 50. |
types | string | Não | Lista separada por vírgulas de tipos de canal: public_channel, private_channel, mpim, im. |
team_id | string | Não | ID do workspace ao usar token de nível organizacional. |
| 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. |
Pesquisar mensagens
Seção intitulada “Pesquisar mensagens”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | Consulta de busca com suporte a modificadores para filtragem precisa. Ex.: "atualização do projeto" on:2025-09-25 in:#marketing from:@joao. |
sort | string | Não | Ordenar por score (relevância) ou timestamp (cronológico). |
sort_dir | string | Não | Direção da ordenação: asc ou desc. |
count | integer | Não | Número de mensagens por página (máx. 100). |
cursor | string | Não | Cursor de paginação; use * na primeira chamada, depois next_cursor das respostas seguintes. |
page | integer | Não | Número de página para paginação manual. Não pode ser usado com auto_paginate. |
auto_paginate | boolean | Não | Quando habilitado, count torna-se o total de mensagens desejado e a paginação é automática. |
highlight | boolean | Não | Habilitar destaque dos termos de busca nos resultados. |
team_id | string | Não | ID do workspace para busca. Relevante apenas com token de nível organizacional. |
| 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. |
Pesquisar todo o conteúdo
Seção intitulada “Pesquisar todo o conteúdo”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | Consulta de busca com suporte a modificadores e booleanos do Slack. |
sort | string | Não | Ordenar por score (relevância) ou timestamp (cronológico). |
sort_dir | string | Não | Direção da ordenação: asc ou desc. |
count | integer | Não | Número de resultados por página; padrão 20; máx. 100. |
page | integer | Não | Número de página dos resultados a retornar; padrão 1. |
highlight | boolean | Não | Se true, os termos de busca são marcados para destaque no lado do cliente. |
team_id | string | Não | ID do workspace codificado para busca; necessário ao usar token de nível organizacional. |
| 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
Seção intitulada “Listar todos os canais”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.
Parâmetros de entrada
Seção intitulada “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. |
cursor | string | Não | Cursor de paginação para buscar páginas específicas de resultados. |
types | string | Não | Tipos de canal a incluir: public_channel, private_channel, mpim, im. |
team_id | string | Não | ID do workspace ao usar token de nível organizacional. |
exclude_archived | boolean | Não | Excluir canais arquivados dos resultados. |
| 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
Seção intitulada “Listar todos os usuários”SLACKBOT_LIST_ALL_USERS
Lista todos os usuários de um workspace Slack. Suporta paginação e filtro de equipe.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
limit | integer | Não | Número máximo de usuários a retornar por página. |
cursor | string | Não | Cursor de paginação de response_metadata.next_cursor. |
team_id | string | Não | ID do workspace ao usar token de nível organizacional. |
include_locale | boolean | Não | Incluir o locale preferido do usuário na resposta. |
| 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. |
Consultar usuários por e-mail
Seção intitulada “Consultar usuários por e-mail”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
email | string | Sim | Endereço de e-mail do usuário a buscar. |
| 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. |
Abrir DM
Seção intitulada “Abrir DM”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
users | string | Não | String 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. |
channel | string | Não | ID ou nome de um canal DM ou MPIM existente para abrir/retomar. |
return_im | boolean | Não | Se true, retorna o objeto completo do canal DM. |
prevent_creation | boolean | Não | Não criar um novo DM ou MPIM; apenas verificar se já existe. |
| 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
Seção intitulada “Criar canal”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Sim | Nome 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_private | boolean | Não | Criar um canal privado em vez de público. |
team_id | string | Não | ID de equipe codificado para criar o canal, necessário ao usar token de organização. |
| 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
Seção intitulada “Convidar usuários para canal”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
channel | string | Não | ID do canal público ou privado para convidar usuários. O bot já deve ser membro de canais privados. |
users | string | Não | String de IDs de usuário Slack válidos separados por vírgula, com até 1000 IDs. |
force | boolean | Não | Quando true e vários IDs são fornecidos, continua convidando os válidos ignorando IDs inválidos. |
| 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
Seção intitulada “Adicionar reação a mensagem”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Sim | Nome 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. |
channel | string | Sim | ID do canal onde a mensagem foi postada. |
timestamp | string | Sim | Timestamp da mensagem à qual a reação será adicionada. Deve ser o timestamp exato da mensagem. |
| 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
Seção intitulada “Agendar mensagem”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
channel | string | Não | ID ou nome do canal, grupo privado ou DM para enviar a mensagem. 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. Deve ser estritamente maior que o horário atual. |
markdown_text | string | Não | Escreva sua mensagem agendada em Markdown para exibição bem formatada. |
text | string | Não | Envia apenas texto bruto; use markdown_text para formatação. |
thread_ts | string | Não | Timestamp da mensagem pai para que a mensagem agendada seja uma resposta em thread. |
blocks | string | Não | Descontinuado: use markdown_text. Array JSON de blocos estruturados. |
| 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
Seção intitulada “Atualizar mensagem Slack”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ts | string | Sim | Timestamp da mensagem a atualizar (string, hora Unix com microssegundos, ex.: 1234567890.123456). |
channel | string | Sim | ID ou nome do canal, grupo privado ou IM contendo a mensagem a atualizar. |
markdown_text | string | Não | Use para conteúdo de mensagem atualizado normal. Suporta Markdown nativo do Slack. |
blocks | array | Não | Use em vez de markdown_text para capacidades do Slack Block Kit. |
fallback_text | string | Não | Apenas ao usar blocks. Texto de fallback para notificações e acessibilidade. |
as_user | boolean | Não | Passe true para atualizar a mensagem como o usuário autenticado. |
file_ids | array | Não | Array de IDs de arquivo a anexar à mensagem atualizada. |
reply_broadcast | boolean | Não | Se true e a mensagem é uma resposta em thread, transmite a mensagem atualizada para o canal. |
| 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
Seção intitulada “Excluir mensagem do chat”SLACKBOT_DELETE_A_MESSAGE_FROM_A_CHAT
Exclui uma mensagem de um canal Slack, identificada pelo timestamp.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ts | string | Sim | Timestamp da mensagem a excluir. |
channel | string | Sim | ID do canal que contém a mensagem a excluir. |
as_user | boolean | Não | Passe true para excluir a mensagem como o usuário autenticado. |
| 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 informações da conversa
Seção intitulada “Recuperar informações da conversa”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
channel | string | Não | ID da conversa (canal, mensagem direta ou MPIM) para recuperar informações. Efetivamente obrigatório. |
include_locale | boolean | Não | Se true, a resposta incluirá a configuração de locale da conversa. |
include_num_members | boolean | Não | Se true, a resposta incluirá o número de membros na conversa. |
| 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. |
Obter membros da conversa
Seção intitulada “Obter membros da conversa”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
channel | string | Não | ID da conversa para recuperar a lista de membros. Nomes de canal não são aceitos — apenas IDs. |
limit | integer | Não | Número máximo de membros a retornar por página. |
cursor | string | Não | Cursor de paginação. Passe next_cursor de chamadas anteriores para não truncar listas grandes. |
| 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 informações detalhadas do usuário
Seção intitulada “Recuperar informações detalhadas do usuário”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
user | string | Não | ID 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_locale | boolean | Não | Definir como true para incluir o locale do usuário na resposta. |
| 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
Seção intitulada “Enviar mensagem efêmera”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.
Parâmetros de entrada
Seção intitulada “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. Passe o ID do canal (ex.: C0ABC12345). |
text | string | Não | Texto da mensagem a exibir. Obrigatório a menos que blocks ou attachments seja fornecido. |
markdown_text | string | Não | Preferido: escreva a mensagem efêmera em Markdown para exibição bem formatada. |
blocks | string | Não | Array JSON de blocos estruturados. |
thread_ts | string | Não | Timestamp de outra mensagem para tornar esta uma resposta em thread. |
| 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. |
Fixar item no canal
Seção intitulada “Fixar item no canal”SLACKBOT_PIN_ITEM
Fixa uma mensagem em um canal Slack especificado; a mensagem não deve estar fixada ainda.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
channel | string | Sim | ID do canal onde a mensagem será fixada. |
timestamp | string | Sim | Timestamp da mensagem a fixar, no formato epoch_time.microseconds. |
| 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 arquivo para o Slack
Seção intitulada “Enviar arquivo para o Slack”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
channels | string | Não | ID do canal onde o arquivo será compartilhado; se omitido, o arquivo fica privado para o uploader. |
content | string | Não | Conteúdo de texto do arquivo; use para arquivos baseados em texto. Pelo menos um de content ou file deve ser fornecido. |
file | string | Não | Arquivo(s) a enviar. Pelo menos um de content ou file deve ser fornecido. |
filename | string | Não | Nome do arquivo a exibir no Slack. Obrigatório ao usar o parâmetro content. |
title | string | Não | Título do arquivo exibido no Slack. |
thread_ts | string | Não | Timestamp de uma mensagem pai para enviar este arquivo como resposta em thread. |
initial_comment | string | Não | Mensagem opcional para apresentar o arquivo nos channels especificados. |
| 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. |
Definir tópico da conversa
Seção intitulada “Definir tópico da conversa”SLACKBOT_SET_THE_TOPIC_OF_A_CONVERSATION
Define ou atualiza o tópico de uma conversa Slack especificada.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
channel | string | Não | ID 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. |
topic | string | Não | Novo tópico para a conversa. Máx. 250 caracteres. Formatação de texto e linkificação não são suportadas. |
| 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 lembrete
Seção intitulada “Criar lembrete”SLACKBOT_CREATE_A_REMINDER
Cria um lembrete no Slack para o usuário autenticado ou para outro usuário.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
text | string | Sim | O conteúdo do lembrete. |
time | string | Sim | Quando o lembrete deve ser enviado. Aceita timestamp Unix ou string de tempo relativa (ex.: in 5 minutes, at 3pm). |
user | string | Não | ID do usuário para o qual o lembrete é criado. Padrão: usuário autenticado. |
| 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
Seção intitulada “Renomear conversa”SLACKBOT_RENAME_A_CONVERSATION
Renomeia um canal Slack. O usuário chamador deve ser membro do canal.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Sim | Novo nome para o canal. Deve ser em minúsculas, sem espaços ou pontos. |
channel | string | Sim | ID do canal a renomear. |
| 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 informações do perfil do usuário
Seção intitulada “Recuperar informações do perfil do usuário”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
user | string | Não | ID do usuário para recuperar informações de perfil; padrão: usuário autenticado. |
include_labels | boolean | Não | Incluir rótulos legíveis para campos de perfil personalizados. |
| 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. |