Esta guía explica cómo enviar emails de marketing desde tu propio sistema utilizando la API de DataCrush.

Este tipo de integración es ideal cuando una aplicación externa necesita decidir automáticamente:

• A qué contacto enviar un email
• Cuándo enviarlo
• Qué información personalizada incluir

Por ejemplo:

• Confirmaciones de compra
• Automatizaciones externas
• Integraciones con ecommerce o CRM
• Emails generados desde Make, Zapier o sistemas propios
• Acciones automatizadas desde plataformas externas

¿Cómo funciona?

Cada solicitud a la API permite:

• Encolar un envío de Email Marketing para un contacto específico
• Utilizar un Email Marketing previamente configurado en DataCrush
• Personalizar contenido mediante variables dinámicas

El email no se entrega instantáneamente en la misma llamada. La solicitud queda en cola y DataCrush procesa el envío automáticamente en los minutos siguientes.

Luego podrás visualizar:

• Entregas
• Aperturas
• Clics
• Rebotes
• Estadísticas generales

Desde el reporte de Email Marketing de DataCrush.

Requisitos previos

Antes de comenzar necesitas:

1. Credenciales de API

Debes contar con:

Estas credenciales pueden obtenerse desde la configuración de tu portal.

2. Tener un Email Marketing configurado y corriendo

La API no crea diseños de emails.

Debes tener previamente creado un Email Marketing vía API en DataCrush:

• El diseño del correo
• El remitente
• El asunto
• La configuración del envío

Además, el Email Marketing debe encontrarse en estado: Corriendo

Si el envío está:

• En borrador
• Pausado
• Finalizado

La API rechazará las solicitudes.

3. ID del Email Marketing (emailmarketing_id)

Cuando creas un envío de Email Marketing preparado para utilizar vía API, DataCrush genera automáticamente un identificador único para ese envío.

Ese identificador es el valor que luego deberás enviar en la API como: emailmarketing_id
 

La API utiliza este ID para saber:

• Qué diseño de email usar
• Qué remitente utilizar
• Qué asunto enviar
• Qué configuración de envío aplicar

El ID puede verse normalmente en la URL del reporte o detalle del Email Marketing dentro de DataCrush.

Endpoint de la API

URL

https://api.datacrush.la/emailmarketing/send

Método

POST

Formato

JSON

Headers requeridos

Debes enviar las credenciales mediante headers HTTP:

X-Portal-Id: TU_PORTAL_ID
X-Api-Key: TU_API_KEY

Ejemplo básico

Si el contacto ya existe en el portal:

{
  "email": "cliente@empresa.com",
  "emailmarketing_id": "45678"
}

Crear el contacto automáticamente (opcional)

Si el contacto todavía no existe en DataCrush, puedes utilizar:

"create_contact": true

De esta forma:

• El contacto se crea automáticamente
• Se incorpora a la base de contactos
• Luego se encola el envío

Ejemplo

{
  "email": "nuevo@empresa.com",
  "emailmarketing_id": "45678",
  "create_contact": true,
  "first_name": "Juan",
  "last_name": "Pérez"
}

Variables dinámicas en el contenido

Puedes personalizar el contenido del email utilizando variables.

Por ejemplo, si tu diseño contiene:

{{nombre}}
{{codigo_pedido}}

Puedes enviar:

{
  "email": "cliente@empresa.com",
  "emailmarketing_id": "45678",
  "variables": {
    "nombre": "Juan",
    "codigo_pedido": "ORD-9921"
  }
}

DataCrush reemplazará automáticamente esos valores dentro del contenido del email.

Campos disponibles

Respuesta correcta

Cuando el envío fue aceptado correctamente:

{
  "result": "success"
}

Esto significa que:

• El envío fue validado correctamente
• El email quedó en cola para ser enviado

Si además el contacto fue creado automáticamente, también aparecerá:

"contact_created": "1"

Respuestas de error

Credenciales inválidas

{
  "result": "fail",
  "error": {
    "code": 100
  }
}

Verifica:

• Portal ID
• API Key

El contacto no existe

{
  "result": "fail",
  "error": {
    "code": 206
  }
}

Sucede cuando:

• El email no existe en el portal
• No utilizaste create_contact

Email Marketing inválido

{
  "result": "fail",
  "error": {
    "code": 206
  }
}

Verifica que:

• El emailmarketing_id sea correcto
• El Email Marketing exista
• El envío esté corriendo

JSON inválido

{
  "result": "fail",
  "error": {
    "code": 210
  }
}

Tu integración debe enviar:

Content-Type: application/json

Y un JSON correctamente formado.

Límites de la API

Actualmente el límite es:

30 solicitudes por minuto por portal

Si superas el límite:

• La API devolverá error
• Debes esperar antes de reintentar

Buenas prácticas recomendadas

Mantén la API Key segura

No coloques credenciales:

• En código público
• Frontends
• Repositorios abiertos

Utiliza variables de entorno o almacenamiento seguro.

Utiliza esta API para envíos individuales

Esta API está pensada para:

• Un contacto por solicitud
• Envíos controlados por sistemas externos

No reemplaza campañas masivas tradicionales desde la plataforma.

Verifica siempre el estado del Email Marketing

Antes de enviar solicitudes asegúrate de que el Email Marketing se encuentre en estado:

Corriendo

Ejemplo completo con cURL

curl -X POST "https://api.datacrush.la/emailmarketing/send.php?portal_id=TU_PORTAL_ID&api_key=TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"email\":\"cliente@empresa.com\",\"emailmarketing_id\":\"45678\",\"create_contact\":true,\"first_name\":\"Ana\",\"last_name\":\"García\",\"variables\":{\"nombre\":\"Ana\"}}"

Preguntas frecuentes

¿El email se envía inmediatamente?

No.

La solicitud únicamente encola el envío y DataCrush lo procesa automáticamente en los minutos siguientes.

¿Puedo enviar múltiples veces al mismo contacto?

Sí.

La API no bloquea envíos duplicados automáticamente.

¿Puedo modificar el diseño del email desde la API?

No.

La API utiliza el diseño previamente configurado en el Email Marketing de DataCrush.

Solo puedes personalizar contenido dinámico mediante variables.

¿Dónde veo estadísticas y resultados?

En:

Email Marketing → Reportes

Allí podrás visualizar:

• Aperturas
• Clics
• Rebotes
• Entregas
• Resultados generales del envío

Resumen rápido

1. Crear un Email Marketing en DataCrush
2. Colocarlo en estado “Corriendo”
3. Obtener el emailmarketing_id
4. Enviar solicitudes POST a la API
5. Revisar resultados desde los reportes de Email Marketing