---
title: "Conector Braze"
description: "Guia completo de integração do Braze para sincronizar dados de engajamento de clientes, campanhas e eventos de mensageria com o Brevo via Tajo."
url: https://tajo.io/pt/docs/connectors/marketing/braze/
markdown: https://tajo.io/pt/docs/connectors/marketing/braze.md
lang: pt-BR
robots: noindex
---

Solicite acesso antecipado

Indique o seu nome e endereço de e-mail profissional. Enviaremos um link para confirmar o seu pedido de acesso ao Tajo.

# Conector Braze

Status do conector: Planejado Ainda não construído. O Tajo não executa este conector hoje.

| Campo de origem | Campo de destino | Valor de exemplo |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Conecte sua plataforma de engajamento Braze ao Brevo para perfis de cliente unificados, orquestração de campanhas multicanal e analytics de marketing consolidados.

## Visão geral

| Propriedade | Valor |
| --- | --- |
| **Plataforma** | Braze |
| **Categoria** | Marketing |
| **Complexidade de configuração** | Moderada |
| **Integração oficial** | Não |
| **Dados sincronizados** | Clientes, Eventos, Campanhas, Mensagens |
| **Tipo de API** | REST API |
| **Autenticação** | Chave API |
| **URL base** | `https://rest.iad-XX.braze.com` (específica da instância) |

## Recursos

- **Sincronização de perfis de usuário** - Sincronização bidirecional de atributos de cliente entre Braze e Brevo
- **Rastreamento de eventos de campanha** - Rastreie aberturas, cliques, conversões e descadastros de e-mails
- **Dados de fluxo Canvas** - Sincronize dados de jornada de campanha em múltiplas etapas para relatórios unificados
- **Espelhamento de segmentos** - Replique segmentos do Braze como listas do Brevo para targeting multiplataforma
- **Eventos de push notification** - Encaminhe dados de engajamento de push para as timelines de contato do Brevo
- **Sincronização de catálogo** - Sincronize catálogos de produtos para recomendações personalizadas

## Pré-requisitos

Antes de começar, certifique-se de ter:

1. Uma conta Braze com acesso à API habilitado
2. Uma chave REST API do Braze com as permissões apropriadas
3. A URL da sua instância Braze (por exemplo, `rest.iad-01.braze.com`)
4. Uma conta Brevo com acesso à API
5. Uma conta Tajo com assinatura ativa

## Autenticação

O Braze usa autenticação por chave API. Cada chave API pode ter escopo para endpoints específicos.

### Criar uma chave API

1. Faça login no seu dashboard Braze
2. Navegue até **Settings** > **API Keys**
3. Clique em **Create New API Key**
4. Nomeie-a como “Tajo Integration”
5. Habilite as seguintes permissões:

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

Segurança da chave API

Armazene sua chave API do Braze com segurança. Nunca exponha em código client-side ou repositórios públicos. O Tajo criptografa todas as credenciais API em repouso usando AES-256.

### Conectando ao Tajo

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

## Configuração

### Configuração básica

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

### Mapeamento de campos

Mapeie atributos de usuário do Braze para atributos de contato do 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 da API

O Tajo integra-se com os seguintes endpoints da REST API do Braze:

| Endpoint | Método | Finalidade |
| --- | --- | --- |
| `/users/track` | POST | Enviar atributos, eventos e compras de usuário |
| `/users/export/ids` | POST | Exportar perfis de usuário por IDs externos |
| `/users/export/segment` | POST | Exportar usuários de um segmento |
| `/campaigns/list` | GET | Recuperar lista de campanhas |
| `/campaigns/data_series` | GET | Analytics de campanha ao longo do tempo |
| `/canvas/list` | GET | Recuperar lista de fluxos Canvas |
| `/canvas/data_series` | GET | Analytics de Canvas ao longo do tempo |
| `/segments/list` | GET | Recuperar lista de segmentos |
| `/email/status` | POST | Alterar status de inscrição de e-mail |
| `/subscription/status/set` | POST | Definir status de grupo de inscrição |
| `/catalogs/{catalog_name}/items` | GET | Recuperar itens do catálogo |

## Exemplos de código

### Inicializar o conector

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

### Sincronizar perfis de usuário

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

### Rastrear eventos personalizados

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

### Exportar dados de 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`);
```

## Limites de taxa

O Braze aplica limites de taxa baseados no seu plano e instância:

| Plano | Limite de taxa | Limite de burst |
| --- | --- | --- |
| **Starter** | 250.000 requisições/hora | N/A |
| **Pro** | 250.000 requisições/hora | N/A |
| **Enterprise** | Personalizado | Personalizado |

O endpoint `/users/track` tem um limite padrão de 50.000 requisições por minuto. O Tajo trata automaticamente o rate limiting com backoff exponencial.

Requisições em lote

O Tajo agrupa em lote até 75 atributos de usuário, 75 eventos e 75 compras por requisição `/users/track` para maximizar a taxa de transferência dentro dos limites.

## Solução de problemas

### Problemas comuns

| Problema | Causa | Solução |
| --- | --- | --- |
| 401 Unauthorized | Chave API inválida ou expirada | Regere a chave API no dashboard do Braze |
| Usuários não sincronizando | URL de instância incorreta | Verifique a URL da sua instância Braze (por exemplo, iad-01, iad-02) |
| Atributos ausentes | Escopo da chave API muito restrito | Adicione as permissões necessárias à chave API |
| Limite de taxa excedido | Muitas requisições concorrentes | Reduza o tamanho do lote ou a frequência de sincronização |
| Eventos atrasados | Fila de exportação grande | Use sincronização incremental em vez de exportação completa |

### Modo de depuração

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

### Testar conexão

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

## Melhores práticas

1. **Use sincronizações incrementais** - Evite exportações completas; sincronize apenas registros alterados desde a última sincronização
2. **Agrupe atualizações de usuário em lote** - Agrupe alterações de atributo para minimizar chamadas de API
3. **Restrinja o escopo das chaves API** - Habilite apenas as permissões que sua integração precisa
4. **Monitore limites de taxa** - Configure alertas antes de atingir os limites de taxa do Braze
5. **Mapeie IDs externos de forma consistente** - Use o mesmo identificador entre Braze e Brevo
6. **Teste primeiro em sandbox** - Use um workspace de teste do Braze antes do deploy em produção

## Segurança

- **Autenticação por chave API** - Chaves API com escopo e permissões granulares
- **Somente HTTPS** - Toda comunicação com a API é criptografada via TLS 1.2+
- **Allowlisting de IP** - Restrição opcional de IP para acesso à API no Braze
- **Armazenamento criptografado** - Credenciais API criptografadas em repouso no Tajo
- **Log de auditoria** - Todas as chamadas de API registradas para revisão de conformidade

## Recursos relacionados

- [Conector Customer.io](https://tajo.io/pt/docs/connectors/marketing/customerio)
- [Conector Iterable](https://tajo.io/pt/docs/connectors/marketing/iterable)
- [Skill de sincronização de clientes](https://tajo.io/pt/docs/skills/data-sync/customer-sync)
- [API de contatos do Brevo](https://tajo.io/pt/docs/contact-management)