Edição de evento

O editor de eventos tem três abas:

• Conditions
• Attributes
• Settings

Conditions

A aba "Conditions" tem os campos para editar o evento: os dados principais, Name e identificador único pelo qual é possível obter a entidade, e as condições de disparo.

Módulos

Nas condições, escolha o módulo que define quando o evento é enviado. Os módulos disponíveis são:

• catalog
• forms
• orders
• users

Condições para o módulo catalog

No módulo catalog, você pode escolher no campo type a filtragem por status (abre em uma nova aba) e depois um status específico. Assim, você se inscreve no evento de alteração de status dos itens do catálogo.
Outra opção é se inscrever no evento por conjuntos de atributos (abre em uma nova aba) e escolher um atributo específico.

Condições para o módulo forms

No módulo forms, escolha o tipo de formulário ao qual o evento será adicionado. As opções são:

• Registration
  O evento é criado quando um novo usuário se registra pela Content API ou no CMS.
• Send Code
  O evento é criado quando um novo código de confirmação é gerado para o usuário (inclusive no registro).
• Change Password
  O evento é criado quando o usuário altera a senha.
• Submit form data
  O evento é criado quando os dados do formulário selecionado são enviados pela API.

Para Submit form data, escolha um formulário (entre os do tipo "Data submission") e o atributo que você adicionou para o e-mail. A inscrição não vale para outros atributos. Quando o formulário é enviado, os dados vão para o e-mail informado nesse atributo.
Para saber mais sobre formulários, consulte o capítulo Forms (abre em uma nova aba).

Todos os eventos do módulo forms incluem informações sobre o usuário. Os eventos Registration e Send Code também trazem o código de confirmação.

Condições para o módulo orders

No módulo orders, escolha um armazenamento de pedidos (abre em uma nova aba) específico e o status (abre em uma nova aba) cuja alteração ficará vinculada ao evento.

Condições para o módulo users

No módulo users, escolha a filtragem por conjuntos de atributos (abre em uma nova aba) e indique o atributo específico cuja alteração ficará vinculada ao evento.

Ao configurar um envio em massa, você pode usar condições especiais:

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

Método de envio

Em todos os módulos, exceto forms, há três métodos de envio da notificação:

1. Push Notification: por notificações push
2. Email: por e-mail
3. Socket IO: por WebSockets (adequado para se inscrever em eventos em tempo real, como uma alteração de preço). Para mais detalhes, consulte a documentação do Socket.IO.

Para quem enviar

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

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

Com que frequência enviar

Nos eventos dos módulos catalog e users, você pode escolher a frequência de envio:

• Once: quando o evento ocorre,
• Every time: sempre que ele ocorrer novamente.

Attributes

A aba "Attributes" tem uma lista suspensa para selecionar um conjunto de atributos (abre em uma nova aba).

Depois de selecionar o conjunto de atributos, preencha os valores. Por exemplo:

• event_send_date (tipo Date and Time)
• event_desc (tipo String)

Você pode usar esses atributos na aba Settings para criar o modelo da mensagem. Eles ficam disponíveis pela chave event:

{{ event.attribute_marker }}

Atributo timeInterval para o agendamento de envios em massa**
Se o conjunto de atributos selecionado tiver um atributo do tipo timeInterval, você pode selecioná-lo nas configurações de agendamento do envio em massa (modo Mailing).
Nesse caso, o envio é feito apenas nos dias indicados no intervalo (por exemplo, só às segundas e sextas).

Settings

A aba "Settings" tem dois campos de texto para criar o modelo da mensagem que os usuários do seu ou aplicativo receberão.

Variáveis disponíveis

Abaixo dos campos aparece a lista de variáveis que você pode inserir no modelo (por exemplo, {{ email }}, {{ user.attribute_marker }} e outras).

Envio em massa para usuários (modo Mailing)

Você pode configurar envios periódicos de e-mail para os usuários que atendem às condições definidas. Ao contrário dos eventos padrão, o envio em massa não é acionado por uma alteração de dados: ele acontece por agendamento, quando as condições são atendidas.

Configuração do envio em massa

1. Crie o evento

   • Tipo de evento: Users
   • Modo de operação: Mailing (envio em massa)

2. Configure o agendamento

   • Time: ponto de partida (por exemplo, segunda-feira às 10:00)
   • Frequency:
     • Diária
     • Semanal
     • Mensal
     • Intervalo personalizado
     • Do atributo timeInterval: se o conjunto de atributos tiver esse atributo, você pode escolhê-lo, e o envio será feito apenas nos dias da semana indicados.

3. Defina as condições de seleção de usuários

   • Exemplos:
     • Data de registro > 2024-01-01
     • Inscrição no envio em massa = true
     • today: data atual = valor do atributo date/dateTime do usuário
     • now: hora atual (hh:mm) = valor do atributo time/dateTime do usuário

Exemplo

• Configuração:

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

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

  1. Encontra os usuários com inscrição ativa que fazem aniversário hoje
  2. Verifica se o dia atual (segunda-feira) está no timeInterval de cada um
  3. Envia a eles uma mensagem de parabéns personalizada

Exemplos de configuração de eventos

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

Catálogo

Formulários

Descontos

Pedidos

Pagamentos

Usuários