---
title: "Customer.io konektor"
description: "Kompletný sprievodca integráciou Customer.io na synchronizáciu ľudí, udalostí, kampaní a dát workflowov s Brevo cez Tajo."
url: https://tajo.io/sk/docs/connectors/marketing/customerio/
markdown: https://tajo.io/sk/docs/connectors/marketing/customerio.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.

# Customer.io konektor

Stav konektora: Plánované Zatiaľ nevytvorené. Tajo tento konektor dnes neprevádzkuje.

| 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 svoju zasielaciu platformu Customer.io s Brevo pre zjednotené dáta zákazníkov, koordináciu kampaní naprieč platformami a konsolidovanú analytiku zapojenia.

## Prehľad

| Vlastnosť | Hodnota |
| --- | --- |
| **Platforma** | Customer.io |
| **Kategória** | Marketing |
| **Zložitosť nastavenia** | Stredná |
| **Oficiálna integrácia** | Nie |
| **Synchronizované dáta** | Ľudia, Udalosti, Kampane, Segmenty |
| **Použité API** | Track API, App API, Pipelines API |
| **Autentifikácia** | Site ID + API Key / App API Key |
| **Base URL** | `track.customer.io`, `api.customer.io` |

## Funkcie

- **Synchronizácia ľudí** - Obojsmerná synchronizácia profilov zákazníkov s kontaktmi Brevo
- **Preposielanie udalostí** - Sleduj behaviorálne udalosti a preposielaj ich do Brevo pre triggery automatizácie
- **Analytika kampaní** - Synchronizuj metriky výkonu kampaní pre jednotné reportovanie
- **Dáta workflowov** - Zrkadlenie stavov workflowov Customer.io v atribútoch kontaktov Brevo
- **Replikácia segmentov** - Replikuj segmenty Customer.io ako zoznamy Brevo
- **Synchronizácia dát objektov** - Synchronizuj ne-osobné objekty a dáta vzťahov

## Predpoklady

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

1. Customer.io účet s API prístupom
2. Tvoj Site ID a Track API Key (nájdeš v Settings > API Credentials)
3. App API kľúč pre čítanie dát kampaní a segmentov
4. Brevo účet s API prístupom
5. Tajo účet s aktívnym predplatným

## Autentifikácia

Customer.io používa dve samostatné API s rôznymi metódami autentifikácie:

### Track API (Behaviorálne dáta)

Používa sa na odosielanie ľudí, udalostí a dát zariadení. Autentifikuje sa pomocou Site ID a API Key cez Basic Auth.

```bash
# Basic Auth: Site ID as username, API Key as password
curl -X POST https://track.customer.io/api/v1/customers/user123 \
  -u "$SITE_ID:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'
```

### App API (Čítanie dát)

Používa sa na načítanie kampaní, segmentov a dát zákazníkov. Autentifikuje sa pomocou Bearer tokenu.

```bash
curl -X GET https://api.customer.io/v1/campaigns \
  -H "Authorization: Bearer $APP_API_KEY"
```

Oddelenie API kľúčov

Track API kľúč a App API kľúč sú rôzne prihlasovací údaje. Track API kľúč sa používa na zápis dát, zatiaľ čo App API kľúč na čítanie dát. Oba sú potrebné pre plnú integráciu Tajo.

### Pripojenie k Tajo

```bash
tajo connectors install customerio \
  --site-id $CIO_SITE_ID \
  --track-api-key $CIO_TRACK_API_KEY \
  --app-api-key $CIO_APP_API_KEY
```

## Konfigurácia

### Základné nastavenie

```yaml
connectors:
  customerio:
    enabled: true
    region: "us"  # or "eu" for EU data center

    sync:
      people: true
      events: true
      campaigns: true
      segments: true
      objects: false

    lists:
      all_contacts: 12
      active_subscribers: 13
      churned: 14
```

### Mapovanie polí

Namapuj atribúty osoby Customer.io na atribúty kontaktov Brevo:

```yaml
field_mapping:
  # Standard fields
  id: CIO_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Engagement metrics
  created_at: SIGNUP_DATE
  last_activity: LAST_ACTIVE
  plan: PLAN_NAME

  # Custom attributes
  company: COMPANY
  role: JOB_TITLE
  mrr: MONTHLY_REVENUE
  lifecycle_stage: LIFECYCLE_STAGE
```

### Mapovanie udalostí

```yaml
event_mapping:
  # Customer.io event -> Brevo event
  purchase_completed: ORDER_PLACED
  subscription_started: SUBSCRIPTION_START
  feature_activated: FEATURE_USED
  support_ticket_opened: SUPPORT_REQUEST
```

## API endpointy

Tajo sa integruje s nasledujúcimi API endpointmi Customer.io:

| Endpoint | Metóda | API | Účel |
| --- | --- | --- | --- |
| `/api/v1/customers/{id}` | PUT | Track | Vytvorenie alebo aktualizácia osoby |
| `/api/v1/customers/{id}/events` | POST | Track | Sledovanie udalosti osoby |
| `/api/v1/events` | POST | Track | Sledovanie anonymných udalostí |
| `/api/v2/entity` | POST | Track | Vytvorenie alebo aktualizácia ľudí/objektov (Pipelines) |
| `/v1/campaigns` | GET | App | Zoznam kampaní |
| `/v1/campaigns/{id}/metrics` | GET | App | Metriky výkonu kampane |
| `/v1/segments` | GET | App | Zoznam segmentov |
| `/v1/segments/{id}/membership` | GET | App | Získanie členov segmentu |
| `/v1/customers/{id}/attributes` | GET | App | Získanie atribútov zákazníka |
| `/v1/customers/{id}/activities` | GET | App | Získanie denníka aktivity zákazníka |

## Ukážky kódu

### Inicializácia konektora

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

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

await tajo.connectors.connect('customerio', {
  siteId: process.env.CIO_SITE_ID,
  trackApiKey: process.env.CIO_TRACK_API_KEY,
  appApiKey: process.env.CIO_APP_API_KEY,
  region: 'us'
});
```

### Synchronizácia ľudí do Brevo

```javascript
// Incremental sync of Customer.io people
await tajo.connectors.sync('customerio', {
  type: 'incremental',
  resources: ['people'],
  since: '2024-01-01',
  batchSize: 100
});

const status = await tajo.connectors.status('customerio');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T14:20:00Z',
//   peopleCount: 32500,
//   campaignsTracked: 18,
//   eventsProcessed: 87000
// }
```

### Preposielanie udalostí

```javascript
// Forward Customer.io reporting webhook events to Brevo
app.post('/webhooks/customerio', async (req, res) => {
  const events = req.body;

  for (const event of events) {
    await tajo.connectors.handleEvent('customerio', {
      type: event.metric,
      payload: {
        customerId: event.data.customer_id,
        campaignId: event.data.campaign_id,
        timestamp: event.timestamp
      }
    });
  }

  res.status(200).send('OK');
});
```

### Export segmentu

```javascript
const result = await tajo.connectors.exportSegment('customerio', {
  segmentId: 42,
  targetList: 13,
  includeAttributes: ['email', 'first_name', 'last_name', 'plan']
});

console.log(`Exported ${result.count} people to Brevo list 13`);
```

## Obmedzenia rýchlosti

Customer.io presadzuje rôzne limity rýchlosti na API:

| API | Limit rýchlosti | Poznámky |
| --- | --- | --- |
| **Track API** | ~100 požiadaviek/sekundu | Na workspace |
| **App API** | 10 požiadaviek/sekundu | Na API kľúč |
| **Pipelines API** | 100 požiadaviek/sekundu | Odporúčané pre hromadné dáta |
| **Dávkový endpoint** | 1 000 ľudí na požiadavku | Max payload 500 KB |

Použi dávkové endpointy

Pre veľké synchronizácie Tajo používa dávkový endpoint Customer.io na odosielanie až 1 000 ľudí na požiadavku, čím výrazne znižuje objem API volaní.

## Riešenie problémov

### Bežné problémy

| Problém | Príčina | Riešenie |
| --- | --- | --- |
| 401 Unauthorized | Neplatný Site ID alebo API kľúč | Overte prihlasovací údaje v Customer.io Settings > API |
| Ľudia sa nesynchronizujú | Chýbajúci identifikátor | Uisti sa, že každá osoba má `id` alebo `email` |
| Udalosti nie sú sledované | Nesprávny typ API kľúča | Použi Track API kľúč pre udalosti, nie App API kľúč |
| Dáta EU nie sú dostupné | Nakonfigurovaný nesprávny región | Nastav región na `eu` pre EU workspaces |
| Chyby limitu rýchlosti | Príliš veľa App API volaní | Znižuj frekvenciu pollovania dát kampaní |

### Debug režim

```yaml
connectors:
  customerio:
    debug: true
    log_level: verbose
    log_api_calls: true
```

### Test pripojenia

```bash
tajo connectors test customerio
# ✓ Track API connection successful
# ✓ App API connection successful
# ✓ People accessible
# ✓ Campaigns readable
# ✓ Segments listable
```

## Odporúčané postupy

1. **Použi Pipelines API pre hromadné dáta** - Novšie Pipelines API je optimalizované pre veľkoobjemový príjem
2. **Nastav reportovacie webhooky** - Preposielaj e-mailové udalosti Customer.io do Tajo v reálnom čase
3. **Mapuj fázy životného cyklu** - Synchronizuj členstvo v segmentoch Customer.io na atribúty Brevo
4. **Použi konzistentné identifikátory** - Zhoduj polia `id` naprieč Customer.io a Brevo
5. **Synchronizuj inkrementálne** - Vyhni sa plným exportom; využívaj časové pečiatky `last_activity`
6. **Monitoruj doručenie webhookov** - Nastav upozornenia pre neúspešné doručenia webhookov

## Bezpečnosť

- **Basic Auth** - Track API sa autentifikuje pomocou Site ID a API Key
- **Bearer Token** - App API používa bearer tokeny v OAuth štýle
- **Iba HTTPS** - Všetka API komunikácia šifrovaná cez TLS 1.2+
- **Regionálne dátové centrá** - Možnosť EU dátového centra pre GDPR súlad
- **Šifrované úložisko** - Všetky prihlasovací údaje šifrované v pokoji v Tajo
- **Podpisy webhookov** - Overuj payloady webhookov pomocou HMAC podpisov

## Súvisiace zdroje

- [Braze konektor](https://tajo.io/sk/docs/connectors/marketing/braze)
- [Iterable konektor](https://tajo.io/sk/docs/connectors/marketing/iterable)
- [Customer Sync skill](https://tajo.io/sk/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/sk/docs/contact-management)