Introducción
Suscríbete a notificaciones y actualizaciones relacionadas con productos.
🔐 Este método requiere autorización.
¿Qué hace este módulo?
El módulo Events te permite suscribir usuarios a notificaciones de productos - como recibir un correo electrónico cuando un producto vuelve a estar en stock, o una alerta cuando el precio baja.
Piénsalo como un sistema de suscripción de productos - los usuarios pueden suscribirse a productos específicos y recibir notificaciones cuando algo cambia.
Explicación Simple
Imagina que estás administrando una tienda en línea y quieres mantener informados a los usuarios sobre los productos:
- Producto de vuelta en stock - Notifica a los usuarios que están esperando este artículo
- Bajada de precio - Alerta a los usuarios que están observando este producto
- Nuevo producto añadido - Notifica a los suscriptores de una categoría específica
- Advertencia de stock limitado - Informa a los usuarios interesados antes de que se agote
En lugar de rastrear manualmente quién quiere qué:
- Configura eventos de productos en el panel de administración de OneEntry
- Los usuarios se suscriben a los productos que les interesan
- Notificaciones automáticas cuando algo cambia
- Gestiona todas las suscripciones en un solo lugar
Ejemplo del mundo real:
Sin el Módulo de Eventos (manual):
- Usuario quiere alerta de reposición → Código de seguimiento personalizado
- El precio del producto baja → Lógica de notificación manual
- Cada producto necesita manejo separado
Con el Módulo de Eventos (automatizado):
- Usuario se suscribe a un producto → Almacenado automáticamente
- Producto reabastecido → Todos los suscriptores notificados
- Todas las suscripciones gestionadas centralmente
Conceptos Clave
¿Qué es un Evento de Producto?
Un evento de producto es una notificación desencadenada por cambios en un producto:
- Desencadenante - Lo que sucede con el producto (por ejemplo, "de vuelta en stock")
- Notificación - Lo que reciben los suscriptores (correo electrónico, push, mensaje de socket)
- Suscriptores - Usuarios que optaron por recibir actualizaciones de este producto
- Plantilla - El contenido del mensaje de notificación
Canales de Notificación
Tres formas de notificar a los suscriptores:
| Canal | Descripción | Mejor Para |
|---|---|---|
| Correo Electrónico | Enviar mensajes de correo | Alertas de reposición, bajadas de precio, boletines |
| Notificación Push | Alertas móviles/navegador | Alertas urgentes, ventas flash |
| Socket.IO | Mensajes de websocket en tiempo real | Actualizaciones de inventario en vivo, sincronización instantánea de precios |
| Integraciones | Mensajes de integración | Flujos de trabajo de notificación personalizados |
Lee más sobre Integraciones.
Ejemplo de Flujo de Eventos
1. Usuario se suscribe a un producto
↓
2. Cambia el estado del producto (reabastecido, cambio de precio, etc.)
↓
3. El evento detecta el cambio
↓
4. El evento envía notificaciones a todos los suscriptores
↓
5. Los suscriptores reciben el mensaje
Lo Que Necesitas Saber
Desencadenantes Comunes de Eventos de Producto
Eventos de producto típicos que podrías configurar:
- Producto de vuelta en stock
- Alerta de bajada de precio
- Advertencia de stock bajo
- Producto descontinuado
- Nueva variante disponible
- Oferta especial en el producto
Lee más sobre Desencadenantes de Eventos.
Variables de Plantilla
Utiliza marcadores de posición en las plantillas de notificación para incluir detalles del producto como nombre, precio y disponibilidad.
Tabla de Referencia Rápida - Métodos Comunes
| Método | Qué Hace |
|---|---|
| getAllSubscriptions() | Obtener todas las suscripciones de productos |
| subscribeByMarker() | Suscribirse a un evento de producto por marcador |
| unsubscribeByMarker() | Cancelar la suscripción a un evento de producto por marcador |
Nota: Los eventos están configurados en el panel de administración de OneEntry. El SDK gestiona las suscripciones - úsalo para suscribir/cancelar suscripciones de usuarios a eventos de productos.
Preguntas Comunes (FAQ)
¿Cómo creo o edito eventos de productos?
Los eventos se gestionan en el panel de administración de OneEntry:
- Inicia sesión en el administrador de OneEntry
- Ve a la sección de Eventos
- Crea o edita eventos de productos
- Configura desencadenantes, canales y plantillas
- Activa el evento
¿Cuál es la diferencia entre Notificación Push y Socket.IO?
Notificación Push - Enviada al dispositivo (funciona incluso cuando la aplicación está cerrada)
- Aparece en el centro de notificaciones
- El usuario puede tocar para abrir la aplicación
- Mejor para: Alertas de reposición, bajadas de precio
Socket.IO - Mensaje de websocket en tiempo real (solo cuando la aplicación está abierta)
- Entrega instantánea a los clientes conectados
- Actualizaciones en vivo sin necesidad de refrescar
- Mejor para: Visualización de inventario en vivo, actualizaciones de precios en tiempo real
¿Puedo desencadenar manualmente un evento de producto desde mi código?
El SDK no admite desencadenantes manuales. Los eventos se activan automáticamente según los desencadenantes configurados en OneEntry cuando cambian los datos del producto.
¿Puedo personalizar las plantillas de notificación?
¡Sí! En el panel de administración de OneEntry:
- Plantillas de correo electrónico HTML
- Estilo personalizado
- Soporte multilingüe
- Variables específicas del producto
Notas Importantes
Convención de Nombres de Eventos
Utiliza marcadores claros y descriptivos para los eventos de productos:
Buenos marcadores:
- product_back_in_stock
- product_price_drop
- product_low_stock
- product_new_variant
- product_discontinued
Malos marcadores:
- event1
- notification
- product_event
- test
Mejores Prácticas
- Utiliza marcadores de eventos descriptivos que incluyan "producto"
- Incluye detalles relevantes del producto en las plantillas de notificación
- Localiza los mensajes de eventos para diferentes mercados
- Maneja los errores de suscripción de manera adecuada
- Permite a los usuarios cancelar la suscripción fácilmente
Más información sobre la interfaz de usuario del módulo https://doc.oneentry.cloud/docs/events/introduction
Definición del módulo Events
const { Events } = defineOneEntry( "your-project-url", { "token": "your-app-token" });
Documentación Relacionada
- Módulo de Productos - Gestiona productos que desencadenan eventos
- Módulo de Usuarios - Gestiona usuarios que se suscriben a notificaciones