SendGrid کنیکٹر

ای میل بنیادی ڈھانچہ منتقلی، رابطہ سنکرونائزیشن، مہم ڈیٹا منتقلی، اور دونوں پلیٹ فارمز پر متحدہ engagement اینالیٹکس کے لیے Tajo کے ذریعے اپنے SendGrid اکاؤنٹ کو Brevo سے منسلک کریں۔

جائزہ

خصوصیات

• رابطہ منتقلی - SendGrid Marketing رابطوں کو کسٹم فیلڈز کے ساتھ Brevo میں منتقل کریں
• ٹرانزیکشنل ای میل سنک - متحدہ رپورٹنگ کے لیے ٹرانزیکشنل ای میل ایونٹس ٹریک کریں
• مہم ڈیٹا - Single Send اور Automation مہم کارکردگی ڈیٹا سنک کریں
• ایونٹ webhooks - ای میل ایونٹس (delivered, opened, clicked, bounced) کو Brevo کو فارورڈ کریں
• Suppression سنک - کمپلائنس کے لیے bounce, block, اور unsubscribe فہرستیں منتقل کریں
• Template منتقلی - Brevo استعمال کے لیے Dynamic Transactional Templates ایکسپورٹ کریں
• Sender تصدیق - تصدیق شدہ sender شناختیں اور domain تصدیق سنک کریں
• اعدادوشمار سنک - تاریخی engagement اعدادوشمار کو Brevo خصوصیات میں امپورٹ کریں

شرائط

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

1. SendGrid اکاؤنٹ (Free, Essentials, Pro, یا Premier)
2. مطلوبہ اجازتوں کے ساتھ SendGrid API key
3. API رسائی کے ساتھ Brevo اکاؤنٹ
4. Tajo اکاؤنٹ

تصدیق

API Key تصدیق

SendGrid bearer token تصدیق استعمال کرتا ہے۔

curl https://api.sendgrid.com/v3/marketing/contacts \
  -H "Authorization: Bearer SG.YOUR_API_KEY" \
  -H "Content-Type: application/json"

SendGrid Settings > API Keys میں مخصوص اجازت کی سطحوں کے ساتھ API keys بنائیں:

• Full Access - مکمل API رسائی
• Restricted Access - گرانولر اجازت کنٹرول
• Billing Access - صرف بلنگ آپریشنز

مطلوبہ اجازتیں

Marketing: Full Access
  - Contacts (read)
  - Single Sends (read)
  - Automations (read)
Mail Send: Full Access
  - Mail Send (read)
Stats: Read Access
Suppressions: Read Access
Tracking: Read Access

تشکیل

بنیادی سیٹ اپ

connectors:
  sendgrid:
    enabled: true
    api_key: "${SENDGRID_API_KEY}"

    # Data sync options
    sync:
      contacts: true
      campaigns: true
      transactional: true
      suppressions: true
      statistics: true

    # List mapping to Brevo
    list_mapping:
      "All Contacts": 60
      "Newsletter": 61
      "Transactional": 62

فیلڈ میپنگ

SendGrid رابطہ فیلڈز کو Brevo رابطہ خصوصیات پر میپ کریں:

کسٹم فیلڈ میپنگ

field_mapping:
  # Standard fields
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone_number: SMS

  # Location fields
  city: CITY
  state_province_region: STATE
  country: COUNTRY
  postal_code: POSTAL_CODE

  # Engagement metrics
  avg_open_rate: AVG_OPEN_RATE
  avg_click_rate: AVG_CLICK_RATE

  # Custom fields
  custom_fields.company: COMPANY_NAME
  custom_fields.plan: PLAN_TYPE

API اینڈ پوائنٹس

Marketing رابطے

ٹرانزیکشنل ای میل (Mail Send)

مہمات (Single Sends)

اعدادوشمار

Suppressions

ایونٹس

ای میل ایونٹس (Event Webhook کے ذریعے)

کوڈ کی مثالیں

کنیکٹر کو انیشیلائز کریں

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

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

// Connect SendGrid
await tajo.connectors.connect('sendgrid', {
  apiKey: process.env.SENDGRID_API_KEY
});

رابطوں کو Brevo میں منتقل کریں

// Full contact migration from SendGrid to Brevo
await tajo.connectors.sync('sendgrid', {
  type: 'full',
  resources: ['contacts', 'suppressions'],
  options: {
    includeCustomFields: true,
    migrateListMemberships: true,
    migrateSuppressions: true
  }
});

// Check migration status
const status = await tajo.connectors.status('sendgrid');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 45000,
//   suppressionsSynced: 3200,
//   listsMapped: 8
// }

ای میل ایونٹس فارورڈ کریں

// Handle SendGrid Event Webhook
app.post('/webhooks/sendgrid', async (req, res) => {
  const signature = req.get('X-Twilio-Email-Event-Webhook-Signature');

  // Verify webhook signature (ECDSA)
  if (!verifySendGridSignature(req.body, signature)) {
    return res.status(401).send('Unauthorized');
  }

  // Process batch of events
  for (const event of req.body) {
    await tajo.connectors.handleWebhook('sendgrid', {
      type: event.event,
      email: event.email,
      timestamp: event.timestamp,
      payload: event
    });
  }

  res.status(200).send('OK');
});

شرح کی حدود

SendGrid API شرح کی حدود:

ٹربل شوٹنگ

عام مسائل

ڈیبگ موڈ

تفصیلی لاگنگ فعال کریں:

connectors:
  sendgrid:
    debug: true
    log_level: verbose
    log_webhooks: true

کنکشن ٹیسٹ کریں

tajo connectors test sendgrid
# ✓ API connection successful
# ✓ Contacts readable
# ✓ Lists accessible
# ✓ Statistics readable
# ✓ Suppressions accessible

بہترین طرز عمل

1. پہلے suppressions منتقل کریں - بھیجنے سے پہلے یقینی بنائیں کہ bounces, blocks, اور unsubscribes Brevo میں ہیں
2. بیچ رابطہ اپ لوڈز استعمال کریں - کارکردگی کے لیے فی درخواست 30,000 رابطوں تک PUT کریں
3. Event Webhook کی تصدیق کریں - ECDSA تصدیق کے ساتھ دستخط شدہ webhooks فعال کریں
4. کسٹم فیلڈز میپ کریں - رابطہ منتقلی سے پہلے متعلقہ Brevo خصوصیات بنائیں
5. Engagement ڈیٹا سنک کریں - Brevo میں segmentation کے لیے تاریخی stats امپورٹ کریں
6. Async exports کو سنبھالیں - رابطہ exports asynchronous ہیں؛ مکمل ہونے کے لیے poll کریں

سیکیورٹی

• API Key تصدیق - گرانولر اجازت کی سطحوں کے ساتھ Bearer token
• Event Webhook دستخط - webhook payloads کے لیے ECDSA دستخط کی توثیق
• TLS انکرپشن - تمام API مواصلات HTTPS کے ذریعے انکرپٹڈ
• IP Access Management - IP کے ذریعے Dashboard اور API رسائی کو محدود کریں
• دو عنصر تصدیق - اکاؤنٹ رسائی کے لیے 2FA دستیاب

متعلقہ وسائل

• SendGrid API دستاویزات
• SendGrid Event Webhook گائیڈ
• Brevo کنیکٹر
• Mailchimp کنیکٹر
• گاہک سنک اسکل