Brevo کنیکٹر

Brevo کنیکٹر

متحدہ رابطہ انتظام، ای میل، SMS، اور WhatsApp پر ٹرانزیکشنل پیغام رسانی، اور جامع مارکیٹنگ آٹومیشن کے لیے اپنے Brevo اکاؤنٹ کو Tajo سے منسلک کریں۔

جائزہ

خصوصیات

• ملٹی چینل پیغام رسانی - ایک متحدہ API سے ٹرانزیکشنل ای میل، SMS، اور WhatsApp بھیجیں
• رابطہ انتظام - کسٹم خصوصیات کے ساتھ رابطے بنائیں، اپ ڈیٹ کریں، اور سیگمنٹ کریں
• مارکیٹنگ مہمات - پروگرامی طور پر ای میل مہمات بنائیں اور بھیجیں
• ایونٹ ٹریکنگ - Brevo Tracker کے ذریعے کسٹم ایونٹس اور ویب سائٹ سرگرمی ٹریک کریں
• ای کامرس سنک - ذاتی نوعیت کی مہمات کے لیے پروڈکٹس، آرڈرز، اور کارٹ ڈیٹا سنک کریں
• وفاداری پروگرامز - وفاداری سبسکرپشنز، پوائنٹس، اور ممبر ڈیٹا کا انتظام کریں
• Webhook سپورٹ - ٹرانزیکشنل، مارکیٹنگ، اور CRM ایونٹس کے لیے ریئل ٹائم ایونٹ نوٹیفکیشنز
• گفتگو - لائیو چیٹ widget انٹیگریشن اور پروگرامی پیغام انتظام

شرائط

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

1. Brevo اکاؤنٹ (Free, Starter, Business, یا Enterprise plan)
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 اینڈ پوائنٹس

بنیادی اینڈ پوائنٹس

ای کامرس اینڈ پوائنٹس

مہم اینڈ پوائنٹس

ایونٹس

ٹرانزیکشنل ایونٹس

ای کامرس ایونٹس

کوڈ کی مثالیں

کنیکٹر کو انیشیلائز کریں

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 کالز کے بجائے بڑے ڈیٹا سیٹس کے لیے بلک امپورٹ استعمال کریں
4. شرح کی حدود کی نگرانی کریں - 429 غلطیوں سے بچنے کے لیے شرح کی حد ہیڈرز چیک کریں
5. ایونٹ ٹریکنگ استعمال کریں - جامع گاہک رویاتی ڈیٹا کے لیے Brevo Tracker نافذ کریں
6. مناسب sender تصدیق سیٹ اپ کریں - بہترین deliverability کے لیے SPF, DKIM, اور DMARC ترتیب دیں

سیکیورٹی

• API Key تصدیق - api-key ہیڈر کے ذریعے secret token پر مبنی رسائی
• OAuth 2.0 - پرائیویٹ انٹیگریشنز کے لیے ٹوکن پر مبنی delegated access
• Webhook توثیق - محفوظ webhook کالز کے لیے username اور password تصدیق
• TLS انکرپشن - تمام API مواصلات ٹرانزٹ میں انکرپٹڈ
• IP وائٹ لسٹنگ - Enterprise plans پر اختیاری IP پابندیاں دستیاب

متعلقہ وسائل

• Brevo API دستاویزات
• Brevo تصدیق گائیڈ
• Brevo شرح کی حدود
• Shopify کنیکٹر
• گاہک سنک اسکل
• Brevo Contacts API