Brevo कनेक्टर

Brevo कनेक्टर

एकीकृत कॉन्टैक्ट प्रबंधन, ईमेल, SMS, और WhatsApp में ट्रांज़ैक्शनल मैसेजिंग, और व्यापक मार्केटिंग ऑटोमेशन के लिए अपने Brevo खाते को Tajo से कनेक्ट करें।

अवलोकन

विशेषताएं

• मल्टी-चैनल मैसेजिंग - एक एकीकृत API से ट्रांज़ैक्शनल ईमेल, SMS, और WhatsApp भेजें
• कॉन्टैक्ट प्रबंधन - कस्टम एट्रिब्यूट्स के साथ कॉन्टैक्ट्स बनाएं, अपडेट करें, और सेगमेंट करें
• मार्केटिंग कैंपेन - प्रोग्रामेटिक रूप से ईमेल कैंपेन बनाएं और भेजें
• इवेंट ट्रैकिंग - Brevo Tracker के माध्यम से कस्टम इवेंट्स और वेबसाइट गतिविधि ट्रैक करें
• eCommerce सिंक - व्यक्तिगत कैंपेन के लिए उत्पाद, ऑर्डर, और कार्ट डेटा सिंक करें
• लॉयल्टी प्रोग्राम - लॉयल्टी सब्सक्रिप्शन, पॉइंट्स, और सदस्य डेटा प्रबंधित करें
• Webhook समर्थन - ट्रांज़ैक्शनल, मार्केटिंग, और CRM इवेंट्स के लिए रीयल-टाइम इवेंट सूचनाएं
• Conversations - लाइव चैट विजेट इंटीग्रेशन और प्रोग्रामेटिक संदेश प्रबंधन

पूर्वावश्यकताएं

शुरू करने से पहले, सुनिश्चित करें कि आपके पास है:

1. एक Brevo खाता (Free, Starter, Business, या Enterprise प्लान)
2. Brevo Settings > API Keys से जनरेट की गई एक API key
3. API एक्सेस वाला एक Tajo खाता
4. ईमेल भेजने के लिए सत्यापित sender domain

प्रमाणीकरण

Brevo दो प्रमाणीकरण विधियों का समर्थन करता है:

API Key प्रमाणीकरण (अनुशंसित)

प्रत्येक अनुरोध के साथ api-key हेडर में अपनी API key शामिल करें। प्रत्यक्ष इंटीग्रेशन्स और सर्वर-टू-सर्वर संचार के लिए सर्वोत्तम।

curl -X GET "https://api.brevo.com/v3/account" \
  -H "api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

OAuth 2.0 प्रमाणीकरण

OAuth 2.0 का उपयोग किसी संगठन के भीतर निजी इंटीग्रेशन्स के लिए करें जिन्हें delegated access और उपयोगकर्ता-विशिष्ट अनुमतियों की आवश्यकता होती है। OAuth परिभाषित वैधता अवधि के साथ टोकन-आधारित सिस्टम प्रदान करता है।

कॉन्फ़िगरेशन

बुनियादी सेटअप

connectors:
  brevo:
    enabled: true
    api_key: "${BREVO_API_KEY}"
    api_version: "v3"

    # Data sync options
    sync:
      contacts: true
      campaigns: true
      transactional: true
      events: true
      ecommerce: true

    # List assignment
    lists:
      all_customers: 5
      newsletter: 6
      buyers: 7

फ़ील्ड मैपिंग

अपने डेटा फ़ील्ड्स को Brevo कॉन्टैक्ट एट्रिब्यूट्स में मैप करें:

कस्टम एट्रिब्यूट मैपिंग

field_mapping:
  # Standard fields
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Marketing fields
  opt_in: OPT_IN
  signup_source: SIGNUP_SOURCE
  preferred_language: LANGUAGE

  # eCommerce metrics
  orders_count: ORDER_COUNT
  total_spent: TOTAL_REVENUE
  last_order_date: LAST_ORDER_DATE

  # Loyalty fields
  loyalty_tier: VIP_TIER
  loyalty_points: LOYALTY_POINTS

API एंडपॉइंट्स

मुख्य एंडपॉइंट्स

eCommerce एंडपॉइंट्स

कैंपेन एंडपॉइंट्स

इवेंट्स

ट्रांज़ैक्शनल इवेंट्स

eCommerce इवेंट्स

कोड उदाहरण

कनेक्टर प्रारंभ करें

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

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

// Connect Brevo account
await tajo.connectors.connect('brevo', {
  apiKey: process.env.BREVO_API_KEY
});

ट्रांज़ैक्शनल ईमेल भेजें

// Send a transactional email via Brevo
await tajo.brevo.sendTransactionalEmail({
  to: [{ email: '[email protected]', name: 'John Doe' }],
  templateId: 12,
  params: {
    ORDER_ID: '12345',
    ORDER_TOTAL: '$59.99',
    DELIVERY_DATE: '2024-02-15'
  }
});

कॉन्टैक्ट्स सिंक करें

// Bulk import contacts to Brevo
await tajo.connectors.sync('brevo', {
  type: 'full',
  resources: ['contacts'],
  options: {
    listIds: [5, 6],
    updateExisting: true,
    emptyContactsAttributes: false
  }
});

// Check sync status
const status = await tajo.connectors.status('brevo');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsSynced: 25400,
//   campaignsSent: 142,
//   eventsTracked: 89320
// }

कस्टम इवेंट्स ट्रैक करें

// Track a custom event for a contact
await tajo.brevo.trackEvent({
  email: '[email protected]',
  event: 'product_purchased',
  eventdata: {
    id: 'txn_98765',
    data: {
      product_name: 'Premium Widget',
      price: 49.99,
      currency: 'USD'
    }
  }
});

दर सीमाएं

Brevo आपके प्लान के आधार पर तीन स्तरों में दर सीमाएं लागू करता है:

समस्या निवारण

सामान्य समस्याएं

डीबग मोड

विस्तृत लॉगिंग सक्षम करें:

connectors:
  brevo:
    debug: true
    log_level: verbose
    log_webhooks: true

कनेक्शन परीक्षण करें

tajo connectors test brevo
# ✓ API connection successful
# ✓ Contacts API accessible
# ✓ Transactional email ready
# ✓ SMS sending configured
# ✓ Webhooks registered

सर्वोत्तम प्रथाएं

1. API key रोटेशन का उपयोग करें - सुरक्षा के लिए समय-समय पर API keys रोटेट करें
2. Webhook सत्यापन लागू करें - username/password प्रमाणीकरण के साथ webhook सिग्नेचर सत्यापित करें
3. कॉन्टैक्ट आयात बैच करें - व्यक्तिगत API कॉल्स के बजाय बड़े डेटासेट के लिए bulk import का उपयोग करें
4. दर सीमाओं की निगरानी करें - 429 त्रुटियों से बचने के लिए दर सीमा हेडर्स जांचें
5. इवेंट ट्रैकिंग का उपयोग करें - व्यापक ग्राहक व्यवहार डेटा के लिए Brevo Tracker लागू करें
6. उचित sender प्रमाणीकरण सेट करें - इष्टतम डिलीवरबिलिटी के लिए SPF, DKIM, और DMARC कॉन्फ़िगर करें

सुरक्षा

• API Key प्रमाणीकरण - api-key हेडर के माध्यम से Secret token-आधारित एक्सेस
• OAuth 2.0 - निजी इंटीग्रेशन्स के लिए Token-आधारित delegated एक्सेस
• Webhook सत्यापन - सुरक्षित webhook कॉल्स के लिए username और password प्रमाणीकरण
• TLS एन्क्रिप्शन - ट्रांजिट में सभी API संचार एन्क्रिप्टेड
• IP whitelisting - Enterprise प्लान्स पर वैकल्पिक IP प्रतिबंध उपलब्ध

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

• Brevo API Documentation
• Brevo Authentication Guide
• Brevo Rate Limits
• Shopify Connector
• Customer Sync Skill
• Brevo Contacts API