Slack Konektor

Povežite svoj Slack radni prostor s Brevom putem Taja za marketinške obavijesti u stvarnom vremenu, timska upozorenja o korisničkim događajima i automatizaciju tijeka rada pokrenuti Slack interakcijama.

Pregled

Značajke

• Marketinška upozorenja - Šaljite obavijesti u stvarnom vremenu za događaje kampanje, nove pretplatnike i prihodni prekretnice
• Obavijesti o korisničkim događajima - Upozoravajte timove na visokovjredne korisničke akcije iz Breva
• Okidači tijeka rada - Koristite Slack interakcije (klikovi gumba, slanje obrazaca) za pokretanje Brevo automatizacija
• Usmjeravanje temeljeno na kanalima - Usmjeravajte obavijesti na određene kanale prema vrsti događaja ili segmentu klijenata
• Sinkronizacija korisnika - Mapirajte korisnike Slack radnog prostora na Brevo kontakte za internu komunikaciju
• Interaktivne poruke - Šaljite bogate poruke s gumbima i akcijama za timske tijekove rada
• Zakazane poruke - Zakazujte obavijesti za dnevne/tjedne marketinške sažetke
• Podrška za teme razgovora - Grupirajte povezane obavijesti u temama za organiziranu komunikaciju

Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. Slack radni prostor s administratorskim pristupom
2. Slack aplikaciju kreiranu na api.slack.com/apps
3. Bot token s potrebnim opsezima
4. Brevo račun s API pristupom
5. Tajo račun

Autentifikacija

Bot Token (Preporučeno)

Instalirajte Slack aplikaciju u svom radnom prostoru i koristite bot token za API pristup.

1. Kreirajte aplikaciju na api.slack.com/apps
2. Dodajte potrebne OAuth opsege pod “OAuth & Permissions”
3. Instalirajte aplikaciju u radni prostor
4. Kopirajte 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": "Pozdrav iz Taja!"}'

OAuth 2.0

Za distribuciju Slack integracije na više radnih prostora:

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

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

Potrebni Bot opsezi

chat:write           # Slanje poruka
channels:read        # Popis kanala
channels:history     # Čitanje poruka kanala
users:read           # Popis korisnika radnog prostora
users:read.email     # Čitanje e-mail adresa korisnika
reactions:write      # Dodavanje reakcija na poruke
files:write          # Učitavanje datoteka

Konfiguracija

Osnovna konfiguracija

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

    # Kanali za obavijesti
    channels:
      marketing: "C01234567"
      sales: "C01234568"
      support: "C01234569"
      alerts: "C01234570"

    # Usmjeravanje događaja
    notifications:
      new_subscriber:
        channel: marketing
        template: subscriber_alert
      high_value_order:
        channel: sales
        template: order_alert
      support_ticket:
        channel: support
        template: ticket_alert

Mapiranje polja

Mapirajte Slack korisničke podatke na Brevo atribute kontakata:

API metode

Poruke

Kanali

Korisnici

Interakcije

Događaji

Obavijesti Brevo -> Slack

Okidači Slack -> Brevo

Primjeri koda

Inicijalizacija konektora

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

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

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

Slanje marketinških obavijesti

// Pošaljite obavijest kada je postavljena viskovrijedna narudžba
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: 'Nova viskovrijedna narudžba' }
      },
      {
        type: 'section',
        fields: [
          { type: 'mrkdwn', text: '*Korisnik:*\n[email protected]' },
          { type: 'mrkdwn', text: '*Iznos:*\n$1.250,00' }
        ]
      },
      {
        type: 'actions',
        elements: [
          {
            type: 'button',
            text: { type: 'plain_text', text: 'Pregledaj u Brevu' },
            url: 'https://app.brevo.com/contacts'
          }
        ]
      }
    ]
  }
});

Rukovanje Slack interakcijama

import crypto from 'crypto';

app.post('/slack/interactions', async (req, res) => {
  // Verificirajte Slack potpis zahtjeva
  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);

  // Upravljajte akcijama gumba
  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();
});

Ograničenja brzine

Slack API ograničenja brzine koriste slojeviti sustav:

Dodatna ograničenja:

• Web API: Naglasni limit s kratkoročnim ograničenjem
• Events API: Ponovne pokušaje isporuke za 3 pokušaja
• Dolazni webhookovi: 1 poruka/sekunda po URL-u webhookova
• Block Kit: Najviše 50 blokova po poruci

Rješavanje problema

Uobičajeni problemi

Način otklanjanja grešaka

Omogućite opširno bilježenje:

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

Testiranje veze

tajo connectors test slack
# ✓ Bot token valjani
# ✓ Radni prostor dostupan
# ✓ Kanali čitljivi
# ✓ Objava poruka omogućena
# ✓ Pretplate na događaje aktivne

Preporučene prakse

1. Koristite Block Kit - Gradite bogate, interaktivne poruke s Slackovim Block Kit okvirom
2. Brzo odgovarajte - Potvrdite interakcije u roku od 3 sekunde, asinkrono obradite
3. Grupirajte povezane poruke u teme razgovora - Smanjite buku grupiranjem obavijesti u temama
4. Usmjeravajte prema kanalu - Šaljite različite vrste događaja u odgovarajuće timske kanale
5. Uključite akcijske gumbe - Dodajte gumbe “Pregledaj u Brevu” za brzi pristup korisničkim podacima
6. Implementirajte unfurling - Prikažite bogate preglede Brevo veza dijeljenih u Slacku

Sigurnost

• Bot Token - OAuth opsežni pristupni token s granularnim dozvolama
• Potpisivanje zahtjeva - HMAC SHA-256 verifikacija potpisa za dolazne zahtjeve
• OAuth 2.0 - Industrijski standardna autorizacija za distribuciju u više radnih prostora
• TLS enkripcija - Sva API komunikacija šifrirana putem HTTPS
• Rotacija tokena - Automatska rotacija tokena za poboljšanu sigurnost

Povezani resursi

• Slack API dokumentacija
• Slack Block Kit Builder
• Slack Events API
• Brevo Konektor
• Vještina sinkronizacije korisnika