Slack

ACTIVEVersão 1.1.0Slack

Envie mensagens para canais do Slack a partir dos seus processos.

Ver como JSON

Pré-requisitos

• um workspace do Slack onde você possa instalar apps;
• permissão no iBPMS para criar ou selecionar conexões;
• autorização concluída pelo fluxo OAuth.

slack.json

{
  "schemaVersion": 1,
  "key": "slack",
  "name": "Slack",
  "description": "Envie mensagens para canais do Slack a partir dos seus processos.",
  "category": "communication",
  "vendor": "Slack",
  "version": "1.1.0",
  "status": "ACTIVE",
  "credentials": [
    {
      "type": "OAUTH2",
      "permissions": [
        "Enviar mensagens nos seus canais",
        "Ver a lista de canais do workspace"
      ]
    }
  ],
  "actions": [
    {
      "key": "message.post",
      "name": "Enviar mensagem",
      "description": "Publica uma mensagem em um canal, com o texto montado a partir de dados do processo.",
      "inputs": [
        {
          "key": "channel",
          "label": "Canal",
          "type": "RESOURCE_SELECT",
          "required": true
        },
        {
          "key": "text",
          "label": "Mensagem",
          "type": "TEXT",
          "required": true,
          "description": "Aceita expressões do processo, ex.: {{ process.protocol }}."
        }
      ],
      "outputs": [
        {
          "key": "ts",
          "label": "Ts",
          "type": "OUTPUT",
          "required": false
        },
        {
          "key": "channel",
          "label": "Channel",
          "type": "OUTPUT",
          "required": false
        }
      ]
    }
  ],
  "triggers": [
    {
      "key": "message.received",
      "name": "Mensagem recebida",
      "description": "Dispara quando uma mensagem é postada num canal onde o app está. Inscrição MANUAL: cole a URL de callback em Event Subscriptions → Request URL, no painel do app Slack, e assine o evento message.channels.",
      "mode": "PUSH",
      "exclusiveByConnection": true,
      "inputs": [],
      "events": [
        {
          "type": "MESSAGE_RECEIVED",
          "messageType": "TEXT"
        }
      ]
    },
    {
      "key": "command.received",
      "name": "Comando recebido",
      "description": "Dispara quando alguém usa o slash command do app no Slack. Inscrição MANUAL: o comando é criado no painel do app Slack (Slash Commands) e a URL de callback vai no Request URL DESSE comando — que é um campo separado do Request URL de Event Subscriptions. O texto após o comando chega em 'arguments'.",
      "mode": "PUSH",
      "exclusiveByConnection": true,
      "inputs": [],
      "events": [
        {
          "type": "GENERIC"
        }
      ]
    }
  ]
}

Autorizando o workspace

1. No iBPMS, crie uma conexão do Slack.
2. Confirme as permissões apresentadas no diálogo de consentimento.
3. Conclua a autorização na tela do Slack e volte ao iBPMS.

Credenciais

Credencial

Credencial

OAUTH2

Campo	Formato esperado
Segredo

Permissões concedidas

• Enviar mensagens nos seus canais
• Ver a lista de canais do workspace

Ações disponíveis

Ação

Enviar mensagem

message.post

Publica uma mensagem em um canal, com o texto montado a partir de dados do processo.

Entradas

Campo	Tipo	Obrigatório	Descrição
channelCanal	RESOURCE_SELECT	Sim	—
textMensagem	TEXT	Sim	Aceita expressões do processo, ex.: {{ process.protocol }}.

Saídas

Campo	Tipo	Obrigatório	Descrição
tsTs	OUTPUT	Não	—
channelChannel	OUTPUT	Não	—

Chamada

{
  "connection": "slack-producao",
  "operation": "message.post",
  "inputs": {
    "channel": "{{ context.channel }}",
    "text": "{{ context.text }}"
  }
}

Resposta

{
  "ts": "…",
  "channel": "…"
}

Triggers disponíveis

Trigger

Mensagem recebida

PUSHConexão exclusiva

Dispara quando uma mensagem é postada num canal onde o app está. Inscrição MANUAL: cole a URL de callback em Event Subscriptions → Request URL, no painel do app Slack, e assine o evento message.channels.

Configuração

Este trigger não exige configuração adicional.

Eventos normalizados

• MESSAGE_RECEIVED · TEXT

Evento recebido

{
  "event": "MESSAGE_RECEIVED",
  "data": {
    "chave": "valor"
  }
}

Trigger

Comando recebido

PUSHConexão exclusiva

Dispara quando alguém usa o slash command do app no Slack. Inscrição MANUAL: o comando é criado no painel do app Slack (Slash Commands) e a URL de callback vai no Request URL DESSE comando — que é um campo separado do Request URL de Event Subscriptions. O texto após o comando chega em 'arguments'.

Configuração

Este trigger não exige configuração adicional.

Eventos normalizados

• GENERIC

Evento recebido

{
  "event": "GENERIC",
  "data": {
    "chave": "valor"
  }
}

Limitações

• os triggers de mensagem e de comando são exclusivos por conexão;
• a inscrição dos eventos é manual: a URL de callback precisa ser colada em Event Subscriptions, no painel do app Slack;
• o bot só enxerga canais em que tenha sido adicionado;
• limites de rate do Slack continuam se aplicando.

Erros comuns

Sintoma	Possível causa	Correção
`not_in_channel`	O app não foi adicionado ao canal	Convide o app para o canal antes de enviar.
Eventos não chegam	Request URL não verificada no painel do Slack	Cole a URL de callback em Event Subscriptions e assine o evento.
Autorização expirada	App desinstalado do workspace	Refaça a conexão pelo fluxo OAuth.

Veja também

• Todos os conectores
• Integrações
• Solução de problemas