---
title: "Twilio Segment Connector"
description: "Vollständiger Leitfaden zur Twilio-Segment-Integration für die Synchronisierung von Kundendaten, Events und Audience-Segmenten mit Brevo über Tajo."
url: https://tajo.io/de/docs/connectors/custom/segment/
markdown: https://tajo.io/de/docs/connectors/custom/segment.md
lang: de-DE
robots: noindex
---

Beantrage frühzeitigen Zugang

Gib deinen Vornamen und deine geschäftliche E-Mail-Adresse ein. Wir senden dir einen Link, mit dem du deine Anfrage für den Tajo-Zugang bestätigst.

# Twilio Segment Connector

Connector-Status: Geplant Noch nicht gebaut. Tajo betreibt diesen Connector heute nicht.

| Quellfeld | Zielfeld | Beispielwert |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Verbinde Twilio Segment über Tajo mit Brevo, um deine Kundendaten-Pipeline zu vereinheitlichen, Events aus beliebigen Quellen an Brevo weiterzuleiten und die Identitätsauflösung von Segment für umfassendere Marketing-Automation zu nutzen.

## Überblick

| Eigenschaft | Wert |
| --- | --- |
| **Plattform** | Twilio Segment |
| **Kategorie** | Data Platform (Custom) |
| **Einrichtungsaufwand** | Mittel |
| **Offizielle Integration** | Nein |
| **Synchronisierte Daten** | Events, Kund:innen, Traits, Audiences |
| **Verfügbare Skills** | 8 |

## Funktionen

- **Universelle Datenerfassung** - Erfasse Events von Websites, Mobile-Apps und Servern über Segment-SDKs
- **Source-Routing** - Leite Daten aus 400+ Quellen über Tajo in Brevo
- **Identitätsauflösung** - Merge anonyme und bekannte Nutzer:innen-Profile automatisch
- **Audience-Synchronisation** - Sende berechnete Traits und Audiences von Segment an Brevo-Listen
- **Event-Streaming** - Echtzeit-Event-Forwarding über das Connections-Framework von Segment
- **Reverse ETL** - Synchronisiere Warehouse-Daten zurück in Brevo mit Segment Reverse ETL
- **Schema-Enforcement** - Validiere Event-Schemas mit Segment Protocols vor der Synchronisation

## Voraussetzungen

Bevor du beginnst, stelle sicher, dass du Folgendes hast:

1. Einen Twilio-Segment-Workspace mit konfigurierter Source
2. Deinen Segment Write Key für die Source
3. Ein Brevo-Konto mit API-Zugriff
4. Ein Tajo-Konto mit API-Zugangsdaten

## Authentifizierung

### Segment Write Key

Segment authentifiziert Sources über einen Write Key – eine eindeutige Kennung, die an jede Source gebunden ist.

```javascript
// Analytics.js initialization with Write Key
analytics.load("YOUR_SEGMENT_WRITE_KEY");
```

### Tajo API Token

Konfiguriere den Tajo-Connector mit deinen Zugangsdaten:

```bash
tajo connectors install segment \
  --write-key $SEGMENT_WRITE_KEY \
  --workspace-slug your-workspace \
  --brevo-api-key $BREVO_API_KEY
```

## Konfiguration

### Grundeinrichtung

```yaml
connectors:
  segment:
    enabled: true
    write_key: "your-segment-write-key"
    data_region: "us"  # or "eu" for EU workspace

    # Data sync options
    sync:
      identify: true
      track: true
      page: true
      group: false

    # Brevo list assignment
    lists:
      all_contacts: 5
      active_users: 6
      high_value: 7
```

### Event-Mapping

Mappe Segment-Track-Events auf Brevo-Event-Typen:

```yaml
event_mapping:
  # Segment event -> Brevo event
  "Order Completed": "order_completed"
  "Product Viewed": "product_viewed"
  "Cart Updated": "cart_updated"
  "Signed Up": "customer_created"
  "Checkout Started": "checkout_started"

  # Custom events
  "Feature Used": "feature_used"
  "Plan Upgraded": "plan_upgraded"
```

### Trait-Mapping

Mappe Segment-Identify-Traits auf Brevo-Kontaktattribute:

```yaml
trait_mapping:
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS
  plan: PLAN_TYPE
  company: COMPANY
  createdAt: SIGNUP_DATE
  lifetimeValue: LTV
```

## API-Endpoints

| Methode | Endpoint | Beschreibung |
| --- | --- | --- |
| `POST` | `/v1/identify` | Nutzer:in mit Traits identifizieren |
| `POST` | `/v1/track` | Event tracken |
| `POST` | `/v1/page` | Seitenaufruf erfassen |
| `POST` | `/v1/screen` | Screen-View erfassen |
| `POST` | `/v1/group` | Nutzer:in einer Gruppe zuordnen |
| `POST` | `/v1/alias` | Zwei Nutzer-Identitäten zusammenführen |
| `POST` | `/v1/batch` | Mehrere Nachrichten in einem Batch senden |
| `POST` | `/v1/import` | Historische Daten bulk-importieren |

## Code-Beispiele

### Segment mit Tajo-Destination initialisieren

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

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

// Connect Segment source
await tajo.connectors.connect('segment', {
  writeKey: process.env.SEGMENT_WRITE_KEY,
  workspaceSlug: 'your-workspace'
});
```

### Events via Segment tracken

```javascript
// Identify a user - syncs to Brevo contacts
analytics.identify("user_123", {
  email: "jane@example.com",
  firstName: "Jane",
  lastName: "Kim",
  plan: "premium",
  lifetimeValue: 450.00
});

// Track an event - forwards to Brevo
analytics.track("Order Completed", {
  orderId: "ORD-1234",
  revenue: 89.99,
  currency: "USD",
  products: [
    { id: "SKU-001", name: "Widget", price: 89.99 }
  ]
});

// Page view tracking
analytics.page("Pricing", {
  title: "Pricing - Tajo",
  url: "https://tajo.io/pricing"
});
```

### Serverseitiges Event-Forwarding (Node.js)

```javascript
const Analytics = require('analytics-node');
const analytics = new Analytics(process.env.SEGMENT_WRITE_KEY);

// Batch identify users from your database
const users = await db.query('SELECT * FROM users WHERE updated_at > $1', [lastSync]);

for (const user of users) {
  analytics.identify({
    userId: user.id,
    traits: {
      email: user.email,
      firstName: user.first_name,
      lastName: user.last_name,
      totalOrders: user.order_count,
      lifetimeValue: user.ltv
    }
  });
}

// Flush the queue
await analytics.flush();
```

## Rate Limits

| Tarif | Limit | Zeitraum |
| --- | --- | --- |
| **Free** | 1.000 Events/Sek | Pro Source |
| **Team** | 10.000 Events/Sek | Pro Source |
| **Business** | Individuell | Pro Workspace |
| **Batch API** | 500 KB max | Pro Anfrage |
| **Max. Batch-Größe** | 100 Events | Pro Batch-Aufruf |

Batch-Größen-Limits

Jede Batch-Anfrage darf maximal 100 Events enthalten und 500 KB nicht überschreiten. Nutze für große historische Importe die Segment Bulk Import API.

## Fehlerbehebung

| Problem | Ursache | Lösung |
| --- | --- | --- |
| Events erscheinen nicht in Brevo | Destination nicht aktiviert | Tajo-Destination in Segment aktivieren |
| Nutzer:innen-Traits synchronisieren nicht | Fehlender E-Mail-Identifier | Sicherstellen, dass `email`-Trait in Identify-Calls enthalten ist |
| Duplizierte Kontakte | Mehrere anonyme IDs | Korrekte `alias`-Aufrufe für Identitäts-Merge implementieren |
| Events verzögert | Warteschlange mit hohem Volumen | Event-Delivery-Dashboard von Segment prüfen |
| Schema-Verletzungen | Ungeplante Events | Segment Protocols Tracking Plan überprüfen |
| 429 Rate-Limit-Fehler | Zu viele Anfragen | Batching implementieren oder Event-Häufigkeit reduzieren |

## Best Practices

1. **Identify vor Track nutzen** - Rufe immer `identify` vor `track` auf, damit Events der richtigen Nutzer:in zugeordnet werden
2. **Tracking Plan implementieren** - Nutze Segment Protocols, um Event-Schemas durchzusetzen
3. **Serverseitige Aufrufe bündeln** - Nutze die Batch-API für serverseitige Integrationen, um HTTP-Overhead zu reduzieren
4. **Traits explizit mappen** - Definiere Trait-zu-Attribut-Mappings, anstatt dich auf Defaults zu verlassen
5. **Segment Functions nutzen** - Transformiere Events in-flight, bevor sie Brevo erreichen
6. **Event-Delivery überwachen** - Prüfe das Event-Delivery-Dashboard von Segment auf fehlgeschlagene Events
7. **Replay einrichten** - Aktiviere Segment Replay, um historische Events neu zu verarbeiten

## Sicherheit

- **TLS-Verschlüsselung** - Alle Daten werden über HTTPS/TLS 1.2+ übertragen
- **Write-Key-Isolation** - Jede Source hat ihren eigenen Write Key
- **DSGVO-Konformität** - Segment unterstützt Datenlöschungs- und Sperranfragen
- **SOC 2 Type II** - Segment ist SOC 2 Type II zertifiziert
- **Regionales Data Hosting** - EU-Workspace-Option für Datenresidenz-Konformität

## Verwandte Ressourcen

- [Amplitude Connector](https://tajo.io/de/docs/connectors/custom/amplitude)
- [Mixpanel Connector](https://tajo.io/de/docs/connectors/custom/mixpanel)
- [Customer-Sync-Skill](https://tajo.io/de/docs/skills/data-sync/customer-sync)
- [Brevo Events API](https://tajo.io/de/docs/events-engagement/create-event)