---
title: "Customer.io Connector"
description: "Popoln vodnik za integracijo Customer.io za sinhronizacijo profilov strank, dogodkov in kampanj z Brevo prek Tajo."
url: https://tajo.io/sl/docs/connectors/marketing/customerio/
markdown: https://tajo.io/sl/docs/connectors/marketing/customerio.md
lang: sl-SI
robots: noindex
---

Zaprosite za zgodnji dostop

Vnesite svoje ime in službeni e-poštni naslov. Poslali vam bomo povezavo za potrditev zahteve za dostop do Taja.

# Customer.io Connector

Stanje konektorja: Načrtovano Še ni izdelano. Tajo danes ne poganja tega konektorja.

| Izvorno polje | Ciljno polje | Vzorčna vrednost |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Poveži Customer.io z Brevo prek Tajo za sinhronizacijo vedenjskih podatkov strank, dogodkov in kampanj za enotno večkanalno avtomatizacijo marketinga.

## Pregled

| Lastnost | Vrednost |
| --- | --- |
| **Platforma** | Customer.io |
| **Kategorija** | Marketing |
| **Zahtevnost nastavitve** | Srednja |
| **Uradna integracija** | Ne |
| **Sinhronizirani podatki** | Stranke, dogodki, kampanje, segmenti |
| **Metoda avtentikacije** | API ključ / App API ključ |

## Funkcionalnosti

- **Sinhronizacija profilov** – sinhroniziraj profile strank med Customer.io in Brevo
- **Posredovanje dogodkov** – pošlji vedenjske dogodke Customer.io v avtomatizacije Brevo
- **Sinhronizacija segmentov** – preslikaj segmente Customer.io v sezname stikov Brevo
- **Migracija kampanj** – prenos kampanj in sporočilnih tokov med platformama
- **Sledenje atributom** – sinhroniziraj atribute strank za ciljanje in personalizacijo
- **Integracija webhooks** – obravnavaj sporočilne in kampanjske dogodke v realnem času

## Predpogoji

Preden začneš, se prepričaj, da imaš:

1. Račun Customer.io z dostopom do API
2. API ključ spletnega mesta (za sledenje) in App API ključ (za upravljanje)
3. Brevo račun z dostopom do API
4. Tajo račun z dovoljenji za konektorje

## Avtentikacija

### API ključ spletnega mesta (sledenje)

```bash
# Site API key for Track API
export CIO_SITE_ID=your_site_id
export CIO_API_KEY=your_api_key
export TAJO_API_KEY=your_tajo_api_key
export BREVO_API_KEY=your_brevo_api_key
```

### App API ključ (upravljanje)

```bash
# Bearer token for App API
curl https://api.customer.io/v1/customers \
  -H "Authorization: Bearer YOUR_APP_API_KEY"
```

## Konfiguracija

### Osnovna nastavitev

```yaml
connectors:
  customerio:
    enabled: true
    site_id: "${CIO_SITE_ID}"
    api_key: "${CIO_API_KEY}"
    app_api_key: "${CIO_APP_API_KEY}"
    region: "us"  # or "eu"

    sync:
      customers: true
      events: true
      segments: true
      campaigns: true

    lists:
      all_customers: 10
      active_users: 11
      churned: 12
```

### Preslikava polj

```yaml
field_mapping:
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS
  plan: SUBSCRIPTION_PLAN
  created_at: SIGNUP_DATE
  last_active: LAST_ACTIVITY_DATE
  segment_ids: CIO_SEGMENTS
```

## Končne točke API

| Metoda | Končna točka | Opis |
| --- | --- | --- |
| `PUT` | `https://track.customer.io/api/v1/customers/{id}` | Ustvari ali posodobi stranko |
| `DELETE` | `https://track.customer.io/api/v1/customers/{id}` | Izbriši stranko |
| `POST` | `https://track.customer.io/api/v1/customers/{id}/events` | Sledi dogodku |
| `GET` | `https://api.customer.io/v1/customers/{id}` | Pridobi stranko |
| `GET` | `https://api.customer.io/v1/segments` | Seznam segmentov |
| `GET` | `https://api.customer.io/v1/segments/{id}/membership` | Člani segmenta |
| `GET` | `https://api.customer.io/v1/campaigns` | Seznam kampanj |
| `POST` | `https://api.customer.io/v1/send/email` | Pošlji transakcijski e-mail |

## Primeri kode

### Inicializacija konektorja

```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,
  apiKey: process.env.CIO_API_KEY,
  appApiKey: process.env.CIO_APP_API_KEY
});
```

### Sinhronizacija profila stranke

```javascript
// Identify/update a customer in Customer.io
const response = await fetch(
  `https://track.customer.io/api/v1/customers/${customerId}`,
  {
    method: 'PUT',
    headers: {
      'Authorization': `Basic ${Buffer.from(
        `${process.env.CIO_SITE_ID}:${process.env.CIO_API_KEY}`
      ).toString('base64')}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      email: 'jane@example.com',
      first_name: 'Jane',
      last_name: 'Kim',
      plan: 'premium',
      created_at: Math.floor(Date.now() / 1000)
    })
  }
);
```

### Sledenje vedenjskim dogodkom

```javascript
// Track an event and forward to Brevo via Tajo
await fetch(
  `https://track.customer.io/api/v1/customers/${customerId}/events`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Basic ${Buffer.from(
        `${process.env.CIO_SITE_ID}:${process.env.CIO_API_KEY}`
      ).toString('base64')}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      name: 'purchase_completed',
      data: {
        order_id: 'ORD-789',
        revenue: 99.99,
        products: ['Widget Pro']
      }
    })
  }
);
```

## Omejitve hitrosti

| API | Omejitev | Opombe |
| --- | --- | --- |
| Track API | 100 zahtevkov/s | Na spletno mesto |
| App API | 10 zahtevkov/s | Na API ključ |
| Batch API | 1.000 dogodkov/zahtevek | Največ 500 KB |

Uveljavljanje regije

Customer.io ima ločene gostovalne regije EU in ZDA. Zagotovi, da se tvoji API klici ujemajo z regijo tvojega računa. Klici napačni regiji vrnejo napako 404.

## Odpravljanje težav

| Težava | Vzrok | Rešitev |
| --- | --- | --- |
| 401 Unauthorized | Napačne poverilnice | Preveri par Site ID in API ključ |
| Stranka ni najdena | ID ne obstaja | Najprej ustvari stranko prek Track API |
| Dogodki se ne prikažejo | Napačna regija | Preveri nastavitev regije EU/ZDA |
| Napaka webhook | URL ni dostopen | Preveri, ali je URL webhooks javno dostopen |

### Način odpravljanja napak

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

## Najboljše prakse

1. **Najprej identificiraj stranke** – vedno ustvari profil stranke pred sledenjem dogodkov
2. **Uporabi ustrezno regijo** – nastavi regijo EU ali ZDA glede na lokacijo tvojega računa
3. **Paketni dogodki** – za zmanjšanje stroškov HTTP na strani strežnika uporabi Batch API
4. **Sinhronizacija segmentov** – redno sinhroniziraj segmente Customer.io za ažurne sezname Brevo
5. **Preslikaj atribute dosledno** – ohrani dosledno poimenovanje atributov med platformama
6. **Upravljaj odjave** – sinhroniziraj odjave med Customer.io in Brevo za skladnost

## Varnost

- **HTTP Basic Auth** – poverilnice zakodirane z Base64 za Track API
- **Avtentikacija z žetonom prinosnika** – App API ključ prek glave Authorization
- **TLS šifriranje** – vsa komunikacija API šifrirana prek HTTPS
- **Izolacija ključev** – ločeni ključi za sledenje in upravljalne operacije
- **Regionalna izolacija podatkov** – ločeno gostovanje podatkov EU/ZDA

## Povezani viri

- [Brevo Connector](https://tajo.io/sl/docs/connectors/marketing/brevo)
- [Klaviyo Connector](https://tajo.io/sl/docs/connectors/marketing/klaviyo)
- [Customer Sync Skill](https://tajo.io/sl/docs/skills/data-sync/customer-sync)
- [Customer.io API dokumentacija](https://customer.io/docs/api/)