---
title: "Connecteur Twilio Segment"
description: "Guide complet d'intégration Twilio Segment pour synchroniser données clients, événements et segments d'audience avec Brevo via Tajo."
url: https://tajo.io/fr/docs/connectors/custom/segment/
markdown: https://tajo.io/fr/docs/connectors/custom/segment.md
lang: fr-FR
robots: noindex
---

Demandez un accès anticipé

Indiquez votre prénom et votre adresse e-mail professionnelle. Nous vous enverrons un lien pour confirmer votre demande d’accès à Tajo.

# Connecteur Twilio Segment

Statut du connecteur: Prévu Pas encore construit. Tajo n'exécute pas ce connecteur aujourd'hui.

| Champ source | Champ de destination | Valeur d’exemple |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Connectez Twilio Segment à Brevo via Tajo pour unifier votre pipeline de données clients, router les événements depuis n’importe quelle source vers Brevo et exploiter la résolution d’identité de Segment pour une automatisation marketing plus riche.

## Vue d’ensemble

| Propriété | Valeur |
| --- | --- |
| **Plateforme** | Twilio Segment |
| **Catégorie** | Data Platform (Custom) |
| **Complexité d’installation** | Moyenne |
| **Intégration officielle** | Non |
| **Données synchronisées** | Événements, clients, traits, audiences |
| **Skills disponibles** | 8 |

## Fonctionnalités

- **Collecte universelle de données**, Collectez les événements depuis sites web, apps mobiles et serveurs via les SDK Segment
- **Routage de sources**, Routez les données depuis 400+ sources vers Brevo via Tajo
- **Résolution d’identité**, Fusionnez automatiquement les profils utilisateurs anonymes et connus
- **Synchronisation d’audiences**, Envoyez les traits et audiences calculés par Segment vers les listes Brevo
- **Streaming d’événements**, Transfert d’événements en temps réel via le framework Connections de Segment
- **Reverse ETL**, Synchronisez les données d’entrepôt vers Brevo via Segment Reverse ETL
- **Application de schéma**, Validez les schémas d’événements avec Segment Protocols avant synchronisation

## Prérequis

Avant de commencer, assurez-vous de disposer de :

1. Un workspace Twilio Segment avec une source configurée
2. Votre Write Key Segment pour la source
3. Un compte Brevo avec accès API
4. Un compte Tajo avec identifiants API

## Authentification

### Segment Write Key

Segment authentifie les sources à l’aide d’un Write Key, un identifiant unique lié à chaque source.

```javascript
// Initialisation d'Analytics.js avec le Write Key
analytics.load("YOUR_SEGMENT_WRITE_KEY");
```

### Token API Tajo

Configurez le connecteur Tajo avec vos identifiants :

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

## Configuration

### Configuration de base

```yaml
connectors:
  segment:
    enabled: true
    write_key: "your-segment-write-key"
    data_region: "us"  # ou "eu" pour un workspace UE

    # Options de synchronisation des données
    sync:
      identify: true
      track: true
      page: true
      group: false

    # Attribution de listes Brevo
    lists:
      all_contacts: 5
      active_users: 6
      high_value: 7
```

### Mappage des événements

Mappez les événements track Segment vers des types d’événements Brevo :

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

  # Événements personnalisés
  "Feature Used": "feature_used"
  "Plan Upgraded": "plan_upgraded"
```

### Mappage des traits

Mappez les traits identify Segment vers les attributs de contact Brevo :

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

## Endpoints API

| Méthode | Endpoint | Description |
| --- | --- | --- |
| `POST` | `/v1/identify` | Identifier un utilisateur avec des traits |
| `POST` | `/v1/track` | Tracker un événement |
| `POST` | `/v1/page` | Enregistrer une vue de page |
| `POST` | `/v1/screen` | Enregistrer une vue d’écran |
| `POST` | `/v1/group` | Associer un utilisateur à un groupe |
| `POST` | `/v1/alias` | Fusionner deux identités utilisateur |
| `POST` | `/v1/batch` | Envoyer plusieurs messages en lot |
| `POST` | `/v1/import` | Import en masse de données historiques |

## Exemples de code

### Initialiser Segment avec une destination Tajo

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

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

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

### Tracker des événements via Segment

```javascript
// Identifier un utilisateur, synchronise vers les contacts Brevo
analytics.identify("user_123", {
  email: "jane@example.com",
  firstName: "Jane",
  lastName: "Kim",
  plan: "premium",
  lifetimeValue: 450.00
});

// Tracker un événement, transféré vers Brevo
analytics.track("Order Completed", {
  orderId: "ORD-1234",
  revenue: 89.99,
  currency: "USD",
  products: [
    { id: "SKU-001", name: "Widget", price: 89.99 }
  ]
});

// Tracking de vue de page
analytics.page("Pricing", {
  title: "Pricing - Tajo",
  url: "https://tajo.io/pricing"
});
```

### Transfert d’événements côté serveur (Node.js)

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

// Identify en lot des utilisateurs depuis votre base de données
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
    }
  });
}

// Vider la file d'attente
await analytics.flush();
```

## Limites de débit

| Tier | Limite | Fenêtre |
| --- | --- | --- |
| **Free** | 1 000 événements/s | Par source |
| **Team** | 10 000 événements/s | Par source |
| **Business** | Personnalisé | Par workspace |
| **Batch API** | 500 Ko max | Par requête |
| **Taille max de lot** | 100 événements | Par appel batch |

Limites de taille de lot

Chaque requête batch peut contenir au maximum 100 événements et ne doit pas dépasser 500 Ko. Pour les imports historiques volumineux, utilisez l’API Bulk Import de Segment.

## Dépannage

| Problème | Cause | Solution |
| --- | --- | --- |
| Les événements n’apparaissent pas dans Brevo | Destination non activée | Activez la destination Tajo dans Segment |
| Les traits utilisateur ne se synchronisent pas | Identifiant e-mail manquant | Assurez-vous que le trait `email` est inclus dans les appels identify |
| Contacts en double | Plusieurs IDs anonymes | Implémentez les appels `alias` pour la fusion d’identité |
| Événements retardés | File d’attente à fort volume | Consultez le tableau de bord de livraison d’événements Segment |
| Violations de schéma | Événements non planifiés | Révisez le tracking plan Segment Protocols |
| Erreurs 429 rate limit | Trop de requêtes | Implémentez le batching ou réduisez la fréquence d’événements |

## Bonnes pratiques

1. **Identify avant track**, Appelez toujours `identify` avant `track` pour garantir que les événements sont attribués au bon utilisateur
2. **Implémentez un tracking plan**, Utilisez Segment Protocols pour faire respecter les schémas d’événements
3. **Groupez les appels côté serveur**, Utilisez l’API batch pour les intégrations serveur afin de réduire le surcoût HTTP
4. **Mappez les traits explicitement**, Définissez les mappages trait-vers-attribut plutôt que de vous fier aux valeurs par défaut
5. **Utilisez Segment Functions**, Transformez les événements en vol avant qu’ils n’atteignent Brevo
6. **Surveillez la livraison d’événements**, Consultez le tableau de bord Event Delivery de Segment pour les événements échoués
7. **Configurez Replay**, Activez Segment Replay pour re-traiter les événements historiques

## Sécurité

- **Chiffrement TLS**, Toutes les données transmises via HTTPS/TLS 1.2+
- **Isolation des Write Keys**, Chaque source a son propre Write Key
- **Conformité RGPD**, Segment prend en charge les demandes de suppression et de suppression de données
- **SOC 2 Type II**, Segment est certifié SOC 2 Type II
- **Hébergement régional des données**, Option de workspace UE pour la conformité de résidence des données

## Ressources associées

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