---
title: "Klaviyo konektor"
description: "Kompletný sprievodca integráciou Klaviyo na synchronizáciu profilov, udalostí, zoznamov, segmentov a dát kampaní s Brevo cez Tajo."
url: https://tajo.io/sk/docs/connectors/marketing/klaviyo/
markdown: https://tajo.io/sk/docs/connectors/marketing/klaviyo.md
lang: sk-SK
robots: noindex
---

Požiadajte o skorý prístup

Zadajte svoje meno a pracovnú e-mailovú adresu. Pošleme vám odkaz na potvrdenie žiadosti o prístup k Tajo.

# Klaviyo konektor

Stav konektora: Vo vývoji Vzniká. Zatiaľ neoverené.

| Zdrojové pole | Cieľové pole | Ukážková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Prepoj Klaviyo s Brevo cez Tajo na migráciu alebo synchronizáciu marketingových dát medzi platformami. Synchronizuj profily, udalosti, zoznamy, segmenty, flows a dáta kampaní pre zjednotenú multikanálovú marketingovú stratégiu.

## Prehľad

| Vlastnosť | Hodnota |
| --- | --- |
| **Platforma** | Klaviyo |
| **Kategória** | Marketing |
| **Zložitosť nastavenia** | Stredná |
| **Oficiálna integrácia** | Nie |
| **Synchronizované dáta** | Profily, Udalosti, Zoznamy, Segmenty, Kampane |
| **Dostupné skilly** | 10 |
| **Štandard API** | JSON:API |

## Funkcie

- **Synchronizácia profilov** - Obojsmerná synchronizácia profilov zákazníkov medzi Klaviyo a Brevo
- **Preposielanie udalostí** - Preposielaj sledované udalosti Klaviyo do Brevo pre triggery automatizácie
- **Migrácia zoznamov** - Synchronizuj zoznamy Klaviyo do zoznamov kontaktov Brevo
- **Synchronizácia segmentov** - Exportuj segmenty Klaviyo ako zoznamy alebo segmenty Brevo
- **Export dát flows** - Sťahuj dáta výkonu flow pre analytiku naprieč platformami
- **Synchronizácia kampaní** - Koordinuj kampane naprieč kanálmi Klaviyo a Brevo
- **Synchronizácia katalógu** - Zrkadli katalógy produktov medzi platformami
- **Správa kupónov** - Synchronizuj kupónové kódy a dáta o využití

## Predpoklady

Predtým, než začneš, uisti sa, že máš:

1. Klaviyo účet s API prístupom
2. Súkromný API kľúč s príslušnými scopmi
3. Tvoj verejný API kľúč Klaviyo (6-znakové ID spoločnosti)
4. Brevo účet s API prístupom
5. Tajo účet s API prihlasovacími údajmi

## Autentifikácia

### Súkromný API kľúč

Klaviyo používa súkromné API kľúče so scoped prístupom pre serverovú autentifikáciu. Nastav kľúč v hlavičke `Authorization`:

```bash
curl https://a.klaviyo.com/api/profiles/ \
  -H "Authorization: Klaviyo-API-Key your-private-api-key" \
  -H "revision: 2026-01-15"
```

### Scopy API kľúča

Nakonfiguruj scopy pri vytváraní súkromného kľúča:

| Scope | Prístup | Popis |
| --- | --- | --- |
| `profiles` | Read/Full | Prístup k profilom kontaktov |
| `events` | Read/Full | Prístup k sledovaným udalostiam |
| `lists` | Read/Full | Prístup k zoznamom kontaktov |
| `segments` | Read | Prístup k segmentom |
| `campaigns` | Read | Prístup k dátam kampaní |
| `metrics` | Read | Prístup k definíciám metrík |
| `flows` | Read | Prístup ku konfiguráciám flows |
| `catalogs` | Read | Prístup ku katalógom produktov |

### Verejný API kľúč

Pre sledovanie na strane klienta použi 6-znakové ID spoločnosti:

```bash
curl -X POST "https://a.klaviyo.com/client/events/?company_id=COMPANY_ID" \
  -H "Content-Type: application/json" \
  -d '{"data": {...}}'
```

### OAuth (Partnerské integrácie)

Klaviyo podporuje OAuth pre technologických partnerov, ponúkajúc vylepšenú bezpečnosť a limity rýchlosti:

```bash
curl https://a.klaviyo.com/api/profiles/ \
  -H "Authorization: Bearer YOUR_OAUTH_TOKEN" \
  -H "revision: 2026-01-15"
```

## Konfigurácia

### Základné nastavenie

```yaml
connectors:
  klaviyo:
    enabled: true
    private_api_key: "your-klaviyo-private-key"
    public_api_key: "XXXXXX"
    api_revision: "2026-01-15"

    # Data sync options
    sync:
      profiles: true
      events: true
      lists: true
      segments: true
      catalogs: false

    # Brevo list assignment
    lists:
      all_contacts: 20
      subscribers: 21
      high_value: 22
```

### Mapovanie profilov

Namapuj vlastnosti profilov Klaviyo na atribúty kontaktov Brevo:

```yaml
profile_mapping:
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone_number: SMS
  city: CITY
  region: REGION
  country: COUNTRY
  zip: ZIP
  organization: COMPANY
  title: JOB_TITLE

  # Custom properties
  lifetime_value: LTV
  total_orders: ORDER_COUNT
  last_order_date: LAST_ORDER_DATE
  preferred_channel: CHANNEL_PREF
```

### Mapovanie udalostí

Namapuj metriky Klaviyo na udalosti Brevo:

```yaml
event_mapping:
  "Placed Order": "order_completed"
  "Ordered Product": "product_purchased"
  "Started Checkout": "checkout_started"
  "Added to Cart": "cart_updated"
  "Viewed Product": "product_viewed"
  "Subscribed to List": "customer_subscribed"
  "Received Email": "email_received"
  "Opened Email": "email_opened"
  "Clicked Email": "email_clicked"
```

## API endpointy

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `GET` | `/api/profiles/` | Zoznam profilov |
| `POST` | `/api/profiles/` | Vytvorenie profilu |
| `PATCH` | `/api/profiles/{id}/` | Aktualizácia profilu |
| `POST` | `/api/profile-merge/` | Zlúčenie duplicitných profilov |
| `GET` | `/api/events/` | Zoznam udalostí |
| `POST` | `/api/events/` | Vytvorenie udalosti |
| `GET` | `/api/lists/` | Zoznam všetkých zoznamov |
| `POST` | `/api/lists/{id}/relationships/profiles/` | Pridanie profilov do zoznamu |
| `GET` | `/api/segments/` | Zoznam segmentov |
| `GET` | `/api/campaigns/` | Zoznam kampaní |
| `GET` | `/api/flows/` | Zoznam flows |
| `GET` | `/api/metrics/` | Zoznam metrík |
| `POST` | `/api/metric-aggregates/` | Dopyt na agregáty metrík |
| `GET` | `/api/catalog-items/` | Zoznam položiek katalógu |

## Ukážky kódu

### Inicializácia Klaviyo konektora

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

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

// Connect Klaviyo account
await tajo.connectors.connect('klaviyo', {
  privateApiKey: process.env.KLAVIYO_PRIVATE_KEY,
  publicApiKey: process.env.KLAVIYO_PUBLIC_KEY
});
```

### Synchronizácia profilov do Brevo

```javascript
// Fetch Klaviyo profiles and sync to Brevo
const response = await fetch('https://a.klaviyo.com/api/profiles/', {
  headers: {
    'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`,
    'revision': '2026-01-15',
    'Accept': 'application/vnd.api+json'
  }
});

const { data } = await response.json();

// Each profile follows JSON:API format
// {
//   "type": "profile",
//   "id": "01ABCDEF",
//   "attributes": {
//     "email": "jane@example.com",
//     "first_name": "Jane",
//     "last_name": "Kim",
//     "phone_number": "+15551234567",
//     "properties": { "lifetime_value": 450.00 }
//   }
// }
```

### Vytvorenie udalosti

```javascript
// Track an event in Klaviyo (forwarded to Brevo via Tajo)
await fetch('https://a.klaviyo.com/api/events/', {
  method: 'POST',
  headers: {
    'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`,
    'revision': '2026-01-15',
    'Content-Type': 'application/vnd.api+json',
    'Accept': 'application/vnd.api+json'
  },
  body: JSON.stringify({
    data: {
      type: 'event',
      attributes: {
        metric: {
          data: { type: 'metric', attributes: { name: 'Placed Order' } }
        },
        profile: {
          data: { type: 'profile', attributes: { email: 'jane@example.com' } }
        },
        properties: {
          OrderId: 'ORD-1234',
          Value: 89.99,
          Items: [
            { ProductName: 'Widget Pro', Price: 89.99, Quantity: 1 }
          ]
        },
        value: 89.99
      }
    }
  })
});
```

### Dopyt na agregáty metrík

```javascript
// Get aggregate metric data for reporting
await fetch('https://a.klaviyo.com/api/metric-aggregates/', {
  method: 'POST',
  headers: {
    'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`,
    'revision': '2026-01-15',
    'Content-Type': 'application/vnd.api+json'
  },
  body: JSON.stringify({
    data: {
      type: 'metric-aggregate',
      attributes: {
        metric_id: 'METRIC_ID',
        measurements: ['count', 'sum_value'],
        interval: 'day',
        filter: ['greater-or-equal(datetime,2024-01-01)',
                 'less-than(datetime,2024-02-01)']
      }
    }
  })
});
```

## Obmedzenia rýchlosti

| Autentifikácia | Burst limit | Ustálený limit |
| --- | --- | --- |
| **Súkromný API kľúč** | 75 požiadaviek/sek | 700 požiadaviek/min |
| **OAuth** | 150 požiadaviek/sek | 1 500 požiadaviek/min |
| **Client API** | 100 požiadaviek/sek | N/A |
| **Hromadné operácie** | 10 požiadaviek/sek | 100 požiadaviek/min |

Vyžaduje sa revízia API

Všetky Klaviyo API požiadavky vyžadujú hlavičku `revision` nastavenú na platný dátum verzie API (napr. `2026-01-15`). Požiadavky bez tejto hlavičky budú odmietnuté.

## Riešenie problémov

| Problém | Príčina | Riešenie |
| --- | --- | --- |
| `400 Bad Request` | Neplatný alebo chýbajúci API kľúč | Overte, že súkromný API kľúč je správny |
| `403 Forbidden` | Nedostatočný scope | Skontroluj scopy API kľúča zodpovedajúce požadovaným oprávneniam |
| Chýbajúca hlavička `revision` | Hlavička nie je nastavená | Pridaj `revision: 2026-01-15` ku všetkým požiadavkám |
| Profil nenájdený | Nesprávny identifikátor | Použi Klaviyo ID profilu, nie e-mail, pre vyhľadávanie |
| Udalosti sa nesynchronizujú | Nesprávny názov metriky | Zhoduj presné názvy metrík tak, ako sú definované v Klaviyo |
| `429 Too Many Requests` | Prekročený limit rýchlosti | Implementuj exponenciálny backoff, zvážte OAuth pre vyššie limity |
| Chyby formátu JSON:API | Nesprávny content type | Použi `application/vnd.api+json` pre hlavičky Content-Type a Accept |

## Odporúčané postupy

1. **Použi formát JSON:API** - Dodržiavaj špecifikáciu JSON:API pre všetky payloady požiadaviek a odpovedí
2. **Nastav hlavičku revision** - Vždy zahrň hlavičku `revision` s najnovším dátumom verzie API
3. **Použi sparse fieldsets** - Požaduj iba potrebné polia s `?fields[profile]=email,first_name` na zníženie veľkosti payloadu
4. **Využi vzťahy** - Použi parameter `include` JSON:API na načítanie súvisiacich zdrojov v jednej požiadavke
5. **Použi stránkovanie kurzorom** - Naviguj v veľkých výsledkových sadách s parametrom `page[cursor]`
6. **Implementuj hromadné operácie** - Použi hromadné endpointy pre dávkové importy profilov a vytváranie udalostí
7. **Použi OAuth pre vyššie limity** - OAuth autentifikácia poskytuje 2-násobne vyššie limity rýchlosti ako súkromné kľúče

## Bezpečnosť

- **Scopy súkromného API kľúča** - Granulárne riadenie prístupu Read/Full na typ zdroja
- **Podpora OAuth** - Bezpečná autentifikácia na základe tokenov pre partnerské integrácie
- **Izolácia verejného kľúča** - Klientske kľúče obmedzené na operácie iba vytvárania
- **TLS 1.2+** - Všetka API komunikácia šifrovaná pri prenose
- **SOC 2 Type II** - Klaviyo je certifikovaný podľa SOC 2 Type II
- **GDPR súlad** - Data Privacy API pre žiadosti o odstránenie profilov

## Súvisiace zdroje

- [Brevo konektor](https://tajo.io/sk/docs/connectors/marketing/brevo)
- [Google Ads konektor](https://tajo.io/sk/docs/connectors/marketing/google-ads)
- [Meta Ads konektor](https://tajo.io/sk/docs/connectors/marketing/meta-ads)
- [Customer Sync skill](https://tajo.io/sk/docs/skills/data-sync/customer-sync)