Slack Bağlayıcısı

Gerçek zamanlı pazarlama bildirimleri, müşteri olaylarına ilişkin ekip uyarıları ve Slack etkileşimleriyle tetiklenen iş akışı otomasyonu için Slack çalışma alanınızı Tajo üzerinden Brevo’ya bağlayın.

Genel Bakış

Özellikler

• Pazarlama uyarıları - Kampanya olayları, yeni aboneler ve gelir kilometre taşları için gerçek zamanlı bildirimler gönderin
• Müşteri olay bildirimleri - Brevo’dan yüksek değerli müşteri eylemleri hakkında ekipleri uyarın
• İş akışı tetikleyicileri - Brevo otomasyonlarını tetiklemek için Slack etkileşimlerini (düğme tıklamaları, form gönderimleri) kullanın
• Kanal tabanlı yönlendirme - Olay türüne veya müşteri segmentine göre bildirimleri belirli kanallara yönlendirin
• Kullanıcı senkronizasyonu - Dahili iletişim için Slack çalışma alanı kullanıcılarını Brevo kişileriyle eşleştirin
• Etkileşimli mesajlar - Ekip iş akışları için düğmeler ve eylemler içeren zengin mesajlar gönderin
• Planlı mesajlar - Günlük/haftalık pazarlama özetleri için bildirimler planlayın
• İş parçacığı desteği - Düzenli iletişim için ilgili bildirimleri iş parçacıklarında gruplayın

Ön Koşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

1. Yönetici erişimi olan bir Slack çalışma alanı
2. api.slack.com/apps adresinde oluşturulmuş bir Slack uygulaması
3. Gerekli kapsamları olan bir bot belirteci
4. API erişimi olan bir Brevo hesabı
5. Bir Tajo hesabı

Kimlik Doğrulama

Bot Belirteci (Önerilen)

Slack uygulamasını çalışma alanınıza yükleyin ve API erişimi için bot belirtecini kullanın.

1. api.slack.com/apps adresinde uygulama oluşturun
2. “OAuth & Permissions” altında gerekli OAuth kapsamlarını ekleyin
3. Uygulamayı çalışma alanına yükleyin
4. Bot User OAuth Token’ı kopyalayın (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

Slack entegrasyonunuzu birden fazla çalışma alanına dağıtmak için:

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

# Belirteç değişimi
curl -X POST "https://slack.com/api/oauth.v2.access" \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}" \
  -d "code={auth_code}"

Gerekli Bot Kapsamları

chat:write           # Mesaj gönder
channels:read        # Kanalları listele
channels:history     # Kanal mesajlarını oku
users:read           # Çalışma alanı kullanıcılarını listele
users:read.email     # Kullanıcı e-posta adreslerini oku
reactions:write      # Mesajlara tepki ekle
files:write          # Dosya yükle

Yapılandırma

Temel Kurulum

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

    # Bildirim kanalları
    channels:
      marketing: "C01234567"
      sales: "C01234568"
      support: "C01234569"
      alerts: "C01234570"

    # Olay yönlendirme
    notifications:
      new_subscriber:
        channel: marketing
        template: subscriber_alert
      high_value_order:
        channel: sales
        template: order_alert
      support_ticket:
        channel: support
        template: ticket_alert

Alan Eşleştirme

Slack kullanıcı verilerini Brevo kişi özniteliklerine eşleyin:

API Yöntemleri

Mesajlaşma

Kanallar

Kullanıcılar

Etkileşimler

Olaylar

Brevo’dan Slack’e Bildirimler

Slack’ten Brevo’ya Tetikleyiciler

Kod Örnekleri

Bağlayıcıyı Başlatma

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

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

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

Pazarlama Bildirimleri Gönderme

// Yüksek değerli bir sipariş verildiğinde bildirim gönder
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'
          }
        ]
      }
    ]
  }
});

Slack Etkileşimlerini İşleme

import crypto from 'crypto';

app.post('/slack/interactions', async (req, res) => {
  // Slack istek imzasını doğrula
  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);

  // Düğme eylemlerini işle
  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();
});

Hız Sınırları

Slack API hız sınırları katmanlı bir sistem kullanır:

Ek sınırlar:

• Web API: Kısa süreli kısıtlamayla patlama sınırı
• Events API: 3 denemeye kadar teslimat yeniden denemeleri
• Incoming Webhooks: Webhook URL’si başına saniyede 1 mesaj
• Block Kit: Mesaj başına maksimum 50 blok

Sorun Giderme

Yaygın Sorunlar

Hata Ayıklama Modu

Ayrıntılı günlük kaydını etkinleştirin:

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

Bağlantı Testi

tajo connectors test slack
# ✓ Bot belirteci geçerli
# ✓ Çalışma alanı erişilebilir
# ✓ Kanallar okunabilir
# ✓ Mesaj gönderme etkin
# ✓ Olay abonelikleri aktif

En İyi Uygulamalar

1. Block Kit kullanın - Slack’in Block Kit çerçevesiyle zengin, etkileşimli mesajlar oluşturun
2. Hızlı yanıt verin - Etkileşimleri 3 saniye içinde onaylayın, eşzamansız işleyin
3. İlgili mesajları iş parçacığına alın - Gürültüyü azaltmak için ilgili bildirimleri iş parçacıklarında gruplayın
4. Kanala göre yönlendirin - Farklı olay türlerini uygun ekip kanallarına gönderin
5. Eylem düğmeleri ekleyin - Müşteri verilerine hızlı erişim için “View in Brevo” düğmeleri ekleyin
6. Açılımı uygulayın - Slack’te paylaşılan Brevo bağlantıları için zengin önizlemeler gösterin

Güvenlik

• Bot Belirteci - Ayrıntılı izinlere sahip OAuth kapsamlı erişim belirteci
• İstek imzalama - Gelen istekler için HMAC SHA-256 imza doğrulaması
• OAuth 2.0 - Çoklu çalışma alanı dağıtımı için endüstri standardı yetkilendirme
• TLS şifreleme - Tüm API iletişimi HTTPS ile şifrelenir
• Belirteç rotasyonu - Gelişmiş güvenlik için otomatik belirteç rotasyonu

İlgili Kaynaklar

• Slack API Belgeleri
• Slack Block Kit Builder
• Slack Events API
• Brevo Bağlayıcısı
• Müşteri Senkronizasyonu Yeteneği