Enviar mensagem no Slack, por uma API

Posta uma mensagem como o bot do app e a retorna com channel e ts, o par que Update message e Delete message pedem. Envie text, markdown_text ou blocks. O app precisa ser membro do canal: chame Join conversation antes em um canal público.

Identificador
slack_send_message

A chamada

POST https://connect.reportei.com/api/tools/slack_send_message/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "channel": "<channel_id>",
    "text": "Hello! This is an example message."
  }
}

Seu sistema envia o id da conexão do cliente e os argumentos da tool. Os headers são os mesmos de toda a API do Connect: o token do seu produto e o token do cliente.

Exemplo ilustrativo. Substitua os tokens, o UUID da conexão e os dados de destino pelos seus. Esta página não executa a chamada.

Antes de executar

  • O exemplo usa text. Também é possível usar blocks ou markdown_text; não combine markdown_text com text ou blocks. Com blocks, inclua text como fallback de acessibilidade e notificações.
  • Conecte o workspace com um app OAuth que tenha permissão de envio e acesso à conversa. Em canais privados, o app precisa ser membro; canais públicos também dependem das permissões concedidas.
  • Confira ok no corpo da resposta, além do status HTTP. Erros como no_text, missing_scope e not_in_channel indicam conteúdo, escopo ou acesso que precisam de correção.

Parâmetros

As descrições dos parâmetros seguem a documentação oficial do app, em inglês.

ParâmetroTipoObrigatórioDescrição
channelstringSimId of a channel from List conversations, or the id of a user from List users or Get user by email to message that person directly from the app.
textstringSim, no exemplo de textoText of the message, plain or in Slack mrkdwn, ideally under 4000 characters. With blocks it is only the notification fallback.
markdown_textstringAlternativa a text/blocksThe message in standard Markdown, up to 12000 characters. Do not send it together with text or blocks.
blocksarrayAlternativa de conteúdoBlock Kit layout blocks of the message, each with its type, such as section or divider. Send text too, as the notification fallback.
thread_tsstringNãoThe ts of a parent message, from List messages, to post this message as a reply in its thread.
reply_broadcastbooleanNãoWith thread_ts, true also shows the reply in the channel.
unfurl_linksbooleanNãotrue shows a preview of text-based links.
unfurl_mediabooleanNãofalse hides the preview of media links.

Conexões possíveis

O seu cliente conecta a conta do Slack uma vez, por um dos modos abaixo. A mesma conexão serve para todas as tools do toolkit.

OAuth com o app do seu produto

Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/slack, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.

A resposta

Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app. Erros HTTP retornados pelo app usam o envelope {error, api_error}; falhas de autenticação ou validação podem ocorrer antes da execução. O header X-Toolkit-Execution-Id identifica a execução registrada, consultável em GET /api/tools/executions/{uuid}.

Formato ilustrativo de sucesso

{
  "ok": true,
  "channel": "C0123456789",
  "ts": "1234567890.123456",
  "message": {
    "text": "Hello! This is an example message."
  }
}

O conteúdo abaixo é um exemplo, não o resultado de uma execução. Guarde o X-Toolkit-Execution-Id quando retornado para consultar a execução. O Connect não aplica retry nem idempotência: repetir um POST pode repetir o envio.

Pronta para agentes de IA

O input desta tool é um JSON Schema, disponível em GET /api/tools/slack_send_message. Ele vira a definição de tool do seu agente sem conversão.

Outras tools do Slack

Ver as 12 tools

Toolkits da mesma categoria

Ver os 100 toolkits

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.