---
title: "Connettore Braze"
description: "Guida completa all'integrazione di Braze per sincronizzare dati di engagement clienti, campagne ed eventi di messaggistica con Brevo tramite Tajo."
url: https://tajo.io/it/docs/connectors/marketing/braze/
markdown: https://tajo.io/it/docs/connectors/marketing/braze.md
lang: it-IT
robots: noindex
---

Richiedi l’accesso anticipato

Inserisci il tuo nome e indirizzo email aziendale. Ti invieremo un link per confermare la richiesta di accesso a Tajo.

# Connettore Braze

Stato del connettore: Pianificato Non ancora realizzato. Oggi Tajo non esegue questo connettore.

| Campo di origine | Campo di destinazione | Valore di esempio |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Collega la tua piattaforma di engagement Braze a Brevo per profili cliente unificati, orchestrazione di campagne cross-channel e analytics di marketing consolidate.

## Panoramica

| Proprietà | Valore |
| --- | --- |
| **Piattaforma** | Braze |
| **Categoria** | Marketing |
| **Complessità di setup** | Moderata |
| **Integrazione ufficiale** | No |
| **Dati sincronizzati** | Clienti, Eventi, Campagne, Messaggi |
| **Tipo API** | REST API |
| **Autenticazione** | Chiave API |
| **Base URL** | `https://rest.iad-XX.braze.com` (specifica per istanza) |

## Funzionalità

- **Sync dei profili utente** - Sincronizzazione bidirezionale degli attributi cliente tra Braze e Brevo
- **Tracciamento eventi di campagna** - Traccia aperture email, click, conversioni e disiscrizioni
- **Dati flusso Canvas** - Sincronizza i dati del journey delle campagne multi-step per una reportistica unificata
- **Mirroring dei segmenti** - Replica i segmenti Braze come liste Brevo per il targeting cross-platform
- **Eventi push notification** - Inoltra i dati di engagement push alle timeline dei contatti Brevo
- **Sync del catalogo** - Sincronizza i cataloghi prodotti per raccomandazioni personalizzate

## Prerequisiti

Prima di iniziare, assicurati di avere:

1. Un account Braze con accesso API abilitato
2. Una chiave REST API Braze con i permessi appropriati
3. L’URL della tua istanza Braze (es. `rest.iad-01.braze.com`)
4. Un account Brevo con accesso API
5. Un account Tajo con un abbonamento attivo

## Autenticazione

Braze utilizza l’autenticazione con chiave API. Ogni chiave API può essere assegnata a specifici endpoint.

### Creazione di una chiave API

1. Accedi alla tua dashboard Braze
2. Vai in **Settings** > **API Keys**
3. Clicca su **Create New API Key**
4. Nominala “Tajo Integration”
5. Abilita i seguenti permessi:

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

Sicurezza della chiave API

Conserva la tua chiave API Braze in modo sicuro. Non esporla mai in codice client-side o repository pubblici. Tajo cifra tutte le credenziali API a riposo usando AES-256.

### Connessione a Tajo

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

## Configurazione

### Setup di 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
```

### Mappatura dei campi

Mappa gli attributi utente Braze agli attributi di contatto 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
```

## Endpoint API

Tajo si integra con i seguenti endpoint REST API di Braze:

| Endpoint | Metodo | Scopo |
| --- | --- | --- |
| `/users/track` | POST | Invia attributi utente, eventi e acquisti |
| `/users/export/ids` | POST | Esporta i profili utente per ID esterni |
| `/users/export/segment` | POST | Esporta gli utenti da un segmento |
| `/campaigns/list` | GET | Recupera l’elenco delle campagne |
| `/campaigns/data_series` | GET | Analytics delle campagne nel tempo |
| `/canvas/list` | GET | Recupera l’elenco dei flussi Canvas |
| `/canvas/data_series` | GET | Analytics di Canvas nel tempo |
| `/segments/list` | GET | Recupera l’elenco dei segmenti |
| `/email/status` | POST | Modifica lo stato dell’iscrizione email |
| `/subscription/status/set` | POST | Imposta lo stato del gruppo di iscrizione |
| `/catalogs/{catalog_name}/items` | GET | Recupera gli elementi del catalogo |

## Esempi di codice

### Inizializza il connettore

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

### Sincronizza i profili utente

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

### Traccia eventi personalizzati

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

### Esporta i dati di un segmento

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

## Limiti di velocità

Braze applica limiti di velocità in base al tuo piano e alla tua istanza:

| Piano | Limite | Burst Limit |
| --- | --- | --- |
| **Starter** | 250.000 richieste/ora | N/D |
| **Pro** | 250.000 richieste/ora | N/D |
| **Enterprise** | Personalizzato | Personalizzato |

L’endpoint `/users/track` ha un limite predefinito di 50.000 richieste al minuto. Tajo gestisce automaticamente la limitazione di velocità con backoff esponenziale.

Richieste in batch

Tajo raggruppa fino a 75 attributi utente, 75 eventi e 75 acquisti per richiesta `/users/track` per massimizzare il throughput entro i limiti di velocità.

## Risoluzione dei problemi

### Problemi comuni

| Problema | Causa | Soluzione |
| --- | --- | --- |
| 401 Unauthorized | Chiave API non valida o scaduta | Rigenera la chiave API nella dashboard Braze |
| Utenti non sincronizzati | URL dell’istanza errato | Verifica l’URL della tua istanza Braze (es. iad-01, iad-02) |
| Attributi mancanti | Scope della chiave API troppo ristretto | Aggiungi i permessi richiesti alla chiave API |
| Limite di velocità superato | Troppe richieste concorrenti | Riduci la dimensione del batch o la frequenza di sync |
| Eventi in ritardo | Coda di esportazione grande | Usa la sync incrementale invece dell’export completo |

### Modalità debug

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

### Testa la connessione

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

## Best practice

1. **Usa sync incrementali** - Evita le esportazioni complete; sincronizza solo i record modificati dall’ultima sync
2. **Aggiorna gli utenti in batch** - Raggruppa le modifiche agli attributi per minimizzare le chiamate API
3. **Limita lo scope delle chiavi API** - Abilita solo i permessi necessari alla tua integrazione
4. **Monitora i limiti di velocità** - Imposta avvisi prima di raggiungere i limiti di velocità di Braze
5. **Mappa gli ID esterni in modo coerente** - Usa lo stesso identificatore tra Braze e Brevo
6. **Testa prima in sandbox** - Usa un workspace di test Braze prima del deploy in produzione

## Sicurezza

- **Autenticazione con chiave API** - Chiavi API con scope e permessi granulari
- **Solo HTTPS** - Tutte le comunicazioni API cifrate via TLS 1.2+
- **IP Allowlisting** - Restrizione IP opzionale per l’accesso API in Braze
- **Storage cifrato** - Credenziali API cifrate a riposo in Tajo
- **Audit logging** - Tutte le chiamate API loggate per la revisione di compliance

## Risorse correlate

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