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 a 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:
Without Events Module (manual):
- User wants restock alert → Custom tracking code
- Product price drops → Manual notification logic
- Each product needs separate handling
With Events Module (automated):
- User subscribes to product → Stored automatically
- Product restocked → All subscribers notified
- All subscriptions managed centrally
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 se han inscrito para 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 por correo | Alertas de reposición, bajadas de precio, boletines |
| Notificación Push | Alertas en móvil/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 Evento
1. User subscribes to a product
↓
2. Product status changes (restocked, price change, etc.)
↓
3. Event detects the change
↓
4. Event sends notifications to all subscribers
↓
5. Subscribers receive the message
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 la suscripción 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 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 los datos del producto cambian.
¿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:
Good markers:
- product_back_in_stock
- product_price_drop
- product_low_stock
- product_new_variant
- product_discontinued
Bad markers:
- 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