# Conexiones

> Conecte y sincronice sus herramientas. Gestione flujos de datos, destinos, transformaciones y seguimiento de eventos en tiempo real.

Source: https://docs.graph8.com/es/engage/connections/

Connections es el pipeline de datos de graph8. Recopila eventos de su sitio web, los transforma con funciones personalizadas y los enruta hacia destinos: webhooks, almacenes de datos, etiquetas JavaScript y conectores externos.

## Cómo funciona

Los eventos circulan por un pipeline sencillo:

1. **Streams** recopilan eventos de su sitio web o aplicación (vistas de página, envíos de formularios, eventos personalizados)
2. **Funciones** transforman o filtran los eventos en tránsito mediante JavaScript personalizado
3. **Destinos** reciben los eventos procesados (webhooks, almacén, etiquetas, conectores)
4. **Enlaces** definen qué streams se conectan con qué destinos, según reglas de enrutamiento

## Streams

Un stream es una fuente de datos, normalmente su sitio web. Cada stream tiene:

| Campo | Función |
|-------|---------|
| **Nombre** | Etiqueta para la fuente de datos (p. ej., "Sitio web", "Aplicación móvil") |
| **Dominios** | Dominios de origen permitidos para la validación CORS |
| **Browser key** | Clave de escritura pública para el SDK de JavaScript |
| **Server key** | Clave privada para el seguimiento de eventos en el servidor |

Al configurar graph8, se crea automáticamente un stream "Website" predeterminado con claves de navegador y de servidor.

### Tipos de eventos

Los streams aceptan tipos de eventos estándar:

| Evento | Qué registra |
|--------|-------------|
| **page** | Vistas de página con URL, referrer y metadatos de la página |
| **track** | Eventos personalizados (p. ej., clics en botones, registros) |
| **identify** | Identificación del usuario con atributos |
| **group** | Agrupación por cuenta o empresa |
| **form_submission** | Envíos de formularios capturados desde su sitio web |

## Destinos

Los destinos son los lugares a los que se envían los eventos una vez recopilados y transformados.

### Tipos de destinos

| Tipo | Función |
|------|---------|
| **Webhook** | Envía los payloads de eventos por HTTP POST a cualquier URL |
| **Tag** | Inyecta JavaScript en la página para integraciones del lado del cliente |
| **Warehouse** | Agrupa eventos en un almacén de datos para su análisis |
| **Connector** | Conectores externos para la sincronización de datos |

### Destinos predeterminados

Al configurar Connections, graph8 crea varios destinos de forma automática:

| Destino | Tipo | Propósito |
|---------|------|-----------|
| **Identify** | Tag | Píxel de identificación de visitantes; asocia visitantes anónimos con empresas |
| **Chat** | Tag | Script del widget de chat web |
| **Form Tracker** | Tag | Captura envíos desde cualquier formulario de su sitio |
| **Campaign Visitor Trigger** | Webhook | Registra los clics en enlaces de campaña y los asocia con los contactos |
| **Forms Sync** | Webhook | Envía los envíos de formularios a graph8 para crear contactos |
| **Tailor** | Tag | Motor de personalización del sitio web |
| **Warehouse** | Warehouse | Almacenamiento de eventos para análisis (opcional) |

### Destinos personalizados

Agregue sus propios destinos para enrutar eventos a donde los necesite:

- **Destinos webhook**: envíe eventos a cualquier endpoint HTTP
- **Destinos tag**: inyecte JavaScript personalizado (analíticas, píxeles, widgets de chat)
- **Destinos connector**: sincronice datos con bases de datos externas y herramientas SaaS

## Funciones

Las funciones son código JavaScript personalizado que transforma los eventos en tránsito. Úselas para:

- **Filtrar**: descartar eventos que no cumplen ciertos criterios
- **Enriquecer**: añadir datos a los eventos antes de que lleguen a un destino
- **Transformar**: ajustar los payloads para que coincidan con lo que espera el destino
- **Enrutar**: enviar eventos a distintos destinos según condiciones

graph8 incluye funciones integradas para tareas habituales, como el filtrado de visitantes de campañas y el procesamiento de envíos de formularios.

## Enlaces

Los enlaces conectan streams con destinos. Cada enlace define:

| Configuración | Qué controla |
|--------------|-------------|
| **Fuente** | Qué stream envía los eventos |
| **Destino** | A dónde se enrutan los eventos |
| **Funciones** | Qué funciones de transformación se aplican |
| **Filtro de eventos** | Qué tipos de eventos se reenvían |
| **Filtro de host** | Qué dominios de origen se aceptan |

En los enlaces de tipo sync, también puede configurar:

- **Programación**: frecuencia de sincronización
- **Zona horaria**: zona horaria de la programación
- **Prefijo de tabla**: convención de nombres para las tablas de destino

## Sincronizaciones

Las sincronizaciones permiten la transferencia de datos bidireccional con sistemas externos. Configure:

- Qué streams de datos sincronizar
- La programación de la sincronización
- La nomenclatura de las tablas de destino

## Eventos en vivo

Supervise su pipeline de eventos en tiempo real:

- Visualice los eventos entrantes a medida que llegan
- Inspeccione los payloads y metadatos de cada evento
- Depure problemas de enrutamiento y transformación
- Verifique que los destinos estén recibiendo datos

## Seguimiento de campañas

Connections gestiona la atribución de campañas de forma automática. Cuando un prospecto hace clic en un enlace de campaña:

1. La URL incluye un hash de campaña que identifica el paso de la secuencia y al contacto
2. El script de seguimiento de graph8 captura la vista de página junto con el hash
3. El destino Campaign Visitor Trigger envía el evento a graph8
4. graph8 vincula la visita con el contacto y el paso de la secuencia correspondientes

Todo esto ocurre de forma automática: no requiere configuración manual más allá de tener Connections instalado en su sitio.

> **Tip:**
> Instale el script de seguimiento de graph8 en todas las páginas de su sitio web. Así habilitará la identificación de visitantes, el seguimiento de formularios y la atribución de campañas en todo el sitio, no solo en las páginas de destino.

## Próximos pasos

- [Web Chat →](https://docs.graph8.com/engage/web-chat/): widget de chat entregado a través de Connections
- [Sequencer →](https://docs.graph8.com/engage/sequencer/): seguimiento de campañas impulsado por Connections
- [Appointments →](https://docs.graph8.com/engage/appointments/): reserva de citas y sincronización con CRM