SendGrid konektor

Poveži svoj SendGrid nalog sa Brevo putem Tajo za migraciju email infrastrukture, sinhronizaciju kontakata, prenos podataka kampanja i unifikovanu analitiku angažovanja na obe platforme.

Pregled

Karakteristike

• Migracija kontakata - Migracija SendGrid Marketing kontakata u Brevo sa prilagođenim poljima
• Sinhronizacija transakcionih emailova - Praćenje transakcionih email događaja za unifikovano izveštavanje
• Podaci kampanje - Sinhronizacija podataka o performansama Single Send i Automation kampanja
• Event webhook-ovi - Prosleđivanje email događaja (dostavljeno, otvoreno, kliknuto, odbijeno) u Brevo
• Sinhronizacija suzbijanja - Migracija lista odbijanja, blokiranja i odjave radi usklađenosti
• Migracija šablona - Izvoz dinamičnih transakcionih šablona za upotrebu u Brevo
• Verifikacija pošiljaoca - Sinhronizacija verifikovanih identiteta pošiljaoca i autentifikacije domene
• Sinhronizacija statistika - Uvoz istorijskih statistika angažovanja u Brevo atribute

Preduslovi

Pre nego što započneš, proveri da imaš:

1. SendGrid nalog (Free, Essentials, Pro ili Premier)
2. SendGrid API ključ sa potrebnim dozvolama
3. Brevo nalog sa API pristupom
4. Tajo nalog

Autentifikacija

Autentifikacija API ključem

SendGrid koristi autentifikaciju bearer tokenom.

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

Kreiraj API ključeve u SendGrid Settings > API Keys sa specifičnim nivoima dozvola:

• Full Access - Kompletan API pristup
• Restricted Access - Granularna kontrola dozvola
• Billing Access - Operacije samo za naplatu

Potrebne dozvole

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

Konfiguracija

Osnovno podešavanje

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

Mapiranje polja

Mapiranje polja SendGrid kontakata na Brevo atribute kontakta:

Mapiranje prilagođenih polja

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 endpointi

Marketing kontakti

Transakcioni email (Mail Send)

Kampanje (Single Sends)

Statistike

Suzbijanja

Događaji

Email događaji (putem Event Webhook-a)

Primeri koda

Inicijalizacija konektora

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

Migracija kontakata u 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
// }

Prosleđivanje email događaja

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

Ograničenja brzine

Ograničenja brzine SendGrid API-ja:

Rešavanje problema

Česti problemi

Debug režim

Uključi detaljno logovanje:

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

Testiraj vezu

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

Najbolje prakse

1. Najpre migrišu suzbijanja - Osiguraj da su odbijanja, blokiranja i odjave u Brevo pre slanja
2. Koristi batch uploadove kontakata - PUT do 30.000 kontakata po zahtevu radi efikasnosti
3. Verifikuj Event Webhook - Omogući potpisane webhook-ove sa ECDSA verifikacijom
4. Mapiraj prilagođena polja - Kreiraj odgovarajuće Brevo atribute pre migracije kontakata
5. Sinhronizuj podatke o angažovanju - Uvezi istorijske statistike za segmentaciju u Brevo
6. Obrađuj asinhroni izvoz - Izvozi kontakata su asinhroni; ispitivaj do završetka

Bezbednost

• Autentifikacija API ključem - Bearer token sa granularnim nivoima dozvola
• Potpisivanje Event Webhook-a - ECDSA verifikacija potpisa za webhook payloade
• TLS enkripcija - Sva API komunikacija enkriptovana putem HTTPS
• Upravljanje IP pristupom - Ograniči pristup Dashboard-u i API-ju po IP adresi
• Dvofaktorska autentifikacija - 2FA dostupna za pristup nalogu

Povezani resursi

• SendGrid API dokumentacija
• SendGrid Event Webhook vodič
• Brevo konektor
• Mailchimp konektor
• Customer Sync veština