Saltar al contenido principal

Guía de inicio rápido

Esta guía te ayudará a enviar tu primera campaña en menos de 5 minutos.

Requisitos previos​

  • Una cuenta de Joryio (regístrate en joryio.com)
  • Acceso al código de tu sitio web (para integrar el SDK)

Paso 1: instala el SDK (2 minutos)​

Mediante npm​

npm install @joryio/web-sdk

O mediante una etiqueta de script (servida desde la API de Joryio)​

<script src="https://api-eu1.joryio.com/sdk/web/latest/joryio.min.js"></script>

Inicialízalo en tu app​

import JoryioSDK from '@joryio/web-sdk';

const joryio = new JoryioSDK({
  sdkKey: 'jry_sdk_web_your_key_here' // Obténla en Configuración → Apps
});

// Identifica a los usuarios cuando inician sesión
joryio.identify('user_123');
joryio.setAttributes({
  email: 'user@example.com',
  name: 'John Doe',
});

// Registra eventos
joryio.track('Page Viewed', {
  page: 'Homepage'
});
Obtén tu clave de SDK

Ve a Configuración → Apps en el panel de Joryio para crear una app y obtener tu clave de SDK.

Paso 2: proveedor de email (configurado por tu administrador)​

El proveedor de email (SendGrid, SES, etc.) es infraestructura de envío. Tu administrador de Joryio lo configura para la organización desde la consola de administración; no configuras credenciales del proveedor desde el panel. Si aún no se envían emails, pide a tu administrador que habilite un proveedor.

Proveedores compatibles
  • SendGrid
  • Bird (Reach API)
  • AWS SES
  • Mailgun
  • SMTP (cualquier proveedor)

Paso 2.5: añade una identidad de remitente (1 minuto)​

Tu administrador primero vincula y verifica un dominio de envío (SPF/DKIM). Puedes consultar su estado en Analítica → Entregabilidad. Después, crea la dirección desde la que se enviarán tus emails:

  1. Ve a Configuración → Configuración de email
  2. Haz clic en Añadir configuración
  3. Define un nombre visible y la parte local, y elige un dominio verificado en el menú (por ejemplo, news@yourdomain.com)
  4. (Opcional) establécelo como remitente predeterminado

Consulta Configuración de email para las listas gestionadas de Responder a/CCO y los remitentes por variante.

Paso 3: crea tu primer segmento (1 minuto)​

  1. Ve a Audiencia → Segmentos
  2. Haz clic en Crear segmento
  3. Llámalo «Todos los usuarios»
  4. Deja los filtros vacíos (coincide con todos)
  5. Haz clic en Crear segmento

Paso 4: envía tu primera campaña (1 minuto)​

  1. Ve a Campañas
  2. Haz clic en Crear campaña y elige el tipo Email
  3. Sigue los pasos del asistente:
    • Detalles: llámala «Email de bienvenida»
    • Crear: asunto «¡Te damos la bienvenida a nuestra app!» y tu mensaje de bienvenida
    • Audiencia: selecciona el segmento «Todos los usuarios»
  4. Haz clic en Enviar email de prueba en la variante para previsualizarla
  5. En el paso Resumen, haz clic en Lanzar campaña

¡Enhorabuena! Acabas de enviar tu primera campaña.

Próximos pasos​

Registra más eventos​

Añade el registro de eventos en toda tu app:

// Registro de usuario
joryio.track('Signup Completed', {
  plan: 'free',
  source: 'website'
});

// Uso de funcionalidades
joryio.track('Feature Used', {
  feature: 'export',
  format: 'csv'
});

// Compras
joryio.track('Order Completed', {
  order_id: 'order_123',
  total: 99.99,
  items: 3
});

Crea segmentos avanzados​

Crea segmentos basados en comportamiento de usuario:

Dirigirse a usuarios para los que:
- plan = "trial"
Y
- signup_date está dentro de los últimos 14 días
Y
- NO han realizado "Order Completed"

Crea recorridos automatizados​

Crea un recorrido de incorporación automatizado:

  1. Ve a Recorridos de usuario → Crear recorrido de usuario
  2. Define un disparador de evento (por ejemplo, tu evento de registro)
  3. Añade un email de bienvenida (inmediato)
  4. Añade una espera (2 días)
  5. Añade un email de tutorial de funcionalidades
  6. Activa el recorrido

Problemas habituales​

¿No aparecen los eventos?​

  • Comprueba que la clave de SDK sea correcta
  • Activa el modo de depuración: new JoryioSDK({ sdkKey, enableDebug: true })
  • Comprueba si hay errores en la consola del navegador

¿No se envían los emails?​

  • Pide a tu administrador que confirme que hay un proveedor de email configurado
  • Comprueba que el remitente esté en un dominio verificado
  • Revisa el estado de la campaña

¿Necesitas ayuda?​

¡Ya está todo listo! Empieza a crear potentes flujos de automatización de marketing.