SendGrid कनेक्टर

ईमेल इन्फ्रास्ट्रक्चर माइग्रेशन, कॉन्टैक्ट सिंक्रनाइज़ेशन, कैंपेन डेटा स्थानांतरण, और दोनों प्लेटफ़ॉर्म्स में एकीकृत एंगेजमेंट एनालिटिक्स के लिए अपने SendGrid खाते को Tajo के माध्यम से Brevo से कनेक्ट करें।

अवलोकन

विशेषताएं

• कॉन्टैक्ट माइग्रेशन - कस्टम फ़ील्ड्स के साथ SendGrid Marketing कॉन्टैक्ट्स को Brevo में माइग्रेट करें
• Transactional ईमेल सिंक - एकीकृत रिपोर्टिंग के लिए transactional ईमेल इवेंट्स ट्रैक करें
• कैंपेन डेटा - Single Send और Automation कैंपेन प्रदर्शन डेटा सिंक करें
• Event webhooks - ईमेल इवेंट्स (delivered, opened, clicked, bounced) को Brevo में फ़ॉरवर्ड करें
• Suppression सिंक - अनुपालन के लिए bounce, block, और unsubscribe lists माइग्रेट करें
• Template माइग्रेशन - Brevo उपयोग के लिए Dynamic Transactional Templates निर्यात करें
• Sender सत्यापन - सत्यापित sender identities और domain प्रमाणीकरण सिंक करें
• आंकड़े सिंक - 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 - Granular अनुमति नियंत्रण
• Billing Access - केवल-billing operations

आवश्यक अनुमतियां

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 कॉन्टैक्ट्स

Transactional ईमेल (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. batch contact uploads का उपयोग करें - दक्षता के लिए प्रति अनुरोध 30,000 तक कॉन्टैक्ट्स PUT करें
3. Event Webhook सत्यापित करें - ECDSA सत्यापन के साथ हस्ताक्षरित webhooks सक्षम करें
4. कस्टम फ़ील्ड्स मैप करें - कॉन्टैक्ट माइग्रेशन से पहले संबंधित Brevo एट्रिब्यूट्स बनाएं
5. एंगेजमेंट डेटा सिंक करें - Brevo में सेगमेंटेशन के लिए ऐतिहासिक आंकड़े आयात करें
6. async exports हैंडल करें - Contact exports asynchronous हैं; completion के लिए poll करें

सुरक्षा

• API Key प्रमाणीकरण - granular अनुमति स्तरों के साथ Bearer token
• Event Webhook signing - webhook payloads के लिए ECDSA सिग्नेचर सत्यापन
• TLS एन्क्रिप्शन - सभी API संचार HTTPS के माध्यम से एन्क्रिप्टेड
• IP Access Management - IP द्वारा Dashboard और API एक्सेस को प्रतिबंधित करें
• Two-factor प्रमाणीकरण - खाता एक्सेस के लिए 2FA उपलब्ध

संबंधित संसाधन

• SendGrid API Documentation
• SendGrid Event Webhook Guide
• Brevo Connector
• Mailchimp Connector
• Customer Sync Skill