---
title: "Conector Twilio Segment"
description: "Guia completo de integração do Twilio Segment para sincronizar dados de clientes, eventos e segmentos de audiência com o Brevo através do Tajo."
url: https://tajo.io/pt/docs/connectors/custom/segment/
markdown: https://tajo.io/pt/docs/connectors/custom/segment.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 Twilio Segment

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 o Twilio Segment ao Brevo através do Tajo para unificar seu pipeline de dados de clientes, rotear eventos de qualquer origem para o Brevo e aproveitar a resolução de identidade do Segment para uma automação de marketing mais rica.

## Visão geral

| Propriedade | Valor |
| --- | --- |
| **Plataforma** | Twilio Segment |
| **Categoria** | Plataforma de Dados (Personalizado) |
| **Complexidade de configuração** | Média |
| **Integração oficial** | Não |
| **Dados sincronizados** | Eventos, Clientes, Traits, Audiências |
| **Skills disponíveis** | 8 |

## Recursos

- **Coleta universal de dados** - Colete eventos de sites, apps móveis e servidores via SDKs do Segment
- **Roteamento de fontes** - Roteie dados de mais de 400 fontes para o Brevo através do Tajo
- **Resolução de identidade** - Mescle perfis de usuários anônimos e conhecidos automaticamente
- **Sincronização de audiências** - Envie traits e audiências computadas do Segment para listas do Brevo
- **Streaming de eventos** - Encaminhamento de eventos em tempo real via framework Connections do Segment
- **Reverse ETL** - Sincronize dados do warehouse de volta ao Brevo usando o Segment Reverse ETL
- **Aplicação de schema** - Valide schemas de eventos com Segment Protocols antes de sincronizar

## Pré-requisitos

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

1. Um workspace Twilio Segment com uma fonte configurada
2. Sua Write Key do Segment para a fonte
3. Uma conta Brevo com acesso à API
4. Uma conta Tajo com credenciais da API

## Autenticação

### Write Key do Segment

O Segment autentica fontes usando uma Write Key, que é um identificador único vinculado a cada fonte.

```javascript
// Analytics.js initialization with Write Key
analytics.load("YOUR_SEGMENT_WRITE_KEY");
```

### Token da API Tajo

Configure o conector Tajo com suas credenciais:

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

## Configuração

### Configuração básica

```yaml
connectors:
  segment:
    enabled: true
    write_key: "your-segment-write-key"
    data_region: "us"  # or "eu" for EU workspace

    # Data sync options
    sync:
      identify: true
      track: true
      page: true
      group: false

    # Brevo list assignment
    lists:
      all_contacts: 5
      active_users: 6
      high_value: 7
```

### Mapeamento de eventos

Mapeie eventos track do Segment para tipos de evento do Brevo:

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

  # Custom events
  "Feature Used": "feature_used"
  "Plan Upgraded": "plan_upgraded"
```

### Mapeamento de traits

Mapeie traits de identify do Segment para atributos de contato do Brevo:

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

## Endpoints da API

| Método | Endpoint | Descrição |
| --- | --- | --- |
| `POST` | `/v1/identify` | Identificar um usuário com traits |
| `POST` | `/v1/track` | Rastrear um evento |
| `POST` | `/v1/page` | Registrar uma visualização de página |
| `POST` | `/v1/screen` | Registrar uma visualização de tela |
| `POST` | `/v1/group` | Associar um usuário a um grupo |
| `POST` | `/v1/alias` | Mesclar duas identidades de usuário |
| `POST` | `/v1/batch` | Enviar múltiplas mensagens em um lote |
| `POST` | `/v1/import` | Importação em massa de dados históricos |

## Exemplos de código

### Inicializar Segment com destino Tajo

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

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

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

### Rastrear eventos via Segment

```javascript
// Identify a user - syncs to Brevo contacts
analytics.identify("user_123", {
  email: "jane@example.com",
  firstName: "Jane",
  lastName: "Kim",
  plan: "premium",
  lifetimeValue: 450.00
});

// Track an event - forwards to Brevo
analytics.track("Order Completed", {
  orderId: "ORD-1234",
  revenue: 89.99,
  currency: "USD",
  products: [
    { id: "SKU-001", name: "Widget", price: 89.99 }
  ]
});

// Page view tracking
analytics.page("Pricing", {
  title: "Pricing - Tajo",
  url: "https://tajo.io/pricing"
});
```

### Encaminhamento de eventos do lado do servidor (Node.js)

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

// Batch identify users from your database
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
    }
  });
}

// Flush the queue
await analytics.flush();
```

## Limites de taxa

| Plano | Limite | Janela |
| --- | --- | --- |
| **Free** | 1.000 eventos/seg | Por fonte |
| **Team** | 10.000 eventos/seg | Por fonte |
| **Business** | Personalizado | Por workspace |
| **Batch API** | 500 KB máx | Por requisição |
| **Tamanho máximo do lote** | 100 eventos | Por chamada em lote |

Limites de tamanho do lote

Cada requisição em lote pode conter no máximo 100 eventos e não deve exceder 500 KB. Para importações históricas grandes, use a Segment Bulk Import API.

## Solução de problemas

| Problema | Causa | Solução |
| --- | --- | --- |
| Eventos não aparecem no Brevo | Destino não habilitado | Habilite o destino Tajo no Segment |
| Traits de usuário não sincronizam | Identificador de e-mail ausente | Certifique-se de que o trait `email` está incluído nas chamadas de identify |
| Contatos duplicados | Múltiplos IDs anônimos | Implemente chamadas `alias` adequadas para mesclagem de identidade |
| Eventos atrasados | Fila de alto volume | Verifique o dashboard de entrega de eventos do Segment |
| Violações de schema | Eventos não planejados | Revise o plano de rastreamento do Segment Protocols |
| Erros de limite de taxa 429 | Muitas requisições | Implemente batching ou reduza a frequência de eventos |

## Melhores práticas

1. **Use identify antes de track** - Sempre chame `identify` antes de `track` para garantir que eventos sejam atribuídos ao usuário correto
2. **Implemente um plano de rastreamento** - Use Segment Protocols para aplicar schemas de eventos
3. **Agrupe chamadas do lado do servidor em lotes** - Use a batch API para integrações do lado do servidor para reduzir sobrecarga HTTP
4. **Mapeie traits explicitamente** - Defina mapeamentos de trait-para-atributo em vez de depender de padrões
5. **Use Segment Functions** - Transforme eventos em trânsito antes que cheguem ao Brevo
6. **Monitore a entrega de eventos** - Verifique o dashboard de Event Delivery do Segment para eventos falhos
7. **Configure Replay** - Habilite o Segment Replay para reprocessamento de eventos históricos

## Segurança

- **Criptografia TLS** - Todos os dados transmitidos via HTTPS/TLS 1.2+
- **Isolamento de Write Key** - Cada fonte tem sua própria Write Key
- **Conformidade com GDPR** - Segment suporta solicitações de exclusão e supressão de dados
- **SOC 2 Type II** - Segment é certificado SOC 2 Type II
- **Hospedagem regional de dados** - Opção de workspace na UE para conformidade com residência de dados

## Recursos relacionados

- [Conector Amplitude](https://tajo.io/pt/docs/connectors/custom/amplitude)
- [Conector Mixpanel](https://tajo.io/pt/docs/connectors/custom/mixpanel)
- [Skill de sincronização de clientes](https://tajo.io/pt/docs/skills/data-sync/customer-sync)
- [API de eventos do Brevo](https://tajo.io/pt/docs/events-engagement/create-event)