Slack Connector

เชื่อมต่อ Slack workspace กับ Brevo ผ่าน Tajo สำหรับการแจ้งเตือนทางการตลาดแบบเรียลไทม์ การแจ้งเตือนทีมงานเกี่ยวกับเหตุการณ์ลูกค้า และระบบอัตโนมัติเวิร์กโฟลว์ที่ทริกเกอร์จากการโต้ตอบ Slack

ภาพรวม

ฟีเจอร์

• การแจ้งเตือนทางการตลาด - ส่งการแจ้งเตือนแบบเรียลไทม์สำหรับเหตุการณ์แคมเปญ สมาชิกใหม่ และ revenue milestones
• การแจ้งเตือนเหตุการณ์ลูกค้า - แจ้งทีมงานเกี่ยวกับการกระทำของลูกค้าที่มีมูลค่าสูงจาก Brevo
• ทริกเกอร์เวิร์กโฟลว์ - ใช้การโต้ตอบ Slack (คลิกปุ่ม การส่งฟอร์ม) เพื่อทริกเกอร์ระบบอัตโนมัติ Brevo
• การกำหนดเส้นทางตาม channel - กำหนดเส้นทางการแจ้งเตือนไปยัง channels ที่เฉพาะเจาะจงตามประเภทเหตุการณ์หรือ customer segment
• การซิงค์ผู้ใช้ - แมปผู้ใช้ Slack workspace กับผู้ติดต่อ Brevo สำหรับการสื่อสารภายใน
• ข้อความโต้ตอบ - ส่งข้อความที่สมบูรณ์พร้อมปุ่มและการกระทำสำหรับเวิร์กโฟลว์ทีม
• ข้อความตามกำหนดเวลา - กำหนดเวลาการแจ้งเตือนสำหรับสรุปการตลาดรายวัน/รายสัปดาห์
• รองรับ Thread - จัดกลุ่มการแจ้งเตือนที่เกี่ยวข้องใน threads เพื่อการสื่อสารที่เป็นระเบียบ

ข้อกำหนดเบื้องต้น

ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณมี:

1. Slack workspace ที่มีสิทธิ์ผู้ดูแลระบบ
2. Slack app ที่สร้างที่ api.slack.com/apps
3. Bot token ที่มี scopes ที่จำเป็น
4. บัญชี Brevo ที่มีสิทธิ์เข้าถึง API
5. บัญชี Tajo

การยืนยันตัวตน

Bot Token (แนะนำ)

ติดตั้ง Slack app ในพื้นที่ทำงานของคุณและใช้ bot token สำหรับการเข้าถึง API

1. สร้าง app ที่ api.slack.com/apps
2. เพิ่ม OAuth scopes ที่จำเป็นใต้ “OAuth & Permissions”
3. ติดตั้ง app ในพื้นที่ทำงาน
4. คัดลอก 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

สำหรับการแจกจ่าย Slack integration ของคุณไปยังหลาย 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}"

Bot Scopes ที่จำเป็น

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

การกำหนดค่า

การตั้งค่าพื้นฐาน

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

การแมปฟิลด์

แมปข้อมูลผู้ใช้ Slack กับแอตทริบิวต์ผู้ติดต่อ Brevo:

เมธอด API

การส่งข้อความ

Channels

ผู้ใช้

การโต้ตอบ

เหตุการณ์

การแจ้งเตือน Brevo ไปยัง Slack

ทริกเกอร์ Slack ไปยัง Brevo

ตัวอย่างโค้ด

เริ่มต้น Connector

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

ส่งการแจ้งเตือนทางการตลาด

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

จัดการการโต้ตอบ 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();
});

ขีดจำกัดอัตรา

Slack API rate limits ใช้ระบบหลายระดับ:

ขีดจำกัดเพิ่มเติม:

• Web API: Burst limit พร้อม short-term throttle
• Events API: ลองส่งซ้ำ 3 ครั้ง
• Incoming Webhooks: 1 ข้อความ/วินาทีต่อ webhook URL
• Block Kit: สูงสุด 50 blocks ต่อข้อความ

การแก้ไขปัญหา

ปัญหาทั่วไป

โหมด Debug

เปิดใช้งาน verbose logging:

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

ทดสอบการเชื่อมต่อ

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

แนวทางปฏิบัติที่ดีที่สุด

1. ใช้ Block Kit - สร้างข้อความที่สมบูรณ์และโต้ตอบได้ด้วย Block Kit framework ของ Slack
2. ตอบสนองอย่างรวดเร็ว - ยืนยันการโต้ตอบภายใน 3 วินาที ประมวลผลแบบ asynchronous
3. จัดกลุ่มข้อความที่เกี่ยวข้องใน threads - จัดกลุ่มการแจ้งเตือนที่เกี่ยวข้องใน threads เพื่อลด noise
4. กำหนดเส้นทางตาม channel - ส่งประเภทเหตุการณ์ที่แตกต่างกันไปยัง channels ของทีมที่เหมาะสม
5. รวมปุ่มการกระทำ - เพิ่มปุ่ม “View in Brevo” สำหรับการเข้าถึงข้อมูลลูกค้าอย่างรวดเร็ว
6. ใช้ unfurling - แสดงตัวอย่าง rich previews สำหรับลิงก์ Brevo ที่แชร์ใน Slack

ความปลอดภัย

• Bot Token - OAuth-scoped access token พร้อมสิทธิ์แบบละเอียด
• การตรวจสอบลายเซ็นคำขอ - HMAC SHA-256 signature verification สำหรับคำขอขาเข้า
• OAuth 2.0 - การอนุญาตมาตรฐานอุตสาหกรรมสำหรับการแจกจ่ายหลาย workspace
• การเข้ารหัส TLS - การสื่อสาร API ทั้งหมดเข้ารหัสผ่าน HTTPS
• การหมุนเวียน token - การหมุนเวียน token อัตโนมัติสำหรับความปลอดภัยที่เพิ่มขึ้น

แหล่งข้อมูลที่เกี่ยวข้อง

• Slack API Documentation
• Slack Block Kit Builder
• Slack Events API
• Brevo Connector
• Customer Sync Skill