Pular para o conteúdo principal

Introdução

Inscreva-se para receber notificações e atualizações relacionadas a produtos.

🔐 Este método requer autorização.

O que este módulo faz?​

O módulo Events permite que você inscreva usuários em notificações de produtos - como receber um e-mail quando um produto estiver de volta em estoque ou um alerta quando o preço cair.

Pense nisso como um sistema de assinatura de produtos - os usuários podem se inscrever em produtos específicos e receber notificações quando algo mudar.

Explicação Simples​

Imagine que você está gerenciando uma loja online e deseja manter os usuários informados sobre os produtos:

  • Produto de volta em estoque - Notifique os usuários que estão esperando por este item
  • Queda de preço - Alerta os usuários que estão acompanhando este produto
  • Novo produto adicionado - Notifique os assinantes de uma categoria específica
  • Aviso de estoque limitado - Informe os usuários interessados antes que acabe

Em vez de rastrear manualmente quem quer o quê:

  • Configure eventos de produtos no painel de administração do OneEntry
  • Os usuários se inscrevem nos produtos que lhes interessam
  • Notificações automáticas quando algo muda
  • Gerencie todas as assinaturas em um só lugar

Exemplo do mundo real:

Sem o Módulo Events (manual):
- Usuário quer alerta de reposição → Código de rastreamento personalizado
- Preço do produto cai → Lógica de notificação manual
- Cada produto precisa de tratamento separado

Com o Módulo Events (automatizado):
- Usuário se inscreve no produto → Armazenado automaticamente
- Produto reabastecido → Todos os assinantes notificados
- Todas as assinaturas gerenciadas centralmente

Conceitos Chave​

O que é um Evento de Produto?​

Um evento de produto é uma notificação acionada por mudanças em um produto:

  • Gatilho - O que acontece com o produto (por exemplo, "de volta em estoque")
  • Notificação - O que os assinantes recebem (e-mail, push, mensagem de socket)
  • Assinantes - Usuários que optaram por receber atualizações deste produto
  • Template - O conteúdo da mensagem de notificação

Canais de Notificação​

Três maneiras de notificar os assinantes:

CanalDescriçãoMelhor Para
EmailEnviar mensagens de e-mailAlertas de reposição, quedas de preço, newsletters
Push NotificationAlertas móveis/navegadorAlertas urgentes, vendas relâmpago
Socket.IOMensagens websocket em tempo realAtualizações de inventário ao vivo, sincronização instantânea de preços
IntegraçõesMensagens de integraçãoFluxos de trabalho de notificação personalizados

Leia mais sobre Integrações

Exemplo de Fluxo de Evento​

1. Usuário se inscreve em um produto
   ↓
2. O status do produto muda (reabastecido, mudança de preço, etc.)
   ↓
3. O evento detecta a mudança
   ↓
4. O evento envia notificações a todos os assinantes
   ↓
5. Os assinantes recebem a mensagem

O que você precisa saber​

Gatilhos Comuns de Eventos de Produto​

Eventos de produto típicos que você pode configurar:

  • Produto de volta em estoque
  • Alerta de queda de preço
  • Aviso de estoque baixo
  • Produto descontinuado
  • Nova variante disponível
  • Oferta especial no produto

Leia mais sobre Gatilhos de Eventos.

Variáveis de Template​

Use marcadores em templates de notificação para incluir detalhes do produto, como nome, preço e disponibilidade.

Tabela de Referência Rápida - Métodos Comuns​

MétodoO que Faz
getAllSubscriptions()Obter todas as assinaturas de produtos
subscribeByMarker()Inscrever-se em um evento de produto por marcador
unsubscribeByMarker()Cancelar a inscrição de um evento de produto por marcador

Nota: Os eventos são configurados no painel de administração do OneEntry. O SDK gerencia as assinaturas - use-o para inscrever/cancelar usuários de eventos de produtos.

Perguntas Comuns (FAQ)​

Como eu crio ou edito eventos de produtos?​

Os eventos são gerenciados no painel de administração do OneEntry:

  1. Faça login no painel de administração do OneEntry
  2. Vá para a seção de Eventos
  3. Crie ou edite eventos de produtos
  4. Configure gatilhos, canais e templates
  5. Ative o evento

Qual é a diferença entre Push Notification e Socket.IO?​

Push Notification - Enviado para o dispositivo (funciona mesmo quando o aplicativo está fechado)

  • Aparece no centro de notificações
  • O usuário pode tocar para abrir o aplicativo
  • Melhor para: Alertas de reposição, quedas de preço

Socket.IO - Mensagem websocket em tempo real (apenas quando o aplicativo está aberto)

  • Entrega instantânea para clientes conectados
  • Atualizações ao vivo sem atualização
  • Melhor para: Exibição de inventário ao vivo, atualizações de preço em tempo real

Posso acionar manualmente um evento de produto a partir do meu código?​

O SDK não suporta acionamentos manuais. Os eventos são acionados automaticamente com base nos gatilhos configurados no OneEntry quando os dados do produto mudam.

Posso personalizar templates de notificação?​

Sim! No painel de administração do OneEntry:

  • Templates de e-mail em HTML
  • Estilização personalizada
  • Suporte a múltiplos idiomas
  • Variáveis específicas do produto

Notas Importantes​

Convenção de Nomenclatura de Eventos​

Use marcadores claros e descritivos para eventos de produtos:

Marcadores bons:
- product_back_in_stock
- product_price_drop
- product_low_stock
- product_new_variant
- product_discontinued

Marcadores ruins:
- event1
- notification
- product_event
- test

Melhores Práticas​

  • Use marcadores de eventos descritivos que incluam "produto"
  • Inclua detalhes relevantes do produto nos templates de notificação
  • Localize mensagens de eventos para diferentes mercados
  • Trate erros de assinatura de forma adequada
  • Permita que os usuários cancelem a inscrição facilmente

Mais informações sobre a interface do usuário do módulo https://doc.oneentry.cloud/docs/events/introduction

Definição do módulo Events​


const { Events } = defineOneEntry(
  "sua-url-do-projeto", {
    "token": "seu-token-de-aplicativo"
  }
);

Documentação Relacionada​