Créer une campagne de messages

Pour :Administrateur

Vue de la page « creer une campagne message »

Cette page documente le workflow de création d'une campagne email, SMS ou WhatsApp depuis le module Campagnes de Messages.

Route : /app/messages/campagnes → bouton Créer une Campagne

En deux temps

Important à comprendre dès le départ : la création se fait en deux temps distincts :

1. Créer la campagne (cette page) : vous remplissez un formulaire, vous validez → la campagne est enregistrée en Brouillon. Rien n'est encore envoyé.
2. Valider et envoyer : depuis la liste, cliquez sur le bouton Valider et envoyer (icône envoi vert) sur la ligne de la campagne. C'est ce clic qui déclenche réellement l'envoi (ou la programmation).

Cette séparation permet de préparer une campagne tranquillement, de la revoir, de la modifier, puis de la lancer une fois prêt(e).

Le formulaire en quatre blocs

Le formulaire est structuré en quatre sections séparées par des séparateurs visuels :

1. Cibles : qui recevra le message
2. Contenu du Message : ce qui sera envoyé
3. Contenu Supplémentaire : liens, documents, vidéos
4. Planification : quand l'envoi sera lancé

Bloc 1 — Cibles

Choisir le canal

Le Canal est la première chose à choisir : c'est ce qui détermine la suite du formulaire (champ Objet du mail pour EMAIL, limite GSM-7 pour SMS, etc.).

Les options disponibles dépendent de la configuration de votre organisation :

Canal	Conditions
Email	Disponible si votre organisation a configuré au moins un expéditeur email
SMS	Disponible si votre organisation a souscrit au quota SMS
WhatsApp	Disponible si votre organisation a connecté un compte WhatsApp Business
SMS / Email	Si email et SMS sont actifs — Unisoft choisit le canal disponible pour chaque contact (email si l'adresse existe, fallback SMS sinon)
WhatsApp / SMS	Si WhatsApp et SMS sont actifs — essaie WhatsApp, retombe sur SMS si le contact n'est pas joignable sur WhatsApp
WhatsApp / SMS / Email	Cascade complète — essaie WhatsApp puis SMS puis email, selon ce qui est disponible pour chaque contact

ℹ

Combinaisons disponibles selon votre configuration

Les canaux combinés (SMS / Email, WhatsApp / SMS, WhatsApp / SMS / Email) n'apparaissent dans le sélecteur que si chaque canal de la combinaison est actif sur votre organisation. Si un seul des trois est manquant, la combinaison correspondante est masquée.

ℹ

Un seul canal visible dans le sélecteur ?

Si vous ne voyez qu'un seul canal (par exemple uniquement Email), c'est que les autres ne sont pas configurés au niveau de votre organisation. Demandez à un administrateur de votre organisation d'ajouter la configuration SMS ou WhatsApp dans Mon compte → Mon organisation.

Cibler les destinataires

Vous avez deux modes de ciblage :

Option A — Envoyer à tous mes contacts

Cochez la case Envoyer à tous mes contacts. Le champ Catégories devient grisé et inutilisable. Le Nombre de Contact affiché en dessous est le total de votre base (contacts qui ont au moins un email pour une campagne Email, ou un téléphone pour SMS/WhatsApp).

Option B — Filtrer par catégories

Décochez Envoyer à tous mes contacts. Le champ Catégories s'active. Tapez ou sélectionnez une ou plusieurs catégories de contacts. Chaque catégorie ajoutée recalcule en direct le Nombre de Contact.

Exemple : sélectionner les catégories Donateurs réguliers et Membres du bureau → le compteur affichera 124 contacts (la somme des deux catégories sans doublon).

★

Préparez vos catégories en amont

Le ciblage par catégories suppose que vos contacts sont bien étiquetés dans votre base. Si vous voulez envoyer une campagne Bénévoles inscription Pessah, créez la catégorie en amont sur le module Contacts et ajoutez-y les contacts concernés, puis cible-la dans la campagne. Voir Catégories et tags.

Le compteur de destinataires

En dessous du champ Catégories, vous voyez en permanence :

Nombre de Contact : 87

Ce nombre est calculé en temps réel par le backend à chaque modification de votre ciblage. Il tient compte :

• Des contacts ayant un canal compatible (email valide pour Email, téléphone pour SMS/WhatsApp).
• Des désabonnés : un contact qui s'est désabonné des emails est exclu du compteur Email.
• Des doublons : un même contact dans deux catégories sélectionnées n'est compté qu'une fois.

Le nombre affiché ici est le nombre réel qui recevra le message.

Bloc 2 — Contenu du Message

Variables insérables

Au-dessus du champ Message, trois tags cliquables bleus vous permettent d'insérer une variable de personnalisation à la position du curseur :

Variable	Sera remplacée par
Nom	Le nom de famille du contact, avec majuscule initiale
Prénom	Le prénom du contact, avec majuscule initiale
Prénom Hébraïque	Le prénom hébraïque du contact (champ prenomHE de sa fiche)

Au clic, la variable correspondante est ajoutée au texte sous sa forme technique ({{prenom}}, {{nom}}, {{prenomHE}}).

Exemple de message :

Cher {{prenom}},

Nous avons le plaisir de vous inviter à l'inauguration
de notre nouvelle salle d'étude ce dimanche à 18 h.

Au plaisir de vous y retrouver,
L'équipe Unisoft

À l'envoi, le contact David Cohen recevra : « Cher David, … ».

⚠

Variable vide = chaîne vide

Si un contact n'a pas de prénom renseigné, {{prenom}} sera remplacé par une chaîne vide (pas par un texte par défaut). Le message commencera alors par : « Cher , … ». Vérifiez la qualité des coordonnées avant un envoi de masse, ou évitez les formules trop personnalisées si la base est incomplète.

Pour la liste complète des variables disponibles selon le contexte (campagne, formulaire, paiement), voir Variables des modèles d'email.

Rédiger le message

Le champ Message est une zone de texte libre. Les contraintes dépendent du canal :

Canal	Contraintes
Email	Pas de limite de caractères, ni de format. HTML possible si vous utilisez un modèle.
SMS	Au-delà d'un message court, votre opérateur découpe le texte en plusieurs segments facturés à l'unité (généralement 160 caractères par segment en alphabet GSM-7, ou 70 caractères en Unicode si le message contient des emojis ou caractères spéciaux). Le système indique le coût en segments avant validation — vérifiez-le pour éviter une consommation inattendue.
WhatsApp	Pas de limite de caractères, formatage WhatsApp simple supporté (gras avec *texte*, italique avec _texte_).

ℹ

GSM-7 vs Unicode pour les SMS

Le format GSM-7 est l'alphabet standard des SMS courts. Il accepte les lettres latines (avec quelques accents européens : à, è, é, ù, ì, ò, ä, ö, ü, ñ), les chiffres et la ponctuation courante. Si votre message contient des emojis ou des caractères spéciaux (hors GSM-7), il bascule automatiquement en Unicode, ce qui réduit la taille d'un segment de 160 à 70 caractères et augmente le coût. Vérifiez le compteur de segments avant de valider.

Objet du Mail (si canal Email)

Apparaît uniquement si le canal contient EMAIL. Champ requis : c'est le sujet qui s'affichera dans la boîte de réception.

Bonne pratique : un objet court (50-60 caractères max) et clair, qui donne envie d'ouvrir.

Exemples :

• ✅ « Office de Roch Hachana — horaires et inscriptions »
• ❌ « Newsletter mensuelle de votre communauté pour le mois de Tichri 5786 »

Modèle d'email (si canal Email)

Champ optionnel. Permet de sélectionner un modèle d'email créé à l'avance dans le module Modèles d'email (/app/templates/email).

Si un modèle est choisi :

• Le contenu HTML du modèle est utilisé pour l'envoi à la place du champ Message brut.
• Le champ Message peut rester vide.

Voir Modèles d'email pour créer et gérer vos templates.

Expéditeur Email

Apparaît uniquement si plusieurs adresses email d'envoi sont configurées sur votre organisation. Permet de choisir avec quelle adresse la campagne sera envoyée (ex : contact@exemple-unisoft.org vs tresorerie@exemple-unisoft.org).

Bloc 3 — Contenu Supplémentaire

Liens Web

Cliquez sur Ajouter un lien Web. Une fenêtre s'ouvre avec deux champs :

• Nom du lien : libellé qui apparaîtra dans le message (ex : Page d'inscription).
• URL : l'adresse complète (https://...).

Les liens ajoutés sont automatiquement insérés en bas du message à l'envoi, sous forme cliquable.

Cas d'usage : pointer vers une page de don, un formulaire d'inscription, un agenda public.

Documents

Disponible pour Email et WhatsApp (pas pour SMS).

Cliquez sur Ajouter un document. Vous pouvez glisser-déposer un fichier au format PDF ou image (JPG, PNG, etc.).

Les documents sont attachés à l'email ou envoyés en pièce jointe WhatsApp.

Cas d'usage : convocation d'assemblée, ordre du jour, plaquette d'événement.

Vidéos

Disponible pour Email et WhatsApp (pas pour SMS).

Cliquez sur Ajouter une vidéo. Glissez-déposez un fichier vidéo.

⚠

Attention au poids des pièces jointes

Les opérateurs email et WhatsApp imposent des limites de taille (généralement 10 à 25 Mo par message). Une vidéo lourde peut être bloquée par certains serveurs de réception et faire échouer l'envoi pour les destinataires concernés. Préférez héberger la vidéo ailleurs (YouTube, Vimeo) et envoyer un lien.

Bloc 4 — Planification

Programmer l'envoi (optionnel)

Champ DatePicker au format JJ/MM/AAAA HH:mm.

• Si vide : la campagne sera envoyée immédiatement après que vous aurez cliqué sur Valider et envoyer dans la liste.
• Si renseigné : la campagne attendra la date et l'heure précisées avant de partir.

Cas d'usage typique : préparer aujourd'hui un message anniversaire qui partira dimanche matin à 9 h.

★

Pensez aux différences de fuseaux horaires

La date programmée utilise le fuseau de votre navigateur. Si votre organisation a des contacts à l'international, un envoi programmé à 9 h heure de Paris arrivera à 3 h du matin à New York. Préférez 14 h-16 h heure de Paris pour atteindre la plupart des destinataires en journée.

Enregistrer la campagne

Cliquez sur Enregistrer en bas du formulaire.

La campagne est créée en statut Brouillon (INIT). Elle apparaît dans la liste avec une délivrabilité — (rien n'est encore parti).

Valider et envoyer

Depuis la liste /app/messages/campagnes, repérez votre Brouillon. Dans la colonne Actions, cliquez sur le bouton Valider et envoyer (icône envoi vert).

Ce qui se passe alors :

1. La campagne passe en statut Validé (VALIDATE).
2. Le backend Unisoft génère un enregistrement d'envoi par destinataire (un par contact ciblé).
3. Si une planification est définie, l'envoi attend la date prévue ; sinon il démarre immédiatement.
4. Un worker asynchrone traite les envois un par un :
   • Pour les emails : envoi via l'expéditeur configuré.
   • Pour les SMS : envoi via le service télécom Unisoft.
   • Pour WhatsApp : envoi via votre compte WhatsApp Business connecté.
5. À mesure que les envois se terminent, le statut de chaque destinataire passe en SUCCESS ou ERROR.
6. La campagne reste en statut Validé (VALIDATE) même une fois que tous les envois sont traités. Il n'y a pas de bascule vers un statut « Terminé » : la progression se lit dans les statistiques (KPI et onglets) de la page détail.

Vous pouvez suivre la progression depuis le bouton Voir le détail des envois sur la ligne de la campagne. Voir Suivre une campagne.

Modifier une campagne avant validation

Tant que la campagne est en Brouillon, vous pouvez :

• Cliquer sur le bouton Modifier (icône crayon) sur sa ligne.
• Ajuster n'importe quel champ (cibles, contenu, planification).
• Réenregistrer.

Une fois la campagne Validée, elle n'est plus modifiable — il faut supprimer et recréer.

Cas particuliers

• Contact sans email : exclu automatiquement d'une campagne Email. N'apparaît pas dans le compteur de destinataires.
• Contact sans téléphone : exclu automatiquement d'une campagne SMS ou WhatsApp.
• Contact désabonné : si un contact s'est désabonné de vos emails (voir Désabonnement aux emails), il est exclu automatiquement de toute campagne Email future, sans aucune action de votre part.
• Campagne SMS avec emoji : sera rejetée à l'enregistrement (format GSM-7). Retirez les emojis ou choisissez le canal WhatsApp.
• Campagne WhatsApp sans compte connecté : la campagne peut être créée et validée, mais l'envoi échouera tant que vous n'aurez pas scanné le QR code de connexion WhatsApp Business (bouton orange dans la liste).

Pour aller plus loin

• Suivre une campagne — la page de détail (statistiques, statuts par destinataire)
• Modèles d'email — pour préparer des templates email réutilisables
• Variables des modèles d'email — la liste complète des variables disponibles
• Désabonnement aux emails — comment Unisoft respecte les désinscriptions