Conector Slack

Conecte seu workspace Slack ao Brevo via Tajo para notificações de marketing em tempo real, alertas para a equipe sobre eventos de clientes e automação de workflow disparada por interações no Slack.

Visão geral

Recursos

• Alertas de marketing - Envie notificações em tempo real para eventos de campanha, novos inscritos e marcos de receita
• Notificações de eventos de clientes - Alerte as equipes sobre ações de clientes de alto valor a partir do Brevo
• Gatilhos de workflow - Use interações do Slack (cliques em botões, envios de formulário) para disparar automações do Brevo
• Roteamento baseado em canal - Roteie notificações para canais específicos com base no tipo de evento ou segmento de cliente
• Sincronização de usuários - Mapeie usuários do workspace Slack para contatos do Brevo em comunicações internas
• Mensagens interativas - Envie mensagens ricas com botões e ações para workflows de equipe
• Mensagens agendadas - Agende notificações para resumos diários/semanais de marketing
• Suporte a threads - Agrupe notificações relacionadas em threads para comunicação organizada

Pré-requisitos

Antes de começar, certifique-se de ter:

1. Um workspace Slack com acesso de admin
2. Um app Slack criado em api.slack.com/apps
3. Bot token com os escopos necessários
4. Uma conta Brevo com acesso à API
5. Uma conta Tajo

Autenticação

Bot Token (Recomendado)

Instale um app Slack no seu workspace e use o bot token para acesso à API.

1. Crie o app em api.slack.com/apps
2. Adicione os escopos OAuth necessários em “OAuth & Permissions”
3. Instale o app no workspace
4. Copie o Bot User OAuth Token (xoxb-...)

curl -X POST "https://slack.com/api/chat.postMessage" \
  -H "Authorization: Bearer xoxb-YOUR-BOT-TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"channel": "C01234567", "text": "Hello from Tajo!"}'

OAuth 2.0

Para distribuir sua integração Slack para múltiplos workspaces:

# Authorization URL
https://slack.com/oauth/v2/authorize?
  client_id={client_id}&
  scope=chat:write,channels:read,users:read&
  redirect_uri={redirect_uri}

# Token exchange
curl -X POST "https://slack.com/api/oauth.v2.access" \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}" \
  -d "code={auth_code}"

Escopos de bot necessários

chat:write           # Send messages
channels:read        # List channels
channels:history     # Read channel messages
users:read           # List workspace users
users:read.email     # Read user email addresses
reactions:write      # Add reactions to messages
files:write          # Upload files

Configuração

Configuração básica

connectors:
  slack:
    enabled: true
    bot_token: "${SLACK_BOT_TOKEN}"
    signing_secret: "${SLACK_SIGNING_SECRET}"

    # Notification channels
    channels:
      marketing: "C01234567"
      sales: "C01234568"
      support: "C01234569"
      alerts: "C01234570"

    # Event routing
    notifications:
      new_subscriber:
        channel: marketing
        template: subscriber_alert
      high_value_order:
        channel: sales
        template: order_alert
      support_ticket:
        channel: support
        template: ticket_alert

Mapeamento de campos

Mapeie dados de usuário do Slack para atributos de contato do Brevo:

Métodos da API

Mensagens

Canais

Usuários

Interações

Eventos

Notificações Brevo-para-Slack

Gatilhos Slack-para-Brevo

Exemplos de código

Inicializar o conector

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Slack
await tajo.connectors.connect('slack', {
  botToken: process.env.SLACK_BOT_TOKEN,
  signingSecret: process.env.SLACK_SIGNING_SECRET
});

Enviar notificações de marketing

// Send a notification when a high-value order is placed
await tajo.slack.notify({
  channel: 'sales',
  event: 'order_placed',
  data: {
    customerEmail: '[email protected]',
    orderValue: '$1,250.00',
    products: ['Premium Widget', 'Pro Service'],
    isFirstOrder: true
  },
  template: {
    blocks: [
      {
        type: 'header',
        text: { type: 'plain_text', text: 'New High-Value Order' }
      },
      {
        type: 'section',
        fields: [
          { type: 'mrkdwn', text: '*Customer:*\n[email protected]' },
          { type: 'mrkdwn', text: '*Amount:*\n$1,250.00' }
        ]
      },
      {
        type: 'actions',
        elements: [
          {
            type: 'button',
            text: { type: 'plain_text', text: 'View in Brevo' },
            url: 'https://app.brevo.com/contacts'
          }
        ]
      }
    ]
  }
});

Tratar interações do Slack

import crypto from 'crypto';

app.post('/slack/interactions', async (req, res) => {
  // Verify Slack request signature
  const timestamp = req.headers['x-slack-request-timestamp'];
  const signature = req.headers['x-slack-signature'];
  const sigBasestring = `v0:${timestamp}:${req.rawBody}`;
  const mySignature = 'v0=' + crypto
    .createHmac('sha256', process.env.SLACK_SIGNING_SECRET)
    .update(sigBasestring)
    .digest('hex');

  if (signature !== mySignature) {
    return res.status(401).send('Unauthorized');
  }

  const payload = JSON.parse(req.body.payload);

  // Handle button actions
  if (payload.type === 'block_actions') {
    await tajo.connectors.handleWebhook('slack', {
      type: 'interaction',
      action: payload.actions[0].action_id,
      userId: payload.user.id,
      payload
    });
  }

  res.status(200).send();
});

Limites de taxa

Os limites de taxa da API Slack usam um sistema em camadas:

Limites adicionais:

• Web API: Limite de burst com throttle de curto prazo
• Events API: Tentativas de entrega por 3 tentativas
• Incoming Webhooks: 1 mensagem/segundo por URL de webhook
• Block Kit: Máximo 50 blocos por mensagem

Solução de problemas

Problemas comuns

Modo de depuração

Habilite logging detalhado:

connectors:
  slack:
    debug: true
    log_level: verbose
    log_events: true

Testar conexão

tajo connectors test slack
# ✓ Bot token valid
# ✓ Workspace accessible
# ✓ Channels readable
# ✓ Message posting enabled
# ✓ Event subscriptions active

Melhores práticas

1. Use Block Kit - Construa mensagens ricas e interativas com o framework Block Kit do Slack
2. Responda rapidamente - Confirme as interações em 3 segundos, processe de forma assíncrona
3. Agrupe mensagens relacionadas em thread - Agrupe notificações relacionadas em threads para reduzir ruído
4. Roteie por canal - Envie diferentes tipos de eventos para canais apropriados da equipe
5. Inclua botões de ação - Adicione botões “Ver no Brevo” para acesso rápido aos dados do cliente
6. Implemente unfurling - Exiba previews ricos para links do Brevo compartilhados no Slack

Segurança

• Bot Token - Token de acesso com escopo OAuth e permissões granulares
• Assinatura de requisições - Verificação de assinatura HMAC SHA-256 para requisições recebidas
• OAuth 2.0 - Autorização padrão da indústria para distribuição em múltiplos workspaces
• Criptografia TLS - Toda a comunicação com a API é criptografada via HTTPS
• Rotação de tokens - Rotação automática de tokens para segurança aprimorada

Recursos relacionados

• Documentação da API Slack
• Slack Block Kit Builder
• Slack Events API
• Conector Brevo
• Skill de sincronização de clientes