---
title: "Braze-connector"
description: "Volledige Braze-integratiegids voor het synchroniseren van klant-engagementdata, campagnes en messaging-events met Brevo via Tajo."
url: https://tajo.io/nl/docs/connectors/marketing/braze/
markdown: https://tajo.io/nl/docs/connectors/marketing/braze.md
lang: nl-NL
robots: noindex
---

Vraag vroegtijdige toegang aan

Vul je voornaam en je zakelijke e-mailadres in. We sturen je een link om je aanvraag voor toegang tot Tajo te bevestigen.

# Braze-connector

Connectorstatus: Gepland Nog niet gebouwd. Tajo draait deze connector vandaag niet.

| Bronveld | Doelveld | Voorbeeldwaarde |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Verbind je Braze-engagementplatform met Brevo voor uniforme klantprofielen, cross-channel-campagneorkestratie en geconsolideerde marketinganalytics.

## Overzicht

| Eigenschap | Waarde |
| --- | --- |
| **Platform** | Braze |
| **Categorie** | Marketing |
| **Setupcomplexiteit** | Gemiddeld |
| **Officiële integratie** | Nee |
| **Gesynchroniseerde data** | Klanten, Events, Campagnes, Berichten |
| **API-type** | REST API |
| **Authenticatie** | API-sleutel |
| **Base URL** | `https://rest.iad-XX.braze.com` (instantiespecifiek) |

## Functies

- **Gebruikersprofielsync** - Bidirectionele synchronisatie van klantattributen tussen Braze en Brevo
- **Campagne-event-tracking** - Track e-mailopens, clicks, conversies en uitschrijvingen
- **Canvas-flowdata** - Synchroniseer multi-step-campagne-journeydata voor uniforme rapportage
- **Segmentmirror** - Repliceer Braze-segmenten als Brevo-lijsten voor cross-platform-targeting
- **Pushnotificatie-events** - Stuur push-engagementdata door naar Brevo-contact-timelines
- **Catalogussync** - Synchroniseer productcatalogi voor gepersonaliseerde aanbevelingen

## Vereisten

Voordat je begint, zorg dat je beschikt over:

1. Een Braze-account met ingeschakelde API-toegang
2. Een Braze REST API-sleutel met de juiste rechten
3. Je Braze-instantie-URL (bijv. `rest.iad-01.braze.com`)
4. Een Brevo-account met API-toegang
5. Een Tajo-account met een actief abonnement

## Authenticatie

Braze gebruikt API-sleutelauthenticatie. Elke API-sleutel kan worden gescope op specifieke endpoints.

### Een API-sleutel aanmaken

1. Log in op je Braze-dashboard
2. Ga naar **Settings** > **API Keys**
3. Klik op **Create New API Key**
4. Noem hem “Tajo Integration”
5. Activeer de volgende rechten:

```
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
```

Beveiliging API-sleutel

Sla je Braze API-sleutel veilig op. Plaats hem nooit in client-side code of openbare repositories. Tajo versleutelt alle API-inloggegevens in rust met AES-256.

### Verbinden met Tajo

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

## Configuratie

### Basisopzet

```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
```

### Veldmapping

Koppel Braze-gebruikersattributen aan Brevo-contactattributen:

```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
```

## API-endpoints

Tajo integreert met de volgende Braze REST API-endpoints:

| Endpoint | Methode | Doel |
| --- | --- | --- |
| `/users/track` | POST | Stuur gebruikersattributen, events en aankopen |
| `/users/export/ids` | POST | Exporteer gebruikersprofielen op externe ID’s |
| `/users/export/segment` | POST | Exporteer gebruikers uit een segment |
| `/campaigns/list` | GET | Lijst met campagnes ophalen |
| `/campaigns/data_series` | GET | Campagne-analytics over tijd |
| `/canvas/list` | GET | Lijst met Canvas-flows ophalen |
| `/canvas/data_series` | GET | Canvas-analytics over tijd |
| `/segments/list` | GET | Lijst met segmenten ophalen |
| `/email/status` | POST | E-mail-abonnementsstatus wijzigen |
| `/subscription/status/set` | POST | Abonnementsgroep-status instellen |
| `/catalogs/{catalog_name}/items` | GET | Catalogusitems ophalen |

## Codevoorbeelden

### Connector initialiseren

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

### Gebruikersprofielen synchroniseren

```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
// }
```

### Custom events tracken

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

### Segmentdata exporteren

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

## Ratelimits

Braze hanteert ratelimits op basis van je plan en instantie:

| Plan | Ratelimit | Burst-limiet |
| --- | --- | --- |
| **Starter** | 250.000 requests/uur | N.v.t. |
| **Pro** | 250.000 requests/uur | N.v.t. |
| **Enterprise** | Custom | Custom |

Het `/users/track`-endpoint heeft een standaardlimiet van 50.000 requests per minuut. Tajo regelt rate-limiting automatisch met exponentiële backoff.

Batch-requests

Tajo batcht tot 75 gebruikersattributen, 75 events en 75 aankopen per `/users/track`-request om de doorvoer binnen ratelimits te maximaliseren.

## Probleemoplossing

### Veelvoorkomende problemen

| Probleem | Oorzaak | Oplossing |
| --- | --- | --- |
| 401 Unauthorized | Ongeldige of verlopen API-sleutel | Genereer de API-sleutel opnieuw in het Braze-dashboard |
| Gebruikers synchroniseren niet | Verkeerde instantie-URL | Verifieer je Braze-instantie-URL (bijv. iad-01, iad-02) |
| Attributen ontbreken | API-sleutel-scope te beperkt | Voeg de vereiste rechten toe aan de API-sleutel |
| Ratelimit overschreden | Te veel gelijktijdige requests | Verklein batchgrootte of sync-frequentie |
| Events vertraagd | Grote export-queue | Gebruik incremental sync in plaats van volledige export |

### Debugmodus

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

### Verbinding testen

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

## Best practices

1. **Gebruik incremental syncs** - Vermijd volledige exports; synchroniseer alleen records die sinds de laatste sync zijn gewijzigd
2. **Batch gebruikersupdates** - Groepeer attribuutwijzigingen om API-calls te minimaliseren
3. **Scope API-sleutels strak** - Activeer alleen de rechten die je integratie nodig heeft
4. **Monitor ratelimits** - Stel alerts in vóór je Braze-ratelimits raakt
5. **Koppel externe ID’s consistent** - Gebruik dezelfde identifier in Braze en Brevo
6. **Test eerst in sandbox** - Gebruik een Braze-testworkspace vóór productiedeployment

## Beveiliging

- **API-sleutel-authenticatie** - Gescopede API-sleutels met granulaire rechten
- **Alleen HTTPS** - Alle API-communicatie versleuteld via TLS 1.2+
- **IP-allowlisting** - Optionele IP-beperking voor API-toegang in Braze
- **Versleutelde opslag** - API-inloggegevens versleuteld opgeslagen in Tajo
- **Audit-logging** - Alle API-calls gelogd voor compliancereview

## Gerelateerde resources

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