موصل Slack

اربط مساحة عمل Slack الخاصة بك بـ Brevo عبر Tajo للحصول على إشعارات تسويقية في الوقت الفعلي، وتنبيهات الفريق بشأن أحداث العملاء، وأتمتة سير العمل المُشغَّلة بواسطة تفاعلات Slack.

نظرة عامة

الميزات

• تنبيهات التسويق - إرسال إشعارات في الوقت الفعلي لأحداث الحملات، والمشتركين الجدد، ومعالم الإيرادات
• إشعارات أحداث العملاء - تنبيه الفرق حول إجراءات العملاء عالية القيمة من Brevo
• محفزات سير العمل - استخدام تفاعلات Slack (نقرات الأزرار، إرسال النماذج) لتشغيل أتمتة Brevo
• التوجيه القائم على القنوات - توجيه الإشعارات إلى قنوات محددة بناءً على نوع الحدث أو شريحة العميل
• مزامنة المستخدمين - ربط مستخدمي مساحة عمل Slack بجهات اتصال Brevo للاتصالات الداخلية
• الرسائل التفاعلية - إرسال رسائل غنية بالأزرار والإجراءات لسير عمل الفريق
• الرسائل المجدولة - جدولة الإشعارات للملخصات التسويقية اليومية/الأسبوعية
• دعم المحادثات - تجميع الإشعارات ذات الصلة في محادثات لاتصال منظم

المتطلبات الأساسية

قبل البدء، تأكد من توفر ما يلي:

1. مساحة عمل Slack مع صلاحيات مسؤول
2. تطبيق Slack مُنشأ على api.slack.com/apps
3. رمز Bot مع النطاقات المطلوبة
4. حساب Brevo مع وصول إلى API
5. حساب Tajo

المصادقة

رمز Bot (موصى به)

قم بتثبيت تطبيق Slack في مساحة العمل الخاصة بك واستخدم رمز Bot للوصول إلى API.

1. أنشئ التطبيق على api.slack.com/apps
2. أضف نطاقات OAuth المطلوبة ضمن “OAuth & Permissions”
3. ثبّت التطبيق في مساحة العمل
4. انسخ رمز Bot User OAuth (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 الخاص بك على مساحات عمل متعددة:

# 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 المطلوبة

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

المراسلة

القنوات

المستخدمون

التفاعلات

الأحداث

إشعارات Brevo إلى Slack

محفزات Slack إلى Brevo

أمثلة على الكود

تهيئة الموصل

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

إرسال إشعارات التسويق

// إرسال إشعار عند وضع طلب عالي القيمة
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) => {
  // التحقق من توقيع طلب 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);

  // التعامل مع إجراءات الزر
  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 نظامًا متدرجًا:

حدود إضافية:

• Web API: حد الدفعات مع تقييد قصير المدى
• Events API: محاولات تسليم لثلاث مرات
• Incoming Webhooks: رسالة واحدة/ثانية لكل عنوان URL webhook
• Block Kit: 50 كتلة كحد أقصى لكل رسالة

استكشاف الأخطاء وإصلاحها

المشاكل الشائعة

وضع التصحيح

تفعيل التسجيل المفصل:

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 من Slack
2. استجب بسرعة - أقرّ بالتفاعلات في غضون 3 ثوان، عالج بشكل غير متزامن
3. استخدم محادثات للرسائل ذات الصلة - جمّع الإشعارات ذات الصلة في محادثات لتقليل الضوضاء
4. وجّه حسب القناة - أرسل أنواع أحداث مختلفة إلى قنوات الفرق المناسبة
5. ضمّن أزرار الإجراءات - أضف أزرار “عرض في Brevo” للوصول السريع إلى بيانات العملاء
6. طبّق Unfurling - أظهر معاينات غنية لروابط Brevo المشتركة في Slack

الأمان

• رمز Bot - رمز وصول مقيّد بنطاق OAuth مع صلاحيات دقيقة
• توقيع الطلبات - التحقق من توقيع HMAC SHA-256 للطلبات الواردة
• OAuth 2.0 - تفويض بمعايير الصناعة للتوزيع متعدد مساحات العمل
• تشفير TLS - جميع اتصالات API مشفرة عبر HTTPS
• تدوير الرموز - تدوير تلقائي للرموز لأمان معزز

موارد ذات صلة

• وثائق Slack API
• Slack Block Kit Builder
• Slack Events API
• موصل Brevo
• مهارة مزامنة العملاء