Konektor Slack

Hubungkan workspace Slack Anda ke Brevo melalui Tajo untuk notifikasi pemasaran real-time, peringatan tim atas event pelanggan, dan otomatisasi alur kerja yang dipicu oleh interaksi di Slack.

Ikhtisar

Fitur

• Peringatan pemasaran - Kirim notifikasi real-time untuk event kampanye, pelanggan email baru, dan pencapaian pendapatan
• Notifikasi event pelanggan - Beri tahu tim tentang aksi pelanggan bernilai tinggi dari Brevo
• Pemicu alur kerja - Gunakan interaksi Slack (klik tombol, pengiriman formulir) untuk memicu otomatisasi Brevo
• Perutean berbasis channel - Arahkan notifikasi ke channel tertentu berdasarkan jenis event atau segmen pelanggan
• Sinkronisasi pengguna - Petakan pengguna workspace Slack ke kontak Brevo untuk komunikasi internal
• Pesan interaktif - Kirim pesan kaya dengan tombol dan aksi untuk alur kerja tim
• Pesan terjadwal - Jadwalkan notifikasi untuk ringkasan pemasaran harian atau mingguan
• Dukungan thread - Kelompokkan notifikasi terkait dalam thread agar komunikasi tetap rapi

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. Workspace Slack dengan akses admin
2. Aplikasi Slack yang dibuat di api.slack.com/apps
3. Bot token dengan scope yang diperlukan
4. Akun Brevo dengan akses API
5. Akun Tajo

Autentikasi

Bot token (disarankan)

Pasang aplikasi Slack ke workspace Anda dan gunakan bot token untuk akses API.

1. Buat aplikasi di api.slack.com/apps
2. Tambahkan scope OAuth yang diperlukan pada “OAuth & Permissions”
3. Pasang aplikasi ke workspace
4. Salin 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

Untuk mendistribusikan integrasi Slack Anda ke banyak workspace:

# 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}"

Scope bot yang diperlukan

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

Konfigurasi

Penyiapan dasar

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

Pemetaan field

Petakan data pengguna Slack ke atribut kontak Brevo:

Metode API

Perpesanan

Channel

Pengguna

Interaksi

Event

Notifikasi Brevo ke Slack

Pemicu Slack ke Brevo

Contoh kode

Inisialisasi konektor

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
});

Kirim notifikasi pemasaran

// 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'
          }
        ]
      }
    ]
  }
});

Tangani interaksi 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();
});

Batas rate

Batas rate API Slack memakai sistem berjenjang:

Batas tambahan:

• Web API: batas burst dengan throttle jangka pendek
• Events API: pengiriman ulang hingga 3 percobaan
• Incoming Webhooks: 1 pesan/detik per URL webhook
• Block Kit: maksimum 50 block per pesan

Pemecahan masalah

Masalah umum

Mode debug

Aktifkan logging verbose:

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

Uji koneksi

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

Praktik terbaik

1. Gunakan Block Kit - Bangun pesan interaktif yang kaya dengan framework Block Kit milik Slack
2. Balas dengan cepat - Konfirmasi interaksi dalam 3 detik, lalu proses secara asinkron
3. Kelompokkan pesan dalam thread - Satukan notifikasi terkait dalam thread untuk menekan noise
4. Rutekan per channel - Kirim jenis event yang berbeda ke channel tim yang sesuai
5. Sertakan tombol aksi - Tambahkan tombol “View in Brevo” agar data pelanggan cepat diakses
6. Terapkan unfurling - Tampilkan pratinjau kaya untuk tautan Brevo yang dibagikan di Slack

Keamanan

• Bot token - Token akses ber-scope OAuth dengan izin yang granular
• Penandatanganan permintaan - Verifikasi tanda tangan HMAC SHA-256 untuk permintaan masuk
• OAuth 2.0 - Standar industri untuk otorisasi distribusi lintas workspace
• Enkripsi TLS - Seluruh komunikasi API terenkripsi melalui HTTPS
• Rotasi token - Rotasi token otomatis untuk keamanan yang lebih baik

Sumber daya terkait

• Dokumentasi API Slack
• Slack Block Kit Builder
• Slack Events API
• Konektor Brevo
• Skill Customer Sync