Edição de Evento

A edição de evento consiste em três abas:

• Condições
• Atributos
• Configurações

Condições

A aba "Condições" contém campos de entrada para editar o evento. Esses são os dados principais do evento: Nome e

Marcador

, além das condições de disparo.

Módulos

Nas condições, é necessário escolher um módulo que determinará a condição de envio do evento. Os seguintes módulos estão disponíveis:

• catalogo
• formularios
• pedidos
• usuarios

Condições para o módulo catalogo

Para o módulo catalogo, no campo tipo, você pode escolher a filtragem por status, e então selecionar um status específico — assim você se inscreve para o evento de mudança de status dos itens do catálogo.
Alternativamente, você pode se inscrever em eventos por conjuntos de atributos e escolher um atributo específico.

Condições para o módulo formularios

Para o módulo formularios, é necessário escolher o tipo de formulário ao qual o evento será adicionado. As seguintes opções estão disponíveis:

• Registro
  O evento é criado ao registrar um novo usuário através da API de Conteúdo ou no CMS.
• Enviar Código
  O evento é criado ao gerar um novo código de confirmação para o usuário (incluindo registro).
• Alterar Senha
  O evento é criado ao alterar a senha pelo usuário.
• Enviar dados do formulário
  O evento é criado ao enviar os dados do formulário selecionado através da API.

Para Enviar dados do formulário, é necessário escolher um formulário (dos formulários com tipo "Envio de dados") e um atributo que você adicionou para o e-mail (essa inscrição não se aplica a outros atributos). Ao enviar o formulário, os dados são enviados para o e-mail indicado nesse atributo.
Mais detalhes sobre formulários estão no capítulo Formulários.

Todos os eventos do módulo formularios incluem informações sobre o usuário. Os eventos Registro e Enviar Código também contêm o código de confirmação.

Condições para o módulo pedidos

Para o módulo pedidos, é necessário escolher um armazenamento de pedidos específico e um status, cuja alteração estará vinculada ao evento.

Condições para o módulo usuarios

Para o módulo usuarios, é necessário escolher a filtragem por conjuntos de atributos e especificar um atributo específico, cuja alteração estará vinculada ao evento.

Ao configurar a distribuição, você pode usar condições especiais:

• hoje — verifica se a data atual coincide com a data no atributo do usuário do tipo date ou dateTime.
• agora — verifica se a hora atual (horas e minutos) coincide com o valor no atributo do tipo time ou dateTime.

Método de Envio

Para todos os módulos, exceto formularios, estão disponíveis três métodos de envio de notificação:

1. Notificação Push — através de notificações push
2. E-mail — envio por e-mail
3. Socket IO — através de websockets (adequado para inscrição em eventos em tempo real, como alteração de preço). Para mais detalhes, consulte a documentação do Socket.IO.

Para quem enviar

Para o módulo catalogo, você pode escolher os destinatários da notificação:

• todos os usuários do seu
  site
  ,
• ou um grupo específico de usuários.

Com que frequência enviar

Para eventos dos módulos catalogo e usuarios, você pode escolher a frequência de envio:

• uma vez ao ocorrer o evento,
• todas as vezes ao ocorrer novamente.

Atributos

A aba "Atributos" contém uma lista suspensa para selecionar um conjunto de atributos.

Após selecionar o conjunto de atributos, é necessário preencher os valores. Por exemplo:

• event_send_date (tipo Data e Hora)
• event_desc (tipo String)

Esses atributos podem ser usados na aba Configurações para criar um modelo de mensagem. Eles estão disponíveis pela chave event:

{{ event.attribute_marker }}

Atributo timeInterval para agendamento de distribuições**
Se o conjunto de atributos selecionado contiver um atributo do tipo timeInterval, ele se torna disponível para seleção nas configurações de agendamento de distribuição (modo Distribuição).
Ao escolher tal atributo, a distribuição será enviada apenas nos dias indicados no intervalo (por exemplo, apenas nas segundas e sextas).

Configurações

A aba "Configurações" contém dois campos de texto para criar um modelo de mensagem que os usuários do seu

site

receberão.

Variáveis disponíveis

Abaixo dos campos de entrada, é exibida uma lista de variáveis disponíveis para substituição no modelo (por exemplo, {{ email }}, {{ user.attribute_marker }} e outras).

Distribuição para usuários (modo Distribuição)

A funcionalidade permite configurar distribuições de e-mail periódicas para usuários que atendem às condições especificadas. Ao contrário dos eventos padrão, a distribuição não é acionada pela alteração de dados, mas de acordo com um cronograma, quando as condições são atendidas.

Configuração da distribuição

1. Criação do evento

   • Tipo de evento: Usuários
   • Modo de operação: Distribuição (envio)

2. Configuração do cronograma

   • Hora: ponto de referência (por exemplo, segunda-feira às 10:00)
   • Periodicidade:
     • Diariamente
     • Semanalmente
     • Mensalmente
     • Intervalo personalizado
     • Do atributo timeInterval — se tal atributo estiver presente no conjunto de atributos, você pode escolhê-lo, e a distribuição será enviada apenas nos dias da semana indicados.

3. Condições de seleção de usuários

   • Exemplos:
     • Data de registro > 2024-01-01
     • Inscrição na distribuição = true
     • hoje: data atual = valor do atributo date/dateTime do usuário
     • agora: hora atual (hh:mm) = valor do atributo time/dateTime do usuário

Exemplo de funcionamento

• Configuração:

  • Hora: toda segunda-feira às 10:00
  • Periodicidade: do atributo timeInterval (o usuário escolheu "Seg, Qua, Sex")
  • Condições:
    • Inscrição = true
    • hoje: user.birthday_date = hoje

• Resultado:
  Toda segunda-feira às 10:00, o sistema:

  1. Encontra usuários com inscrição ativa, cujo aniversário é hoje
  2. Verifica se o dia atual (segunda-feira) está dentro do timeInterval deles
  3. Envia uma mensagem de parabéns personalizada

Aplicações práticas

• Resumos semanais de notícias
• Lembretes de inatividade
• Ofertas personalizadas no dia do aniversário
• Notificações em massa programadas de acordo com as preferências do usuário

Exemplos de configuração de eventos

Abaixo estão exemplos de configuração de eventos para cada um dos seis módulos disponíveis.

Catálogo

Formulários

Descontos

Pedidos

Pagamentos

Usuários