---
title: "Brevo کنیکٹر"
description: "Tajo کے ساتھ رابطوں، ٹرانزیکشنل ای میلز، SMS، WhatsApp مہمات، اور مارکیٹنگ آٹومیشن کو سنک کرنے کے لیے مکمل Brevo انٹیگریشن گائیڈ۔"
url: https://tajo.io/ur/docs/connectors/marketing/brevo/
markdown: https://tajo.io/ur/docs/connectors/marketing/brevo.md
lang: ur-PK
robots: noindex
---

ابتدائی رسائی کی درخواست کریں

اپنا پہلا نام اور دفتری ای میل پتہ درج کریں۔ ہم Tajo تک رسائی کی درخواست کی تصدیق کے لیے ایک لنک ای میل کریں گے۔

# Brevo کنیکٹر

کنیکٹر کی حیثیت: فعال تصدیق شدہ۔ Tajo آج یہ کنیکٹر چلاتا ہے۔

| ماخذ فیلڈ | منزل فیلڈ | نمونہ قدر |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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

## جائزہ

| خاصیت | قدر |
| --- | --- |
| **پلیٹ فارم** | Brevo |
| **زمرہ** | مارکیٹنگ |
| **سیٹ اپ کی پیچیدگی** | آسان |
| **آفیشل انٹیگریشن** | ہاں |
| **سنک شدہ ڈیٹا** | رابطے، مہمات، ٹرانزیکشنل پیغامات، ایونٹس، ای کامرس |
| **API بنیادی URL** | `https://api.brevo.com/v3` |

## خصوصیات

- **ملٹی چینل پیغام رسانی** - ایک متحدہ 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 شامل کریں۔ براہ راست انٹیگریشنز اور سرور سے سرور مواصلات کے لیے بہترین۔

```bash
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 متعین درستگی کی مدت کے ساتھ ٹوکن پر مبنی نظام فراہم کرتا ہے۔

OAuth دستیابی

OAuth فی الحال صرف ایک تنظیم کے اندر پرائیویٹ انٹیگریشنز کے لیے دستیاب ہے۔ OAuth انٹیگریشنز عوامی تقسیم یا مارکیٹ پلیس فہرست بندی کے لیے نہیں ہیں۔

## تشکیل

### بنیادی سیٹ اپ

```yaml
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 رابطہ خصوصیات پر میپ کریں:

#### طے شدہ میپنگز

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | رابطہ ای میل پتہ (منفرد شناخت کنندہ) |
| `FIRSTNAME` optional | string | رابطہ پہلا نام خصوصیت |
| `LASTNAME` optional | string | رابطہ آخری نام خصوصیت |
| `SMS` optional | string | SMS اور WhatsApp پیغام رسانی کے لیے فون نمبر |
| `OPT_IN` optional | boolean | مارکیٹنگ opt-in رضامندی کی حیثیت |
| `ORDER_COUNT` optional | integer | کیے گئے آرڈرز کی کل تعداد |
| `TOTAL_REVENUE` optional | number | رابطہ سے تاحیات آمدنی |
| `LOYALTY_POINTS` optional | integer | موجودہ وفاداری پروگرام پوائنٹس بیلنس |

#### کسٹم خصوصیت میپنگ

```yaml
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 اینڈ پوائنٹس

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

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `POST` | `/v3/smtp/email` | ٹرانزیکشنل ای میل بھیجیں |
| `POST` | `/v3/transactionalSMS/send` | ٹرانزیکشنل SMS بھیجیں |
| `POST` | `/v3/whatsapp/sendMessage` | ٹرانزیکشنل WhatsApp بھیجیں |
| `POST` | `/v3/contacts` | رابطہ بنائیں |
| `PUT` | `/v3/contacts/{email}` | رابطہ اپ ڈیٹ کریں |
| `GET` | `/v3/contacts/{identifier}` | رابطہ کی تفصیلات حاصل کریں |
| `POST` | `/v3/contacts/import` | رابطوں کا بلک امپورٹ |

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

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `POST` | `/v3/orders/status` | آرڈر اسٹیٹس بنائیں یا اپ ڈیٹ کریں |
| `POST` | `/v3/products` | پروڈکٹس بنائیں یا اپ ڈیٹ کریں |
| `POST` | `/v3/categories` | پروڈکٹ زمرے بنائیں یا اپ ڈیٹ کریں |
| `POST` | `/v3/events` | کسٹم ایونٹس ٹریک کریں |

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

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `POST` | `/v3/emailCampaigns` | ای میل مہم بنائیں |
| `POST` | `/v3/emailCampaigns/{id}/sendNow` | فوری طور پر مہم بھیجیں |
| `GET` | `/v3/emailCampaigns` | تمام ای میل مہمات کی فہرست |
| `GET` | `/v3/smtp/statistics/events` | ای میل ایونٹ کے اعدادوشمار حاصل کریں |

## ایونٹس

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

| ایونٹ | ٹرگر | استعمال کا کیس |
| --- | --- | --- |
| `delivered` | ای میل inbox میں ڈیلیور ہوئی | ڈیلیوری تصدیق |
| `opened` | وصول کنندہ نے ای میل کھولی | Engagement ٹریکنگ |
| `clicked` | ای میل میں لنک پر کلک | Click-through ٹریکنگ |
| `bounced` | ای میل bounce ہوئی | فہرست hygiene |
| `spam` | spam کے طور پر نشان زد | کمپلائنس مانیٹرنگ |
| `unsubscribed` | رابطہ نے ان سبسکرائب کیا | ترجیح کا انتظام |

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

| ایونٹ | ٹرگر | استعمال کا کیس |
| --- | --- | --- |
| `order_completed` | آرڈر کامیابی سے دیا گیا | خریداری کے بعد فلوز |
| `cart_updated` | کارٹ مواد تبدیل ہوا | چھوڑے گئے کارٹ ٹریکنگ |
| `cart_deleted` | کارٹ صاف یا میعاد ختم | کارٹ ریکوری |
| `product_viewed` | پروڈکٹ پیج دیکھا گیا | Browse abandonment |

## کوڈ کی مثالیں

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

```javascript
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
});
```

### ٹرانزیکشنل ای میل بھیجیں

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

### رابطے سنک کریں

```javascript
// 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
// }
```

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

```javascript
// Track a custom event for a contact
await tajo.brevo.trackEvent({
  email: 'customer@example.com',
  event: 'product_purchased',
  eventdata: {
    id: 'txn_98765',
    data: {
      product_name: 'Premium Widget',
      price: 49.99,
      currency: 'USD'
    }
  }
});
```

## شرح کی حدود

Brevo آپ کے پلان کی بنیاد پر تین درجات میں شرح کی حدود نافذ کرتا ہے:

| اینڈ پوائنٹ | Free/Starter | Professional | Enterprise |
| --- | --- | --- | --- |
| `POST /v3/smtp/email` | 1,000 RPS | 2,000 RPS | 6,000 RPS |
| `POST /v3/transactionalSMS/send` | 150 RPS | 200 RPS | 250 RPS |
| `POST /v3/events` | 10 RPS | 20 RPS | 60 RPS |
| `/v3/contacts/*` | 10 RPS | 20 RPS | 60 RPS |
| دیگر تمام اینڈ پوائنٹس | 100 RPH | 200 RPH | 600 RPH |

شرح کی حد جواب

جب آپ شرح کی حد سے تجاوز کرتے ہیں، API `429 Too Many Requests` اسٹیٹس کوڈ واپس کرتا ہے۔ اپنے استعمال کو ٹریک کرنے کے لیے جوابات میں شرح کی حد ہیڈرز کی نگرانی کریں۔

## ٹربل شوٹنگ

### عام مسائل

| مسئلہ | وجہ | حل |
| --- | --- | --- |
| 401 Unauthorized | غلط API key | Brevo Settings میں API key دوبارہ بنائیں |
| رابطہ نہیں بنایا گیا | غائب ای میل فیلڈ | یقینی بنائیں کہ تمام رابطوں کے لیے ای میل فراہم کیا گیا ہے |
| ای میل ڈیلیور نہیں ہوئی | غیر تصدیق شدہ sender domain | Brevo Senders settings میں domain کی تصدیق کریں |
| Webhook موصول نہیں ہوا | غلط URL یا سرور کی غلطی | Webhook URL رسائی اور لاگز چیک کریں |
| SMS نہیں بھیجی گئی | غلط فون فارمیٹ | کنٹری کوڈ کے ساتھ بین الاقوامی فارمیٹ استعمال کریں |

### ڈیبگ موڈ

تفصیلی لاگنگ فعال کریں:

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

### کنکشن ٹیسٹ کریں

```bash
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 دستاویزات](https://developers.brevo.com/docs/getting-started)
- [Brevo تصدیق گائیڈ](https://developers.brevo.com/docs/authentication-schemes)
- [Brevo شرح کی حدود](https://developers.brevo.com/docs/api-limits)
- [Shopify کنیکٹر](https://tajo.io/ur/docs/connectors/ecommerce/shopify)
- [گاہک سنک اسکل](https://tajo.io/ur/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/ur/docs/contact-management)