Konektor Slack

Propojte svůj pracovní prostor Slack s Brevo přes Tajo pro notifikace marketingu v reálném čase, týmové upozornění na zákaznické události a automatizaci pracovních toků spouštěnou interakcemi Slack.

Přehled

Funkce

• Marketingová upozornění – Odesílejte notifikace v reálném čase pro události kampaní, nové odběratele a příjmové milníky
• Notifikace zákaznických událostí – Upozorňujte týmy na hodnotné zákaznické akce z Brevo
• Spouštěče pracovních toků – Používejte interakce Slack (kliknutí na tlačítka, odeslání formulářů) pro spouštění automatizací Brevo
• Směrování podle kanálů – Směrujte notifikace do konkrétních kanálů na základě typu události nebo segmentu zákazníků
• Synchronizace uživatelů – Mapujte uživatele pracovního prostoru Slack na kontakty Brevo pro interní komunikaci
• Interaktivní zprávy – Odesílejte bohaté zprávy s tlačítky a akcemi pro týmové pracovní toky
• Plánované zprávy – Plánujte notifikace pro denní/týdenní marketingové shrnutí
• Podpora vláken – Seskupujte související notifikace ve vláknech pro organizovanou komunikaci

Předpoklady

Než začnete, ujistěte se, že máte:

1. Pracovní prostor Slack s administrátorským přístupem
2. Aplikaci Slack vytvořenou na api.slack.com/apps
3. Bot token s požadovanými rozsahy
4. Účet Brevo s přístupem k API
5. Účet Tajo

Ověření

Bot Token (doporučeno)

Nainstalujte aplikaci Slack do svého pracovního prostoru a pro přístup k API použijte bot token.

1. Vytvořte aplikaci na api.slack.com/apps
2. Přidejte požadované rozsahy OAuth v části “OAuth & Permissions”
3. Nainstalujte aplikaci do pracovního prostoru
4. Zkopírujte 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

Pro distribuci integrace Slack do více pracovních prostorů:

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

# Výměna tokenů
curl -X POST "https://slack.com/api/oauth.v2.access" \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}" \
  -d "code={auth_code}"

Požadované rozsahy bota

chat:write           # Odesílání zpráv
channels:read        # Výpis kanálů
channels:history     # Čtení zpráv kanálu
users:read           # Výpis uživatelů pracovního prostoru
users:read.email     # Čtení e-mailových adres uživatelů
reactions:write      # Přidávání reakcí ke zprávám
files:write          # Nahrávání souborů

Konfigurace

Základní nastavení

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

    # Kanály pro notifikace
    channels:
      marketing: "C01234567"
      sales: "C01234568"
      support: "C01234569"
      alerts: "C01234570"

    # Směrování událostí
    notifications:
      new_subscriber:
        channel: marketing
        template: subscriber_alert
      high_value_order:
        channel: sales
        template: order_alert
      support_ticket:
        channel: support
        template: ticket_alert

Mapování polí

Mapujte uživatelská data Slack na atributy kontaktů Brevo:

Metody API

Zasílání zpráv

Kanály

Uživatelé

Interakce

Události

Notifikace Brevo do Slack

Spouštěče Slack do Brevo

Příklady kódu

Inicializace konektoru

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

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

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

Odesílání marketingových notifikací

// Odeslání notifikace při hodnotné objednávce
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'
          }
        ]
      }
    ]
  }
});

Zpracování interakcí Slack

import crypto from 'crypto';

app.post('/slack/interactions', async (req, res) => {
  // Ověření podpisu požadavku Slack
  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);

  // Zpracování akcí tlačítek
  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();
});

Omezení rychlosti

Limity rychlosti Slack API používají vrstvený systém:

Další limity:

• Web API: Burstový limit s krátkodobým omezováním
• Events API: Opakování doručení pro 3 pokusy
• Příchozí webhooky: 1 zpráva/s na URL webhooku
• Block Kit: Maximálně 50 bloků na zprávu

Řešení problémů

Časté problémy

Režim ladění

Povolte podrobné protokolování:

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

Test připojení

tajo connectors test slack
# ✓ Bot token platný
# ✓ Pracovní prostor přístupný
# ✓ Kanály čitelné
# ✓ Odesílání zpráv povoleno
# ✓ Odběry událostí aktivní

Osvědčené postupy

1. Používejte Block Kit – Vytvářejte bohaté, interaktivní zprávy s frameworkem Block Kit Slack
2. Reagujte rychle – Potvrzujte interakce do 3 sekund, zpracovávejte asynchronně
3. Vlákněte související zprávy – Seskupujte související notifikace ve vláknech pro snížení šumu
4. Směrujte podle kanálu – Odesílejte různé typy událostí do příslušných týmových kanálů
5. Zahrňte akční tlačítka – Přidávejte tlačítka “View in Brevo” pro rychlý přístup k zákaznickým datům
6. Implementujte unfurling – Zobrazujte bohaté náhledy pro odkazy Brevo sdílené ve Slack

Zabezpečení

• Bot Token – Přístupový token s rozsahem OAuth a granulovanými oprávněními
• Podepisování požadavků – Ověření podpisu HMAC SHA-256 pro příchozí požadavky
• OAuth 2.0 – Průmyslově standardní autorizace pro distribuci do více pracovních prostorů
• Šifrování TLS – Veškerá komunikace API šifrována přes HTTPS
• Rotace tokenů – Automatická rotace tokenů pro zvýšené zabezpečení

Související zdroje

• Dokumentace Slack API
• Slack Block Kit Builder
• Slack Events API
• Konektor Brevo
• Dovednost synchronizace zákazníků