Utiliza la API de Omnisend para conectar plataformas de comercio electrónico personalizadas (como Magento u OpenCart) o construir integraciones avanzadas que transfieran datos de contacto, pedido, producto y evento entre tu tienda y Omnisend.
Este artículo explica cuándo usar la API, qué hace y qué guías de integración seguir.
Antes de empezar
✅ Esta guía es para:
Magento, OpenCart o plataformas de comercio electrónico personalizadas.
Desarrolladores que construyen integraciones de aplicaciones de terceros.
Usuarios avanzados que añaden funciones personalizadas (webhooks, eventos personalizados).
❌ No necesario para:
Shopify, WooCommerce o BigCommerce (estas plataformas se integran automáticamente - no se requiere configuración de API).
Requisitos previos:
Generar una clave API (requerida para todas las solicitudes de API).
Conocimientos básicos de REST APIs y JSON (o contratar a un desarrollador).
Acceso al backend/código de tu tienda.
¿Qué es la API de Omnisend?
La API de Omnisend permite que tu tienda o aplicación envíe datos automáticamente a Omnisend – no se requieren cargas manuales.
Por ejemplo, cuando un Cliente realiza un Pedido, la API envía los detalles del pedido a Omnisend para que puedas activar los correos electrónicos de Confirmación de pedido. O cuando un visitante navega por productos, la API rastrea su actividad para los flujos de trabajo de Abandono de navegación.
Omnisend proporciona dos tipos de API:
API REST – pasa datos entre el backend de tu tienda y Omnisend (contactos, pedidos, productos, eventos).
API de JavaScript – rastrea la actividad del sitio web (vistas de página, vistas de producto, adiciones al carrito) para flujos de trabajo de comportamiento.
Cuándo usar la API
Usa la API si:
Tienes una plataforma de comercio electrónico personalizada (no Shopify/WooCommerce/BigCommerce).
Estás en Magento, OpenCart u otra plataforma sin un plugin nativo de Omnisend.
Quieres construir integraciones personalizadas (por ejemplo, sincronizar contactos desde un CRM, activar flujos de trabajo basados en eventos de la aplicación).
Necesitas funciones avanzadas como webhooks, seguimiento de eventos personalizados o sincronización de datos en tiempo real.
No uses la API si:
Estás en Shopify, WooCommerce o BigCommerce – utiliza el complemento nativo en su lugar (configuración más rápida, sin codificación).
Comenzando
Paso 1. Revisa la documentación de la API:
Guía de inicio rápido – conceptos básicos de la API REST (autenticación, puntos finales, formato de solicitud).
Guía de API de JavaScript – configuración de seguimiento del sitio web.
Paso 2. Generar una clave API:
Sigue esta guía para crear una clave con los permisos adecuados (Contactos, Pedidos, Productos, Eventos).
Paso 3. Prueba tu integración:
Utiliza Registros de API (Configuración de Tienda → Registros de API) para depurar solicitudes y confirmar que los datos se están transmitiendo correctamente.
Guías de Integración Específicas de Funcionalidad
Una vez que tu conexión básica de API esté funcionando, completa estas guías para habilitar características específicas de Omnisend:
Contactos y sincronización de datos. Pasar información de contacto a Omnisend– sincronizar listas de suscriptores, agregar propiedades personalizadas, actualizar detalles de contacto.
Recuperación de Pedidos y Carrito:
Habilitar Flujos de Trabajo de Carrito Abandonado – pasar datos del carrito para activar correos electrónicos/SMS de carrito abandonado.
Habilitar flujos de Confirmación de pedido y Confirmación de envío – pasar datos del pedido para activar correos electrónicos transaccionales.
Seguimiento del Producto:
Configura el Selector de Productos – permite a los usuarios seleccionar productos en el Editor de correos electrónicos y flujos de trabajo de automatización.
Habilitar flujos de trabajo de Abandono de Producto y Abandono de navegación – rastrear vistas de productos y adiciones al carrito.
Eventos personalizados. Trigger eventos personalizados para Flujos de Trabajo de Automatización– pasar datos personalizados (por ejemplo, "prueba iniciada," "suscripción renovada") para activar flujos de trabajo.
Analítica e informes (Beta). Exportar datos analíticos con la API de Estadísticas– consultar el rendimiento de la campaña y el flujo, métricas de participación, atribución de ingresos, métricas de ventas a nivel de producto (unidades totales y atribuidas ordenadas), entregabilidad y datos de crecimiento de la audiencia para herramientas de BI, paneles personalizados o integraciones de almacén de datos.
Formularios y seguimiento de rendimiento (Beta). Exportar datos de formularios con la API de Formularios– recuperar listas de formularios, informes de rendimiento, envíos de contacto y datos de Prueba A/B para paneles personalizados o integraciones de terceros.
Preguntas Frecuentes
¿Necesito habilidades de programación para usar la API?
Sí. Necesitarás entender REST APIs, JSON y el código backend de tu tienda. Si no eres un desarrollador, contrata uno o utiliza una integración nativa (Shopify/WooCommerce/BigCommerce).
¿Cuál es la diferencia entre la API REST y la API de JavaScript?
API REST pasa datos entre servidores (contactos, pedidos, productos)
API de JavaScript rastrea el comportamiento del usuario en su sitio web (vistas de página, vistas de producto, adiciones al carrito)
La mayoría de las integraciones utilizan ambos.
¿Puedo usar la API junto con integraciones nativas?
Sí. Por ejemplo, los usuarios de Shopify pueden usar la API de JavaScript para rastrear eventos personalizados, aunque la integración principal (pedidos, contactos) es automática.
¿Cómo soluciono errores de la API?
Verifica Registros de API (Configuraciones de Tienda → Registros de API) para ver los detalles de solicitud/respuesta. Problemas comunes: clave API incorrecta, campos requeridos faltantes y límite de tasa excedido.
¿Tienes alguna pregunta adicional? Habla con nosotros en [email protected] o en el chat de la aplicación.