---
title: "Konektor Customer.io"
description: "Kompletní průvodce integrací Customer.io pro synchronizaci osob, událostí, kampaní a dat pracovních toků s Brevo přes Tajo."
url: https://tajo.io/cz/docs/connectors/marketing/customerio/
markdown: https://tajo.io/cz/docs/connectors/marketing/customerio.md
lang: cs-CZ
robots: noindex
---

Požádejte o přednostní přístup

Zadejte své jméno a pracovní e-mailovou adresu. Pošleme vám odkaz pro potvrzení žádosti o přístup k Tajo.

# Konektor Customer.io

Stav konektoru: Plánováno Zatím nevytvořeno. Tajo tento konektor dnes neprovozuje.

| Zdrojové pole | Cílové pole | Ukázková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Propojte svou zasílací platformu Customer.io s Brevo pro sjednocená zákaznická data, koordinaci kampaní napříč platformami a konsolidovanou analytiku zapojení.

## Přehled

| Vlastnost | Hodnota |
| --- | --- |
| **Platforma** | Customer.io |
| **Kategorie** | Marketing |
| **Složitost nastavení** | Střední |
| **Oficiální integrace** | Ne |
| **Synchronizovaná data** | Osoby, Události, Kampaně, Segmenty |
| **Použitá API** | Track API, App API, Pipelines API |
| **Ověření** | Site ID + API klíč / App API klíč |
| **Základní URL** | `track.customer.io`, `api.customer.io` |

## Funkce

- **Synchronizace osob** – Obousměrná synchronizace zákaznických profilů s kontakty Brevo
- **Přeposílání událostí** – Sledujte behaviorální události a přeposílejte do Brevo pro spouštěče automatizací
- **Analytika kampaní** – Synchronizujte metriky výkonu kampaní pro sjednocené reportování
- **Data pracovních toků** – Zrcadlete stavy pracovních toků Customer.io v atributech kontaktů Brevo
- **Replikace segmentů** – Replikujte segmenty Customer.io jako seznamy Brevo
- **Synchronizace dat objektů** – Synchronizujte ne-osobní objekty a data vztahů

## Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet Customer.io s přístupem k API
2. Vaše Site ID a Track API klíč (nalezené v Nastavení > API Credentials)
3. App API klíč pro čtení dat kampaní a segmentů
4. Účet Brevo s přístupem k API
5. Účet Tajo s aktivním předplatným

## Ověření

Customer.io používá dvě oddělená API s různými metodami ověřování:

### Track API (Behaviorální data)

Používá se pro odesílání osob, událostí a dat zařízení. Ověřuje pomocí Site ID a API klíče přes Basic Auth.

```bash
# Základní ověření: Site ID jako uživatelské jméno, API klíč jako heslo
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 (Čtení dat)

Používá se pro načítání kampaní, segmentů a zákaznických dat. Ověřuje pomocí Bearer tokenu.

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

Oddělení API klíčů

Track API klíč a App API klíč jsou různé přihlašovací údaje. Track API klíč se používá pro zápis dat, zatímco App API klíč je pro čtení dat. Oba jsou vyžadovány pro plnou integraci Tajo.

### Připojení 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
```

## Konfigurace

### Základní nastavení

```yaml
connectors:
  customerio:
    enabled: true
    region: "us"  # nebo "eu" pro datové centrum EU

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

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

### Mapování polí

Mapujte atributy osob Customer.io na atributy kontaktů Brevo:

```yaml
field_mapping:
  # Standardní pole
  id: CIO_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Metriky zapojení
  created_at: SIGNUP_DATE
  last_activity: LAST_ACTIVE
  plan: PLAN_NAME

  # Vlastní atributy
  company: COMPANY
  role: JOB_TITLE
  mrr: MONTHLY_REVENUE
  lifecycle_stage: LIFECYCLE_STAGE
```

### Mapování událostí

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

## Koncové body API

Tajo se integruje s následujícími koncovými body Customer.io API:

| Koncový bod | Metoda | API | Účel |
| --- | --- | --- | --- |
| `/api/v1/customers/{id}` | PUT | Track | Vytvoření nebo aktualizace osoby |
| `/api/v1/customers/{id}/events` | POST | Track | Sledování události osoby |
| `/api/v1/events` | POST | Track | Sledování anonymních událostí |
| `/api/v2/entity` | POST | Track | Vytvoření nebo aktualizace osob/objektů (Pipelines) |
| `/v1/campaigns` | GET | App | Výpis kampaní |
| `/v1/campaigns/{id}/metrics` | GET | App | Metriky výkonu kampaně |
| `/v1/segments` | GET | App | Výpis segmentů |
| `/v1/segments/{id}/membership` | GET | App | Načtení členů segmentu |
| `/v1/customers/{id}/attributes` | GET | App | Načtení atributů zákazníka |
| `/v1/customers/{id}/activities` | GET | App | Načtení protokolu aktivity zákazníka |

## Příklady kódu

### Inicializace konektoru

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

### Synchronizace osob do Brevo

```javascript
// Přírůstková synchronizace osob Customer.io
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
// }
```

### Přeposílání událostí

```javascript
// Přeposílání webhookových událostí reportování Customer.io do 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(`Exportováno ${result.count} osob do seznamu Brevo 13`);
```

## Omezení rychlosti

Customer.io vynucuje různé limity rychlosti pro každé API:

| API | Limit rychlosti | Poznámky |
| --- | --- | --- |
| **Track API** | ~100 požadavků/sekundu | Na workspace |
| **App API** | 10 požadavků/sekundu | Na API klíč |
| **Pipelines API** | 100 požadavků/sekundu | Doporučeno pro hromadná data |
| **Dávkový koncový bod** | 1 000 osob na požadavek | Max payload 500 KB |

Používejte dávkové koncové body

Pro velké synchronizace používá Tajo dávkový koncový bod Customer.io pro odesílání až 1 000 osob na požadavek, čímž výrazně snižuje objem volání API.

## Řešení problémů

### Časté problémy

| Problém | Příčina | Řešení |
| --- | --- | --- |
| 401 Unauthorized | Neplatné Site ID nebo API klíč | Ověřte přihlašovací údaje v Customer.io Nastavení > API |
| Osoby se nesynchronizují | Chybějící identifikátor | Ujistěte se, že každá osoba má `id` nebo `email` |
| Události se nesledují | Nesprávný typ API klíče | Používejte Track API klíč pro události, nikoli App API klíč |
| Data EU nejsou přístupná | Špatně nakonfigurovaný region | Nastavte region na `eu` pro workspace EU |
| Chyby limitu rychlosti | Příliš mnoho volání App API | Snižte frekvenci pollování dat kampaní |

### Režim ladění

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

### Test připojení

```bash
tajo connectors test customerio
# ✓ Připojení Track API úspěšné
# ✓ Připojení App API úspěšné
# ✓ Osoby přístupné
# ✓ Kampaně čitelné
# ✓ Segmenty vypisovatelné
```

## Osvědčené postupy

1. **Používejte Pipelines API pro hromadná data** – Novější Pipelines API je optimalizováno pro velkoobjerné zpracování
2. **Nastavte reportovací webhooky** – Přeposílejte e-mailové události Customer.io do Tajo v reálném čase
3. **Mapujte fáze životního cyklu** – Synchronizujte členství v segmentech Customer.io na atributy Brevo
4. **Používejte konzistentní identifikátory** – Shodujte pole `id` napříč Customer.io a Brevo
5. **Synchronizujte přírůstkově** – Vyhněte se úplným exportům; využívejte časová razítka `last_activity`
6. **Monitorujte doručení webhooků** – Nastavte upozornění pro neúspěšná doručení webhooků

## Zabezpečení

- **Základní ověření** – Track API ověřuje pomocí Site ID a API klíče
- **Bearer token** – App API používá bearer tokeny ve stylu OAuth
- **Pouze HTTPS** – Veškerá API komunikace šifrovaná přes TLS 1.2+
- **Regionální datová centra** – Možnost datového centra EU pro soulad s GDPR
- **Šifrované úložiště** – Všechny přihlašovací údaje šifrované v klidu v Tajo
- **Podpisy webhooků** – Ověřujte payloady webhooků pomocí podpisů HMAC

## Související zdroje

- [Konektor Braze](https://tajo.io/cz/docs/connectors/marketing/braze)
- [Konektor Iterable](https://tajo.io/cz/docs/connectors/marketing/iterable)
- [Dovednost synchronizace zákazníků](https://tajo.io/cz/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/cz/docs/contact-management)