Modifier un événement

La modification d'un événement comporte trois onglets :

• Conditions
• Attributes
• Settings

Conditions

L'onglet "Conditions" contient les champs de modification de l'événement : ses données principales, Name et identifiant unique permettant d'obtenir l'entité, ainsi que les conditions de déclenchement.

Modules

Dans les conditions, choisissez le module qui détermine la condition d'envoi de l'événement. Modules disponibles :

• catalog
• forms
• orders
• users

Conditions pour le module catalog

Pour le module catalog, vous pouvez choisir dans le champ type un filtrage par statuts (s'ouvre dans un nouvel onglet), puis un statut précis : vous vous abonnez ainsi à l'événement de changement de statut des éléments du catalogue.
Vous pouvez aussi vous abonner à un événement par ensembles d'attributs (s'ouvre dans un nouvel onglet) et choisir un attribut précis.

Conditions pour le module forms

Pour le module forms, choisissez le type de formulaire auquel ajouter l'événement. Options disponibles :

• Registration
  L'événement est créé lorsqu'un nouvel utilisateur s'inscrit via la Content API ou dans le CMS.
• Send Code
  L'événement est créé lorsqu'un nouveau code de confirmation est généré pour l'utilisateur (y compris à l'inscription).
• Change Password
  L'événement est créé lorsque l'utilisateur change son mot de passe.
• Submit form data
  L'événement est créé lorsque les données du formulaire sélectionné sont envoyées via l'API.

Pour Submit form data, choisissez un formulaire (parmi ceux de type "Data submission") et l'attribut que vous avez ajouté pour l'adresse e-mail (cet abonnement ne s'applique pas aux autres attributs). À l'envoi du formulaire, les données sont envoyées à l'adresse indiquée dans cet attribut.
Pour en savoir plus sur les formulaires, consultez le chapitre Forms (s'ouvre dans un nouvel onglet).

Tous les événements du module forms contiennent des informations sur l'utilisateur. Les événements Registration et Send Code contiennent aussi le code de confirmation.

Conditions pour le module orders

Pour le module orders, choisissez un stockage de commandes (s'ouvre dans un nouvel onglet) précis et le statut (s'ouvre dans un nouvel onglet) au changement duquel l'événement sera lié.

Conditions pour le module users

Pour le module users, choisissez un filtrage par ensembles d'attributs (s'ouvre dans un nouvel onglet) et indiquez l'attribut au changement duquel l'événement sera lié.

Lorsque vous configurez un envoi groupé, vous pouvez utiliser des conditions spéciales :

• today : vérifie que la date actuelle correspond à la date de l'attribut de type date ou dateTime de l'utilisateur.
• now : vérifie que l'heure actuelle (heures et minutes) correspond à la valeur de l'attribut de type time ou dateTime.

Mode d'envoi

Pour tous les modules sauf forms, trois modes d'envoi de la notification sont disponibles :

1. Push Notification : notifications push
2. Email : envoi par e-mail
3. Socket IO : via WebSockets (adapté à l'abonnement aux événements en temps réel, par exemple un changement de prix). Pour en savoir plus, consultez la documentation de Socket.IO.

Destinataires

Pour le module catalog, vous pouvez choisir les destinataires de la notification :

• tous les utilisateurs de votre ou application,
• ou un groupe d'utilisateurs précis.

Fréquence d'envoi

Pour les événements des modules catalog et users, vous pouvez choisir la fréquence d'envoi :

• Once : lorsque l'événement se produit,
• Every time : à chaque nouveau déclenchement.

Attributes

L'onglet "Attributes" contient une liste déroulante pour choisir un ensemble d'attributs (s'ouvre dans un nouvel onglet).

Une fois l'ensemble d'attributs choisi, renseignez les valeurs. Par exemple :

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

Vous pouvez utiliser ces attributs dans l'onglet Settings pour créer un modèle de message. Ils sont accessibles via la clé event :

{{ event.attribute_marker }}

Attribut timeInterval pour la planification des envois groupés**
Si l'ensemble d'attributs sélectionné contient un attribut de type timeInterval, vous pouvez le choisir dans les paramètres de planification de l'envoi groupé (mode Mailing).
Dans ce cas, l'envoi n'a lieu que les jours indiqués dans l'intervalle (par exemple, uniquement le lundi et le vendredi).

Settings

L'onglet "Settings" contient deux champs de texte pour créer le modèle du message que recevront les utilisateurs de votre ou application.

Variables disponibles

La liste des variables que vous pouvez insérer dans le modèle s'affiche sous les champs de saisie (par exemple, {{ email }}, {{ user.attribute_marker }}, etc.).

Envoi groupé aux utilisateurs (mode Mailing)

Vous pouvez configurer des envois d'e-mails périodiques aux utilisateurs qui remplissent les conditions définies. Contrairement aux événements standard, l'envoi ne se déclenche pas lors d'une modification des données : il a lieu selon un calendrier, si les conditions sont remplies.

Configuration de l'envoi groupé

1. Créez l'événement

   • Type d'événement : Users
   • Mode : Mailing (envoi groupé)

2. Configurez le calendrier

   • Time : point de départ (par exemple, lundi 10:00)
   • Frequency :
     • Quotidienne
     • Hebdomadaire
     • Mensuelle
     • Intervalle personnalisé
     • À partir de l'attribut timeInterval : si l'ensemble d'attributs contient un tel attribut, vous pouvez le sélectionner ; l'envoi n'a alors lieu que les jours de la semaine indiqués.

3. Définissez les conditions de sélection des utilisateurs

   • Exemples :
     • Date d'inscription > 2024-01-01
     • Abonnement à la newsletter = true
     • today : date actuelle = valeur de l'attribut date/dateTime de l'utilisateur
     • now : heure actuelle (hh:mm) = valeur de l'attribut time/dateTime de l'utilisateur

Exemple

• Configuration :

  • Time : chaque lundi à 10:00
  • Frequency : à partir de l'attribut timeInterval (l'utilisateur a choisi « Lun, Mer, Ven »)
  • Conditions :
    • Abonnement = true
    • today : user.birthday_date = aujourd'hui

• Résultat :
  Chaque lundi à 10:00, le système :

  1. Trouve les utilisateurs ayant un abonnement actif dont c'est l'anniversaire aujourd'hui
  2. Vérifie si le jour actuel (lundi) fait partie de leur timeInterval
  3. Leur envoie un message d'anniversaire personnalisé

Exemples de configuration d'événements

Voici des exemples de configuration d'événements pour chacun des six modules disponibles.

Catalogue

Formulaires

Remises

Commandes

Paiements

Utilisateurs