SendGrid Bağlayıcısı

E-posta altyapısı taşıma, kişi senkronizasyonu, kampanya verisi aktarımı ve her iki platformda birleşik etkileşim analitiği için SendGrid hesabınızı Tajo aracılığıyla Brevo’ya bağlayın.

Genel Bakış

Özellikler

• Kişi taşıma - SendGrid Marketing kişilerini özel alanlarla Brevo’ya taşıyın
• İşlemsel e-posta senkronizasyonu - Birleşik raporlama için işlemsel e-posta olaylarını takip edin
• Kampanya verileri - Single Send ve Automation kampanya performans verilerini senkronize edin
• Olay webhook’ları - E-posta olaylarını (teslim edildi, açıldı, tıklandı, geri döndü) Brevo’ya iletin
• Bastırma senkronizasyonu - Uyumluluk için geri dönme, engelleme ve abonelikten çıkma listelerini taşıyın
• Şablon taşıma - Brevo kullanımı için Dynamic Transactional Templates dışa aktarın
• Gönderici doğrulama - Doğrulanmış gönderici kimliklerini ve alan adı kimlik doğrulamasını senkronize edin
• İstatistik senkronizasyonu - Geçmiş etkileşim istatistiklerini Brevo özniteliklerine içe aktarın

Ön Koşullar

Başlamadan önce sahip olmanız gerekenler:

1. Bir SendGrid hesabı (Free, Essentials, Pro veya Premier)
2. Gerekli izinlere sahip bir SendGrid API anahtarı
3. API erişimi olan bir Brevo hesabı
4. Bir Tajo hesabı

Kimlik Doğrulama

API Anahtar Kimlik Doğrulaması

SendGrid bearer belirteç kimlik doğrulaması kullanır.

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

SendGrid Settings > API Keys’te belirli izin seviyeleriyle API anahtarları oluşturun:

• Full Access - Tam API erişimi
• Restricted Access - Ayrıntılı izin kontrolü
• Billing Access - Yalnızca faturalama işlemleri

Gerekli İzinler

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

Yapılandırma

Temel Kurulum

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

Alan Eşleme

SendGrid kişi alanlarını Brevo kişi özniteliklerine eşleyin:

Özel Alan Eşleme

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 Uç Noktaları

Marketing Kişileri

İşlemsel E-posta (Mail Send)

Kampanyalar (Single Sends)

İstatistikler

Bastırmalar

Olaylar

E-posta Olayları (Event Webhook üzerinden)

Kod Örnekleri

Bağlayıcıyı Başlat

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

Kişileri Brevo’ya Taşı

// 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
// }

E-posta Olaylarını İlet

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

Hız Limitleri

SendGrid API hız limitleri:

Sorun Giderme

Sık Karşılaşılan Sorunlar

Hata Ayıklama Modu

Ayrıntılı günlüklemeyi etkinleştirin:

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

Bağlantıyı Test Et

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

En İyi Uygulamalar

1. Önce bastırmaları taşıyın - Gönderim öncesinde geri dönmelerin, engellemelerin ve abonelikten çıkmaların Brevo’da olduğundan emin olun
2. Toplu kişi yüklemeleri kullanın - Verimlilik için istek başına 30.000 kişiye kadar PUT yapın
3. Event Webhook’u doğrulayın - ECDSA doğrulamasıyla imzalı webhook’ları etkinleştirin
4. Özel alanları eşleyin - Kişi taşımadan önce karşılık gelen Brevo özniteliklerini oluşturun
5. Etkileşim verilerini senkronize edin - Brevo’da segmentasyon için geçmiş istatistikleri içe aktarın
6. Eşzamansız dışa aktarmaları yönetin - Kişi dışa aktarmaları eşzamansızdır; tamamlanma için sorgulayın

Güvenlik

• API Anahtar Kimlik Doğrulaması - Ayrıntılı izin seviyeleri ile bearer belirteç
• Event Webhook imzalama - Webhook yükleri için ECDSA imza doğrulaması
• TLS şifrelemesi - Tüm API iletişimi HTTPS aracılığıyla şifrelenir
• IP Erişim Yönetimi - Dashboard ve API erişimini IP’ye göre kısıtlayın
• İki faktörlü kimlik doğrulama - Hesap erişimi için 2FA mevcuttur

İlgili Kaynaklar

• SendGrid API Dokümantasyonu
• SendGrid Event Webhook Rehberi
• Brevo Bağlayıcısı
• Mailchimp Bağlayıcısı
• Müşteri Senkronizasyon Yeteneği