Konektor SendGrid

Propojte svůj účet SendGrid s Brevo přes Tajo pro migraci e-mailové infrastruktury, synchronizaci kontaktů, přenos dat kampaní a sjednocenou analytiku zapojení napříč oběma platformami.

Přehled

Funkce

• Migrace kontaktů – Migrujte marketingové kontakty SendGrid do Brevo s vlastními poli
• Synchronizace transakčních e-mailů – Sledujte události transakčních e-mailů pro sjednocené reportování
• Data kampaní – Synchronizujte data výkonu kampaní Single Send a Automation
• Webhooky událostí – Přeposílejte e-mailové události (doručené, otevřené, kliknuté, odražené) do Brevo
• Synchronizace potlačení – Migrujte seznamy odrazů, blokování a odhlášení pro soulad
• Migrace šablon – Exportujte dynamické transakční šablony pro použití v Brevo
• Ověřování odesílatele – Synchronizujte ověřené identity odesílatele a ověřování domén
• Synchronizace statistik – Importujte historické statistiky zapojení do atributů Brevo

Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet SendGrid (Free, Essentials, Pro nebo Premier)
2. API klíč SendGrid s požadovanými oprávněními
3. Účet Brevo s přístupem k API
4. Účet Tajo

Ověření

Ověření API klíčem

SendGrid používá ověřování bearer tokenem.

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

Vytvářejte API klíče v SendGrid Nastavení > API Keys s konkrétními úrovněmi oprávnění:

• Plný přístup – Kompletní přístup k API
• Omezený přístup – Granulární řízení oprávnění
• Přístup k fakturaci – Pouze fakturační operace

Požadovaná oprávnění

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

Konfigurace

Základní nastavení

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

    # Možnosti synchronizace dat
    sync:
      contacts: true
      campaigns: true
      transactional: true
      suppressions: true
      statistics: true

    # Mapování seznamů na Brevo
    list_mapping:
      "All Contacts": 60
      "Newsletter": 61
      "Transactional": 62

Mapování polí

Mapujte pole kontaktů SendGrid na atributy kontaktů Brevo:

Mapování vlastních polí

field_mapping:
  # Standardní pole
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone_number: SMS

  # Pole polohy
  city: CITY
  state_province_region: STATE
  country: COUNTRY
  postal_code: POSTAL_CODE

  # Metriky zapojení
  avg_open_rate: AVG_OPEN_RATE
  avg_click_rate: AVG_CLICK_RATE

  # Vlastní pole
  custom_fields.company: COMPANY_NAME
  custom_fields.plan: PLAN_TYPE

Koncové body API

Marketingové kontakty

Transakční e-mail (Mail Send)

Kampaně (Single Sends)

Statistiky

Potlačení

Události

E-mailové události (přes Event Webhook)

Příklady kódu

Inicializace konektoru

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

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

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

Migrace kontaktů do Brevo

// Úplná migrace kontaktů ze SendGrid do Brevo
await tajo.connectors.sync('sendgrid', {
  type: 'full',
  resources: ['contacts', 'suppressions'],
  options: {
    includeCustomFields: true,
    migrateListMemberships: true,
    migrateSuppressions: true
  }
});

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

Přeposílání e-mailových událostí

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

  // Ověření podpisu webhooku (ECDSA)
  if (!verifySendGridSignature(req.body, signature)) {
    return res.status(401).send('Unauthorized');
  }

  // Zpracování dávky událostí
  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');
});

Omezení rychlosti

Limity rychlosti SendGrid API:

Řešení problémů

Časté problémy

Režim ladění

Povolte podrobné protokolování:

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

Test připojení

tajo connectors test sendgrid
# ✓ Připojení API úspěšné
# ✓ Kontakty čitelné
# ✓ Seznamy přístupné
# ✓ Statistiky čitelné
# ✓ Potlačení přístupná

Osvědčené postupy

1. Nejprve migrujte potlačení – Ujistěte se, že odrazy, blokování a odhlášení jsou v Brevo před odesíláním
2. Používejte dávkové nahrávání kontaktů – PUT až 30 000 kontaktů na požadavek pro efektivitu
3. Ověřte Event Webhook – Povolte podepsané webhooky s ověřením ECDSA
4. Mapujte vlastní pole – Vytvořte odpovídající atributy Brevo před migrací kontaktů
5. Synchronizujte data o zapojení – Importujte historické statistiky pro segmentaci v Brevo
6. Zpracovávejte asynchronní exporty – Exporty kontaktů jsou asynchronní; pollujte pro dokončení

Zabezpečení

• Ověřování API klíčem – Bearer token s granulárními úrovněmi oprávnění
• Podepisování Event Webhooku – Ověření podpisu ECDSA pro payloady webhooků
• Šifrování TLS – Veškerá API komunikace šifrovaná přes HTTPS
• Správa přístupu IP – Omezení přístupu k Dashboard a API podle IP
• Dvoufaktorové ověřování – 2FA dostupné pro přístup k účtu

Související zdroje

• Dokumentace SendGrid API
• Průvodce Event Webhookem SendGrid
• Konektor Brevo
• Konektor Mailchimp
• Dovednost synchronizace zákazníků