---
title: "Conector de Twilio Segment"
description: "Guía completa de integración con Twilio Segment para sincronizar datos de clientes, eventos y segmentos de audiencia con Brevo a través de Tajo."
url: https://tajo.io/es/docs/connectors/custom/segment/
markdown: https://tajo.io/es/docs/connectors/custom/segment.md
lang: es-ES
robots: noindex
---

Solicita acceso anticipado

Escribe tu nombre y dirección de correo de trabajo. Te enviaremos un enlace para confirmar tu solicitud de acceso a Tajo.

# Conector de Twilio Segment

Estado del conector: Planificado Aún no está construido. Tajo no ejecuta este conector hoy.

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

Conecta Twilio Segment con Brevo a través de Tajo para unificar tu pipeline de datos de cliente, enrutar eventos desde cualquier fuente hacia Brevo y aprovechar la resolución de identidad de Segment para una automatización de marketing más rica.

## Resumen

| Propiedad | Valor |
| --- | --- |
| **Plataforma** | Twilio Segment |
| **Categoría** | Plataforma de datos (Personalizada) |
| **Complejidad de configuración** | Media |
| **Integración oficial** | No |
| **Datos sincronizados** | Eventos, Clientes, Traits, Audiencias |
| **Skills disponibles** | 8 |

## Funcionalidades

- **Recolección universal de datos** - Recopila eventos desde webs, apps móviles y servidores mediante los SDKs de Segment
- **Enrutamiento de fuentes** - Enruta datos desde más de 400 fuentes hacia Brevo a través de Tajo
- **Resolución de identidad** - Combina perfiles de usuarios anónimos y conocidos automáticamente
- **Sincronización de audiencias** - Envía traits y audiencias calculadas de Segment a listas de Brevo
- **Streaming de eventos** - Reenvío de eventos en tiempo real mediante el framework de Connections de Segment
- **Reverse ETL** - Sincroniza datos del warehouse de vuelta a Brevo con Segment Reverse ETL
- **Aplicación de esquemas** - Valida los esquemas de eventos con Segment Protocols antes de sincronizar

## Requisitos previos

Antes de empezar, asegúrate de tener:

1. Un workspace de Twilio Segment con una fuente configurada
2. Tu Segment Write Key de la fuente
3. Una cuenta de Brevo con acceso a la API
4. Una cuenta de Tajo con credenciales de API

## Autenticación

### Segment Write Key

Segment autentica las fuentes mediante una Write Key, un identificador único asociado a cada fuente.

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

### Token de API de Tajo

Configura el conector de Tajo con tus credenciales:

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

## Configuración

### Configuración 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
```

### Asignación de eventos

Asocia los eventos track de Segment con los tipos de evento de 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"
```

### Asignación de traits

Asocia los traits de identify de Segment con los atributos de contacto de Brevo:

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

## Endpoints de la API

| Método | Endpoint | Descripción |
| --- | --- | --- |
| `POST` | `/v1/identify` | Identificar a un usuario con traits |
| `POST` | `/v1/track` | Registrar un evento |
| `POST` | `/v1/page` | Registrar una vista de página |
| `POST` | `/v1/screen` | Registrar una vista de pantalla |
| `POST` | `/v1/group` | Asociar un usuario a un grupo |
| `POST` | `/v1/alias` | Fusionar dos identidades de usuario |
| `POST` | `/v1/batch` | Enviar varios mensajes en un lote |
| `POST` | `/v1/import` | Importación masiva de datos históricos |

## Ejemplos de código

### Inicializar Segment con el destino de 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'
});
```

### Registrar eventos a través de 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"
});
```

### Reenvío de eventos desde el 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();
```

## Límites de velocidad

| Nivel | Límite | Ventana |
| --- | --- | --- |
| **Free** | 1.000 eventos/s | Por fuente |
| **Team** | 10.000 eventos/s | Por fuente |
| **Business** | Personalizado | Por workspace |
| **Batch API** | 500 KB máx. | Por petición |
| **Tamaño máx. del lote** | 100 eventos | Por llamada batch |

Límites de tamaño del lote

Cada petición batch puede contener un máximo de 100 eventos y no debe superar 500 KB. Para importaciones históricas grandes, usa la Bulk Import API de Segment.

## Resolución de problemas

| Problema | Causa | Solución |
| --- | --- | --- |
| Los eventos no aparecen en Brevo | Destino no habilitado | Habilita el destino de Tajo en Segment |
| Los traits de usuario no se sincronizan | Falta el identificador de email | Asegúrate de incluir el trait `email` en las llamadas identify |
| Contactos duplicados | Varios anonymous IDs | Implementa llamadas `alias` adecuadas para fusionar identidades |
| Eventos con retraso | Cola con alto volumen | Revisa el panel de entrega de eventos de Segment |
| Violaciones de esquema | Eventos no planificados | Revisa el plan de tracking de Segment Protocols |
| Errores 429 de rate limit | Demasiadas peticiones | Aplica batching o reduce la frecuencia de eventos |

## Buenas prácticas

1. **Llama a identify antes de track** - Llama siempre a `identify` antes de `track` para que los eventos se atribuyan al usuario correcto
2. **Implementa un tracking plan** - Usa Segment Protocols para aplicar los esquemas de eventos
3. **Agrupa las llamadas del servidor** - Usa la API batch en integraciones de servidor para reducir la sobrecarga HTTP
4. **Asigna traits de forma explícita** - Define asignaciones de trait a atributo en lugar de depender de los valores por defecto
5. **Usa Segment Functions** - Transforma los eventos al vuelo antes de que lleguen a Brevo
6. **Monitoriza la entrega de eventos** - Revisa el panel de Event Delivery de Segment en busca de eventos fallidos
7. **Configura Replay** - Activa Segment Replay para reprocesar eventos históricos

## Seguridad

- **Cifrado TLS** - Todos los datos se transmiten por HTTPS/TLS 1.2+
- **Aislamiento de Write Keys** - Cada fuente tiene su propia Write Key
- **Cumplimiento de RGPD** - Segment admite solicitudes de eliminación y supresión de datos
- **SOC 2 Type II** - Segment cuenta con certificación SOC 2 Type II
- **Alojamiento regional de datos** - Opción de workspace en la UE para cumplimiento de residencia de datos

## Recursos relacionados

- [Conector de Amplitude](https://tajo.io/es/docs/connectors/custom/amplitude)
- [Conector de Mixpanel](https://tajo.io/es/docs/connectors/custom/mixpanel)
- [Skill de sincronización de clientes](https://tajo.io/es/docs/skills/data-sync/customer-sync)
- [API de eventos de Brevo](https://tajo.io/es/docs/events-engagement/create-event)