SendGrid Konektor

Povežite vaš SendGrid račun s Brevom putem Taja za migraciju e-mail infrastrukture, sinkronizaciju kontakata, prijenos podataka o kampanjama i ujedinjenu analitiku angažmana na obje platforme.

Pregled

Značajke

• Migracija kontakata - Migracija SendGrid Marketing kontakata u Brevo s prilagođenim poljima
• Sinkronizacija transakcijskih e-mailova - Praćenje transakcijskih e-mail događaja za ujedinjeno izvješćivanje
• Podaci o kampanjama - Sinkronizacija podataka o performansama Single Send i Automation kampanja
• Webhook događaji - Prosljeđivanje e-mail događaja (dostavljeno, otvoreno, kliknuto, vraćeno) u Brevo
• Sinkronizacija supresija - Migracija popisa vraćenih, blokiranih i odjavljenih za usklađenost
• Migracija predložaka - Izvoz Dynamic Transactional Templates za korištenje u Brevo
• Verifikacija pošiljatelja - Sinkronizacija verificiranih identiteta pošiljatelja i autentifikacije domene
• Sinkronizacija statistika - Uvoz historijskih statistika angažmana u Brevo atribute

Preduvjeti

Prije nego što počnete, osigurajte da imate:

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

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"

Kreirajte API ključeve u SendGrid Postavkama > API ključevi s određenim razinama dozvola:

• Puni pristup - Potpuni API pristup
• Ograničeni pristup - Granularna kontrola dozvola
• Pristup naplati - 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

Osnovna konfiguracija

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

    # Opcije sinkronizacije podataka
    sync:
      contacts: true
      campaigns: true
      transactional: true
      suppressions: true
      statistics: true

    # Mapiranje popisa na Brevo
    list_mapping:
      "All Contacts": 60
      "Newsletter": 61
      "Transactional": 62

Mapiranje polja

Mapirajte polja kontakata SendGrida na Brevo atribute kontakata:

Mapiranje prilagođenih polja

field_mapping:
  # Standardna polja
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone_number: SMS

  # Polja lokacije
  city: CITY
  state_province_region: STATE
  country: COUNTRY
  postal_code: POSTAL_CODE

  # Metrike angažmana
  avg_open_rate: AVG_OPEN_RATE
  avg_click_rate: AVG_CLICK_RATE

  # Prilagođena polja
  custom_fields.company: COMPANY_NAME
  custom_fields.plan: PLAN_TYPE

API krajnje točke

Marketinški kontakti

Transakcijski e-mail (Mail Send)

Kampanje (Single Sends)

Statistike

Supresije

Događaji

E-mail događaji (putem Event Webhookova)

Primjeri koda

Inicijalizacija konektora

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

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

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

Migracija kontakata u Brevo

// Potpuna migracija kontakata iz SendGrida u Brevo
await tajo.connectors.sync('sendgrid', {
  type: 'full',
  resources: ['contacts', 'suppressions'],
  options: {
    includeCustomFields: true,
    migrateListMemberships: true,
    migrateSuppressions: true
  }
});

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

Prosljeđivanje e-mail događaja

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

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

  // Obradite seriju događaja
  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:

Rješavanje problema

Uobičajeni problemi

Način otklanjanja grešaka

Omogućite detaljno zapisivanje:

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

Testiranje veze

tajo connectors test sendgrid
# ✓ API veza uspješna
# ✓ Kontakti čitljivi
# ✓ Popisi dostupni
# ✓ Statistike čitljive
# ✓ Supresije dostupne

Preporučene prakse

1. Prvo migrirajte supresije - Osigurajte da su vraćene, blokirane i odjavljene adrese u Brevo prije slanja
2. Koristite skupna učitavanja kontakata - PUT do 30.000 kontakata po zahtjevu za učinkovitost
3. Verificirajte Event Webhook - Omogućite potpisane webhookove s ECDSA verifikacijom
4. Mapirajte prilagođena polja - Kreirajte odgovarajuće Brevo atribute prije migracije kontakata
5. Sinkronizirajte podatke o angažmanu - Uvezite historijske statistike za segmentaciju u Brevo
6. Rukujte asinkronim izvozima - Izvozi kontakata su asinkroni; anketirajte za dovršetak

Sigurnost

• Autentifikacija API ključem - Bearer token s granularnim razinama dozvola
• Potpisivanje Event Webhookova - ECDSA verifikacija potpisa za webhook opterećenja
• TLS šifriranje - Sva API komunikacija šifrirana putem HTTPS-a
• Upravljanje IP pristupom - Ograničite Dashboard i API pristup po IP-u
• Dvofaktorska autentifikacija - 2FA dostupna za pristup računu

Povezani resursi

• SendGrid API dokumentacija
• SendGrid vodič za Event Webhook
• Brevo Konektor
• Mailchimp Konektor
• Vještina sinkronizacije korisnika