---
title: "Brevo konnektor"
description: "Teljes Brevo integrációs útmutató kapcsolatok, tranzakciós e-mailek, SMS, WhatsApp kampányok és marketingautomatizálás szinkronizációjához a Tajóval."
url: https://tajo.io/hu/docs/connectors/marketing/brevo/
markdown: https://tajo.io/hu/docs/connectors/marketing/brevo.md
lang: hu-HU
robots: noindex
---

Kérj korai hozzáférést

Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét.

# Brevo konnektor

Konnektor állapota: Aktív Ellenőrizve. A Tajo ma már futtatja ezt a konnektort.

| Forrásmező | Célmező | Mintaérték |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Csatlakoztasd a Brevo fiókodat a Tajóhoz egységes kapcsolatkezeléshez, tranzakciós üzenetküldéshez e-mailen, SMS-en és WhatsAppon keresztül, valamint átfogó marketingautomatizáláshoz.

## Áttekintés

| Tulajdonság | Érték |
| --- | --- |
| **Platform** | Brevo |
| **Kategória** | Marketing |
| **Telepítés bonyolultsága** | Könnyű |
| **Hivatalos integráció** | Igen |
| **Szinkronizált adatok** | Kapcsolatok, Kampányok, Tranzakciós üzenetek, Események, E-kereskedelem |
| **API alap URL** | `https://api.brevo.com/v3` |

## Funkciók

- **Többcsatornás üzenetküldés** – Tranzakciós e-mail, SMS és WhatsApp küldése egységesített API-ból
- **Kapcsolatkezelés** – Kapcsolatok létrehozása, frissítése és szegmentálása egyéni attribútumokkal
- **Marketingkampányok** – E-mail kampányok programozott létrehozása és küldése
- **Esemény-követés** – Egyéni események és weboldalaktivitás követése a Brevo Trackeren keresztül
- **E-kereskedelmi szinkronizáció** – Termékek, rendelések és kosár-adatok szinkronizálása személyre szabott kampányokhoz
- **Hűségprogramok** – Hűség-előfizetések, pontok és tagadatok kezelése
- **Webhook-támogatás** – Valós idejű eseményértesítések tranzakciós, marketing és CRM eseményekhez
- **Conversations** – Élő csevegős widget integráció és programozott üzenetkezelés

## Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Brevo fiókkal (Ingyenes, Starter, Business vagy Enterprise csomag)
2. Egy API kulccsal a Brevo Beállítások > API kulcsok menüből
3. Egy Tajo fiókkal API-hozzáféréssel
4. Ellenőrzött küldő domainnel az e-mail küldéshez

## Hitelesítés

A Brevo két hitelesítési módszert támogat:

### API kulcs hitelesítés (Ajánlott)

Szerepeltesd az API kulcsot az `api-key` fejlécben minden kéréssel. Legjobb közvetlen integrációkhoz és szerver-szerver kommunikációhoz.

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

### OAuth 2.0 hitelesítés

OAuth 2.0-t használj olyan privát integrációkhoz szervezeten belül, amelyek delegált hozzáférést és felhasználóspecifikus jogosultságokat igényelnek. Az OAuth meghatározott érvényességi időszakokkal rendelkező token alapú rendszert biztosít.

OAuth elérhetőség

Az OAuth jelenleg csak szervezeten belüli privát integrációkhoz érhető el. Az OAuth integrációk nem nyilvános terjesztésre vagy marketplace listázásra készültek.

## Konfiguráció

### Alapbeállítás

```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
```

### Mezőleképezés

Képezd le az adatmezőidet Brevo kapcsolat-attribútumokhoz:

#### Default Mappings

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Contact email address (unique identifier) |
| `FIRSTNAME` optional | string | Contact first name attribute |
| `LASTNAME` optional | string | Contact last name attribute |
| `SMS` optional | string | Phone number for SMS and WhatsApp messaging |
| `OPT_IN` optional | boolean | Marketing opt-in consent status |
| `ORDER_COUNT` optional | integer | Total number of orders placed |
| `TOTAL_REVENUE` optional | number | Lifetime revenue from the contact |
| `LOYALTY_POINTS` optional | integer | Current loyalty program points balance |

#### Egyéni attribútum-leképezés

```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 végpontok

### Alap végpontok

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `POST` | `/v3/smtp/email` | Tranzakciós e-mail küldése |
| `POST` | `/v3/transactionalSMS/send` | Tranzakciós SMS küldése |
| `POST` | `/v3/whatsapp/sendMessage` | Tranzakciós WhatsApp küldése |
| `POST` | `/v3/contacts` | Kapcsolat létrehozása |
| `PUT` | `/v3/contacts/{email}` | Kapcsolat frissítése |
| `GET` | `/v3/contacts/{identifier}` | Kapcsolat részleteinek lekérése |
| `POST` | `/v3/contacts/import` | Kapcsolatok tömeges importálása |

### E-kereskedelmi végpontok

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `POST` | `/v3/orders/status` | Rendelési státusz létrehozása vagy frissítése |
| `POST` | `/v3/products` | Termékek létrehozása vagy frissítése |
| `POST` | `/v3/categories` | Termékkategóriák létrehozása vagy frissítése |
| `POST` | `/v3/events` | Egyéni események követése |

### Kampány-végpontok

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `POST` | `/v3/emailCampaigns` | E-mail kampány létrehozása |
| `POST` | `/v3/emailCampaigns/{id}/sendNow` | Kampány azonnali küldése |
| `GET` | `/v3/emailCampaigns` | Összes e-mail kampány listázása |
| `GET` | `/v3/smtp/statistics/events` | E-mail esemény statisztikák lekérése |

## Események

### Tranzakciós események

| Esemény | Kiváltó ok | Használati eset |
| --- | --- | --- |
| `delivered` | E-mail kézbesítve a postaládába | Kézbesítési megerősítés |
| `opened` | E-mailt megnyitotta a címzett | Elköteleződés-követés |
| `clicked` | Linkre kattintottak az e-mailben | Kattintás-követés |
| `bounced` | E-mail visszapattant | Lista-higiénia |
| `spam` | Spamként jelölték | Megfelelőségi figyelés |
| `unsubscribed` | Kapcsolat leiratkozott | Preferencia-kezelés |

### E-kereskedelmi események

| Esemény | Kiváltó ok | Használati eset |
| --- | --- | --- |
| `order_completed` | Rendelés sikeresen leadva | Vásárlás utáni munkafolyamatok |
| `cart_updated` | Kosár tartalma megváltozott | Elhagyott kosár követés |
| `cart_deleted` | Kosár törölve vagy lejárt | Kosár-visszaállítás |
| `product_viewed` | Termékoldal meglátogatva | Böngészés-elhagyás |

## Kódpéldák

### A konnektor inicializálása

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

### Tranzakciós e-mail küldése

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

### Kapcsolatok szinkronizálása

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

### Egyéni események követése

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

## Ráta-korlátok

A Brevo három szintű ráta-korlátokat alkalmaz a csomagtól függően:

| Végpont | Ingyenes/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 |
| Összes többi végpont | 100 RPH | 200 RPH | 600 RPH |

Ráta-korlát válasz

Ha túlléped a ráta-korlátot, az API `429 Too Many Requests` státuszkódot ad vissza. Figyeld a ráta-korlát fejléceket a válaszokban a használatod nyomon követéséhez.

## Hibaelhárítás

### Gyakori problémák

| Probléma | Ok | Megoldás |
| --- | --- | --- |
| 401 Unauthorized | Érvénytelen API kulcs | Generáld újra az API kulcsot a Brevo Beállításokban |
| Kapcsolat nem jött létre | Hiányzó e-mail mező | Győződj meg róla, hogy minden kapcsolathoz e-mail meg van adva |
| E-mail nem kézbesítve | Nem ellenőrzött küldő domain | Ellenőrizd a domaint a Brevo Küldők beállításaiban |
| Webhook nem érkezett | Helytelen URL vagy szerverhiba | Ellenőrizd a webhook URL elérhetőségét és naplókat |
| SMS nem küldve | Érvénytelen telefonszám-formátum | Használj nemzetközi formátumot országhívószámmal |

### Hibakeresési mód

Engedélyezd a részletes naplózást:

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

### Kapcsolat tesztelése

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

## Legjobb gyakorlatok

1. **Használj API kulcs rotációt** – Forgasd rendszeresen az API kulcsokat a biztonságért
2. **Implementálj webhook-ellenőrzést** – Validáld a webhook aláírásokat felhasználónév/jelszó hitelesítéssel
3. **Kötegelj kapcsolat-importálásokat** – Használj tömeges importálást nagy adatkészletekhez az egyedi API hívások helyett
4. **Figyeld a ráta-korlátokat** – Ellenőrizd a ráta-korlát fejléceket a 429 hibák elkerüléséhez
5. **Használj esemény-követést** – Implementálj Brevo Trackert az átfogó ügyfél-viselkedési adatokhoz
6. **Állíts be megfelelő küldő hitelesítést** – Konfiguráld az SPF, DKIM és DMARC beállításokat az optimális kézbesíthetőségért

## Biztonság

- **API kulcs hitelesítés** – Titkos token alapú hozzáférés `api-key` fejléccen keresztül
- **OAuth 2.0** – Token alapú delegált hozzáférés privát integrációkhoz
- **Webhook-ellenőrzés** – Felhasználónév és jelszó hitelesítés biztonságos webhook hívásokhoz
- **TLS titkosítás** – Minden API kommunikáció titkosítva van az átvitel során
- **IP engedélyezési lista** – Opcionális IP korlátozások Enterprise csomagokon

## Kapcsolódó források

- [Brevo API dokumentáció](https://developers.brevo.com/docs/getting-started)
- [Brevo hitelesítési útmutató](https://developers.brevo.com/docs/authentication-schemes)
- [Brevo ráta-korlátok](https://developers.brevo.com/docs/api-limits)
- [Shopify konnektor](https://tajo.io/hu/docs/connectors/ecommerce/shopify)
- [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/hu/docs/contact-management)