---
title: "Connecteur Braze"
description: "Guide complet d'intégration Braze pour synchroniser les données d'engagement client, campagnes et événements de messagerie avec Brevo via Tajo."
url: https://tajo.io/fr/docs/connectors/marketing/braze/
markdown: https://tajo.io/fr/docs/connectors/marketing/braze.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 Braze

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 votre plateforme d’engagement Braze à Brevo pour des profils clients unifiés, l’orchestration de campagnes cross-canal et des analyses marketing consolidées.

## Vue d’ensemble

| Propriété | Valeur |
| --- | --- |
| **Plateforme** | Braze |
| **Catégorie** | Marketing |
| **Complexité d’installation** | Modérée |
| **Intégration officielle** | Non |
| **Données synchronisées** | Clients, événements, campagnes, messages |
| **Type d’API** | REST API |
| **Authentification** | Clé API |
| **URL de base** | `https://rest.iad-XX.braze.com` (spécifique à l’instance) |

## Fonctionnalités

- **Synchronisation des profils utilisateurs**, Synchronisation bidirectionnelle des attributs client entre Braze et Brevo
- **Suivi des événements de campagne**, Suivez les ouvertures d’e-mails, clics, conversions et désabonnements
- **Données de flux Canvas**, Synchronisez les données de parcours de campagne multi-étapes pour un reporting unifié
- **Miroir de segments**, Répliquez les segments Braze en listes Brevo pour un ciblage cross-plateforme
- **Événements de notifications push**, Transmettez les données d’engagement push vers les timelines de contact Brevo
- **Synchronisation de catalogue**, Synchronisez les catalogues de produits pour des recommandations personnalisées

## Prérequis

Avant de commencer, assurez-vous de disposer de :

1. Un compte Braze avec accès API activé
2. Une clé Braze REST API avec les permissions appropriées
3. L’URL de votre instance Braze (par exemple, `rest.iad-01.braze.com`)
4. Un compte Brevo avec accès API
5. Un compte Tajo avec un abonnement actif

## Authentification

Braze utilise l’authentification par clé API. Chaque clé API peut être délimitée à des endpoints spécifiques.

### Créer une clé API

1. Connectez-vous à votre tableau de bord Braze
2. Accédez à **Settings** > **API Keys**
3. Cliquez sur **Create New API Key**
4. Nommez-la « Tajo Integration »
5. Activez les permissions suivantes :

```
users.track
users.export.ids
users.export.segment
campaigns.list
campaigns.data_series
canvas.list
canvas.data_series
segments.list
segments.data_series
email.status
subscription.status.set
catalogs.list_items
```

Sécurité de la clé API

Stockez votre clé API Braze de façon sécurisée. Ne l’exposez jamais dans du code côté client ni dans des dépôts publics. Tajo chiffre toutes les informations d’authentification API au repos avec AES-256.

### Connexion à Tajo

```bash
tajo connectors install braze \
  --api-key $BRAZE_API_KEY \
  --instance-url rest.iad-01.braze.com
```

## Configuration

### Configuration de base

```yaml
connectors:
  braze:
    enabled: true
    instance_url: "rest.iad-01.braze.com"
    api_version: "v1"

    sync:
      users: true
      campaigns: true
      canvases: true
      segments: true
      events: true

    lists:
      engaged_users: 10
      dormant_users: 11
```

### Mappage des champs

Mappez les attributs utilisateur Braze vers les attributs de contact Brevo :

```yaml
field_mapping:
  # Standard fields
  external_id: BRAZE_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Engagement metrics
  total_revenue: TOTAL_REVENUE
  push_opted_in: PUSH_OPTIN
  email_subscribe: EMAIL_STATUS

  # Custom attributes
  loyalty_points: LOYALTY_POINTS
  last_app_version: APP_VERSION
  preferred_language: LANGUAGE
```

## Endpoints API

Tajo s’intègre avec les endpoints Braze REST API suivants :

| Endpoint | Méthode | Objectif |
| --- | --- | --- |
| `/users/track` | POST | Envoyer attributs utilisateur, événements et achats |
| `/users/export/ids` | POST | Exporter les profils utilisateur par IDs externes |
| `/users/export/segment` | POST | Exporter les utilisateurs d’un segment |
| `/campaigns/list` | GET | Récupérer la liste des campagnes |
| `/campaigns/data_series` | GET | Analytics de campagne dans le temps |
| `/canvas/list` | GET | Récupérer la liste des flux Canvas |
| `/canvas/data_series` | GET | Analytics Canvas dans le temps |
| `/segments/list` | GET | Récupérer la liste des segments |
| `/email/status` | POST | Modifier le statut d’abonnement e-mail |
| `/subscription/status/set` | POST | Définir le statut du groupe d’abonnement |
| `/catalogs/{catalog_name}/items` | GET | Récupérer les éléments de catalogue |

## Exemples de code

### Initialiser le connecteur

```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('braze', {
  apiKey: process.env.BRAZE_API_KEY,
  instanceUrl: 'rest.iad-01.braze.com'
});
```

### Synchroniser les profils utilisateurs

```javascript
// Sync Braze users to Brevo contacts
await tajo.connectors.sync('braze', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01',
  batchSize: 50
});

// Check sync status
const status = await tajo.connectors.status('braze');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T10:30:00Z',
//   usersCount: 45200,
//   campaignsTracked: 28,
//   eventsProcessed: 125000
// }
```

### Suivre des événements personnalisés

```javascript
// Forward Braze events to Brevo
await tajo.connectors.handleEvent('braze', {
  type: 'user.event',
  payload: {
    external_id: 'user_12345',
    name: 'product_viewed',
    properties: {
      product_id: 'SKU-789',
      category: 'electronics',
      price: 299.99
    }
  }
});
```

### Exporter les données d’un segment

```javascript
// Export a Braze segment and create a Brevo list
const result = await tajo.connectors.exportSegment('braze', {
  segmentId: 'segment_abc123',
  targetList: 15,
  includeAttributes: ['email', 'first_name', 'last_name', 'total_revenue']
});

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

## Limites de débit

Braze applique des limites de débit basées sur votre plan et votre instance :

| Plan | Limite de débit | Limite en rafale |
| --- | --- | --- |
| **Starter** | 250 000 requêtes/heure | N/A |
| **Pro** | 250 000 requêtes/heure | N/A |
| **Enterprise** | Personnalisée | Personnalisée |

L’endpoint `/users/track` a une limite par défaut de 50 000 requêtes par minute. Tajo gère automatiquement les limites de débit avec un backoff exponentiel.

Requêtes par lot

Tajo regroupe jusqu’à 75 attributs utilisateur, 75 événements et 75 achats par requête `/users/track` afin de maximiser le débit dans les limites de taux.

## Dépannage

### Problèmes courants

| Problème | Cause | Solution |
| --- | --- | --- |
| 401 Unauthorized | Clé API invalide ou expirée | Régénérez la clé API dans le tableau de bord Braze |
| Utilisateurs non synchronisés | URL d’instance incorrecte | Vérifiez l’URL de votre instance Braze (par exemple, iad-01, iad-02) |
| Attributs manquants | Scope de clé API trop restreint | Ajoutez les permissions requises à la clé API |
| Limite de débit dépassée | Trop de requêtes simultanées | Réduisez la taille du lot ou la fréquence de synchronisation |
| Événements retardés | File d’export volumineuse | Utilisez la synchronisation incrémentale au lieu de l’export complet |

### Mode débogage

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

### Tester la connexion

```bash
tajo connectors test braze
# ✓ API connection successful
# ✓ User export accessible
# ✓ Campaign data readable
# ✓ Segment list accessible
# ✓ Event tracking operational
```

## Bonnes pratiques

1. **Utilisez les synchronisations incrémentales**, Évitez les exports complets ; synchronisez uniquement les enregistrements modifiés depuis la dernière synchronisation
2. **Regroupez les mises à jour utilisateur**, Groupez les changements d’attributs pour minimiser les appels API
3. **Délimitez les clés API de façon restrictive**, N’activez que les permissions dont votre intégration a besoin
4. **Surveillez les limites de débit**, Configurez des alertes avant d’atteindre les limites de débit Braze
5. **Mappez les IDs externes de manière cohérente**, Utilisez le même identifiant sur Braze et Brevo
6. **Testez d’abord en sandbox**, Utilisez un workspace de test Braze avant le déploiement en production

## Sécurité

- **Authentification par clé API**, Clés API délimitées avec permissions granulaires
- **HTTPS uniquement**, Toutes les communications API chiffrées via TLS 1.2+
- **Whitelisting d’IP**, Restriction d’IP optionnelle pour l’accès API dans Braze
- **Stockage chiffré**, Identifiants API chiffrés au repos dans Tajo
- **Journalisation d’audit**, Tous les appels API journalisés pour la revue de conformité

## Ressources associées

- [Connecteur Customer.io](https://tajo.io/fr/docs/connectors/marketing/customerio)
- [Connecteur Iterable](https://tajo.io/fr/docs/connectors/marketing/iterable)
- [Skill Customer Sync](https://tajo.io/fr/docs/skills/data-sync/customer-sync)
- [API Contacts Brevo](https://tajo.io/fr/docs/contact-management)