Aller au contenu principal

Introduction

Déclenchez des notifications et des messages automatisés basés sur des événements système.

🎯 Que fait ce module ?​

Le module Events vous permet de configurer des notifications automatisées qui se déclenchent lorsque quelque chose se produit dans votre système - comme l'envoi d'un e-mail lorsqu'un produit est de nouveau en stock, ou une notification push lorsqu'une commande est expédiée.

Considérez-le comme votre système d'automatisation des notifications - vous définissez le déclencheur (ce qui se passe) et l'action (qui est notifié et comment).

📖 Explication Simple​

Imaginez que vous gérez une boutique en ligne et que vous souhaitez tenir les utilisateurs informés :

  • 📦 Commande passée → Envoyer un e-mail de confirmation
  • 🚚 Commande expédiée → Envoyer une notification push avec le suivi
  • ✅ Produit de nouveau en stock → Notifier les utilisateurs qui ont demandé des alertes
  • 💳 Paiement reçu → Envoyer un e-mail de reçu
  • 🎉 Nouvelle promotion → Envoyer un e-mail marketing aux abonnés
  • ⚠️ Mot de passe changé → Envoyer une alerte de sécurité

Au lieu de coder manuellement chaque notification :

  • ✅ Configurez les événements dans le panneau d'administration OneEntry
  • ✅ Définissez les déclencheurs (ce qui se passe)
  • ✅ Configurez les actions (notifications à envoyer)
  • ✅ Personnalisez les messages par événement
  • ✅ Suivez la livraison et l'engagement

Exemple concret :

Sans le module Events (manuel) :
- L'utilisateur s'inscrit → Écrire du code pour envoyer un e-mail ❌
- Produit réapprovisionné → Écrire du code pour notifier les utilisateurs ❌
- Chaque événement nécessite un code personnalisé ❌

Avec le module Events (automatisé) :
- Configurez l'événement "Utilisateur inscrit" → Envoie automatiquement un e-mail de bienvenue ✅
- Configurez l'événement "Produit réapprovisionné" → Notifie automatiquement la liste d'attente ✅
- Tous les événements gérés en un seul endroit ✅

✨ Concepts Clés​

Qu'est-ce qu'un Événement ?​

Un événement est quelque chose qui se produit dans votre système et qui peut déclencher des notifications :

  • Déclencheur - L'action qui démarre l'événement (par exemple, "commande passée")
  • Notification - Ce que les utilisateurs reçoivent (e-mail, push, message socket)
  • Destinataires - Qui est notifié (utilisateurs spécifiques, tous les utilisateurs, admins)
  • Modèle - Le contenu du message

Types d'Événements​

OneEntry prend en charge différents types de déclencheurs :

Type de DéclencheurQuand il se déclencheExemple
Changement de StatutLe statut de l'entité changeProduit : En rupture de stock → En stock
Entité CrééeNouvel élément ajoutéNouvelle commande, nouvelle inscription d'utilisateur
Entité Mise à JourÉlément modifiéProfil mis à jour, statut de commande changé
Déclencheur PersonnaliséDéclencheur manuel depuis le codeNewsletter envoyée, promotion commencée

Canaux de Notification​

Trois façons de notifier les utilisateurs :

CanalDescriptionMeilleur pour
E-mailEnvoyer des messages e-mailConfirmations de commande, reçus, newsletters
Notification PushAlertes mobiles/navigateurMises à jour en temps réel, alertes urgentes
Socket.IOMessages websocket en temps réelMises à jour en direct, chat, synchronisation instantanée

Flux d'Événements​

1. Quelque chose se passe (Déclencheur)
   ↓
2. L'événement détecte le déclencheur
   ↓
3. L'événement vérifie les conditions (le cas échéant)
   ↓
4. L'événement envoie des notifications
   ↓
5. Les utilisateurs reçoivent le message

📋 Ce que Vous Devez Savoir​

Déclencheurs d'Événements Courants​

Événements typiques que vous pourriez configurer :

E-commerce :

  • Commande passée
  • Commande expédiée
  • Commande livrée
  • Paiement reçu
  • Produit de nouveau en stock
  • Alerte de baisse de prix

Gestion des Utilisateurs :

  • Utilisateur inscrit
  • E-mail vérifié
  • Mot de passe changé
  • Profil mis à jour
  • Compte supprimé

Contenu :

  • Nouvel article publié
  • Commentaire ajouté
  • Contenu approuvé
  • Abonnement renouvelé

Variables de Modèle​

Utilisez des espaces réservés dans les modèles de notification

📊 Tableau de Référence Rapide - Méthodes Courantes​

MéthodeCe qu'elle fait
getAllSubscriptions()Obtenir toutes les abonnements
subscribeByMarker()S'abonner à un événement spécifique par marqueur
unsubscribeByMarker()Se désabonner d'un événement spécifique par marqueur

Remarque : Les événements sont configurés dans le panneau d'administration OneEntry. Le SDK est en lecture seule - utilisez-le pour récupérer des informations sur les événements, pas pour créer des événements.

❓ Questions Fréquemment Posées (FAQ)​

Comment créer ou modifier des événements ?​

Les événements sont gérés dans le panneau d'administration OneEntry :

  1. Connectez-vous à l'administration OneEntry
  2. Allez dans la section Événements
  3. Créez ou modifiez des événements
  4. Configurez les déclencheurs, canaux et modèles
  5. Activez l'événement

Le SDK est en lecture seule - utilisez-le pour récupérer des informations sur les événements, pas pour créer des événements.

Quelle est la différence entre Notification Push et Socket.IO ?​

Notification Push - Envoyée à l'appareil (fonctionne même lorsque l'application est fermée)

  • Apparaît dans le centre de notifications

  • L'utilisateur peut appuyer pour ouvrir l'application

  • Meilleur pour : Alertes importantes, rappels

  • Socket.IO - Message websocket en temps réel (uniquement lorsque l'application est ouverte)

    • Livraison instantanée aux clients connectés
    • Mises à jour en direct sans actualisation
    • Meilleur pour : Données en direct, chat, collaboration

Puis-je déclencher manuellement un événement depuis mon code ?​

Le SDK ne prend pas en charge les déclencheurs manuels. Les événements se déclenchent automatiquement en fonction des déclencheurs configurés dans OneEntry.

Puis-je personnaliser les modèles d'e-mail ?​

Oui ! Dans le panneau d'administration OneEntry :

  • Modèles d'e-mail HTML
  • Style personnalisé
  • Support multilingue
  • Test avant activation

Que se passe-t-il si un événement échoue à s'envoyer ?​

OneEntry gère les réessais et la journalisation :

  • Les e-mails échoués sont mis en file d'attente pour réessai
  • Les notifications push échouées sont enregistrées
  • Vérifiez les journaux d'événements dans le panneau d'administration
  • Configurez des options de secours

Puis-je utiliser du contenu riche dans les notifications ?​

  • E-mail - Support HTML complet (images, liens, style)
  • Notification Push - Titre + texte du corps + image optionnelle
  • Socket.IO - Toute structure de données JSON

Quelle est la différence entre Événement et Soumission de Formulaire ?​

  • Événements - Notifications automatisées déclenchées par le système
  • Formulaires - Données soumises par l'utilisateur que vous collectez

Exemple :

  • Événement : "Utilisateur inscrit" → Envoi automatique d'un e-mail de bienvenue
  • Formulaire : L'utilisateur remplit un formulaire de contact → Vous recevez la soumission

💡 Notes Importantes​

📬 Canaux de Notification​

Dans la plateforme OneEntry, il existe trois façons d'interagir avec les utilisateurs de votre système via le module "Events" :

  • 📧 E-mail - Envoyer des messages e-mail avec un contenu HTML riche
  • 📱 Notification Push - Envoyer des alertes en temps réel sur mobile/navigateur
  • 🔌 Socket.IO - Envoyer des messages websocket instantanés aux clients connectés

Les Événements sont en Lecture Seule dans le SDK​

Rappelez-vous : Le SDK est pour lire les événements, pas pour les créer.

Convention de Nommage des Événements​

Utilisez des marqueurs clairs et descriptifs :

✅ Bons marqueurs :
- order_confirmed
- product_back_in_stock
- user_registered
- payment_failed
- password_reset_requested

❌ Mauvais marqueurs :
- event1
- notification
- email_event
- test

🎓 Meilleures Pratiques​

  • Utilisez des marqueurs d'événements descriptifs
  • Testez les événements avant de les activer
  • Fournissez des valeurs de secours pour les variables
  • Surveillez régulièrement les journaux d'événements
  • Désactivez les événements inutilisés
  • Utilisez des canaux appropriés (e-mail pour les reçus, push pour l'urgence)
  • Localisez les messages d'événements
  • Gérez les événements manquants/désactivés avec soin

Plus d'informations sur l'interface utilisateur du module https://doc.oneentry.cloud/docs/events/introduction

Définition du module Events​


const { Events } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

🔗 Documentation Connexe​