Suivre une campagne de messages

Pour :Administrateur

Vue de la page « suivre une campagne message »

La page détail d'une campagne vous permet de visualiser où en sont les envois, destinataire par destinataire, après qu'une campagne a été validée.

Route : /app/messages/detail?id=<id-campagne>

Comment y accéder : depuis la liste /app/messages/campagnes, cliquer sur le bouton Voir le détail des envois (icône oeil bleu) sur la ligne d'une campagne en statut Validé.

À quoi sert cette page

La page de détail répond à trois questions :

• « Mon message est-il bien parti ? » → la barre KPI Total Envoyé vous le dit en un coup d'oeil.
• « Qui n'a pas reçu et pourquoi ? » → l'onglet Échoué liste les erreurs avec le message technique associé.
• « Mes contacts ont-ils ouvert l'email ? » → la colonne Vues indique le nombre d'ouvertures par destinataire (uniquement pour les emails).

Anatomie de la page

La page est composée de trois zones :

1. Bloc Informations de la campagne (en haut) : récapitulatif de ce qui a été envoyé.
2. Bloc KPI (au milieu) : trois compteurs globaux.
3. Tableau Détail des envois (en bas) : la liste destinataire par destinataire.

Bloc Informations de la campagne

Affiché en haut, ce bloc récapitule :

Champ	Contenu
Date de création	Quand la campagne a été créée (Créée le 12 mai 2026 à 14:30)
Canal	Tag du canal (Email, SMS, WhatsApp, etc.)
Statut	Tag du statut courant (voir ci-dessous)
Destinataires	Nombre total de cibles
Catégories ciblées	Tags des catégories utilisées au ciblage
Contenu du message	Texte du message envoyé (zone scrollable si long)
Modèle d'email utilisé	Aperçu du template si la campagne a utilisé un modèle

Les tags de statut possibles

Tag	Signification
Brouillon (gris)	Statut INIT — vous ne devriez pas voir le détail dans ce cas (le bouton n'est pas affiché)
Validé (bleu)	L'envoi a été déclenché. Ce statut ne change pas après la fin des envois : la campagne reste à Validé indéfiniment. La progression réelle se lit dans le tableau Détail et dans les KPI.
Programmé pour le JJ/MM/AAAA HH:mm (violet)	La campagne est validée mais en attente d'une date future
Connexion requise (orange)	Campagne WhatsApp sans compte WhatsApp Business connecté — il faut scanner le QR code depuis la liste

Bloc KPI

Trois compteurs en cartes colorées :

KPI	Calcul
Total	Nombre total d'envois prévus = nombre de destinataires de la campagne
Total Envoyé	Nombre d'envois dont le statut est différent de INIT (c'est-à-dire SUCCESS + ERROR) — autrement dit, ce qui a été traité, quel que soit le résultat
Total Vu	Nombre d'envois dont le compteur de vues (seen) est supérieur à zéro — uniquement pour les emails, basé sur le pixel de tracking

Exemple :

KPI	Valeur	Interprétation
Total	250	La campagne ciblait 250 contacts
Total Envoyé	245	245 envois ont été traités (envoyés OU en erreur). 5 sont peut-être encore INIT ou planifiés.
Total Vu	138	138 personnes ont ouvert l'email au moins une fois

ℹ

Le tracking d'ouvertures s'applique uniquement aux emails

Unisoft injecte un pixel de tracking (image invisible 1×1 pixel) dans chaque email envoyé. Quand le destinataire ouvre l'email, son client mail télécharge l'image — ce qui permet de compter une « ouverture ». Cette technique :

• Ne fonctionne pas pour les SMS et WhatsApp.
• Peut sous-estimer les ouvertures réelles : certains clients mails (Apple Mail iOS depuis 2021, certains comptes pro) bloquent les pixels par défaut.
• Peut sur-estimer : un même destinataire qui ouvre 3 fois l'email compte pour 3 vues.

Tableau Détail des envois

C'est le coeur de la page. Il liste chaque envoi individuellement (un par destinataire, par canal).

Filtre par statut de l'envoi

Trois onglets en haut du tableau permettent de filtrer :

Onglet	Statut backend	Signification
Envoyé	SUCCESS	L'envoi a réussi — le destinataire a reçu le message
En cours	INIT	L'envoi est en attente de traitement par le worker (rare en pratique, sauf juste après validation)
Échoué	ERROR	L'envoi a échoué — voir la colonne Description pour la raison

Chaque onglet affiche le compteur entre parenthèses (Envoyé (245), Échoué (5)).

Les colonnes du tableau

Colonne	Contenu
Date de création	Quand l'envoi a été créé (généralement = date de validation de la campagne)
Date d'envoi	Quand l'envoi a effectivement été traité par le worker. - si pas encore parti.
Contact	Nom + prénom du destinataire. - si l'envoi est rattaché à un contact virtuel sans fiche.
Téléphone	Numéro de téléphone utilisé (pour SMS / WhatsApp)
Email	Adresse email utilisée (pour Email)
Description	Vide pour les envois réussis. Pour les envois en erreur (ERROR), affiche le message technique de la cause d'échec en rouge.
Canal	Tag du canal effectif utilisé. Utile pour les campagnes mixtes (SMS / Email) — vous voyez quel canal a été choisi pour chaque contact.
Vues	Nombre d'ouvertures détectées (emails uniquement). Tag vert avec checkmark si > 0, vide sinon.
Contenu	Aperçu du contenu envoyé (100 premiers caractères du message, ou tag Modèle d'email si un template a été utilisé).

Les causes d'erreur fréquentes

Pour les envois en ERROR, la colonne Description affiche le message d'erreur en clair. Causes courantes :

Message d'erreur	Cause	Action recommandée
L'adresse email <...> est incorrect	Format d'email invalide (typo, manque @, etc.)	Corriger l'adresse sur la fiche du contact
L'adresse email <...> s'est désinscrite	Le contact s'est désabonné de vos emails	Aucune action — c'est volontaire. Voir Désabonnement aux emails
Message SMS générique	Problème opérateur ou format GSM-7	Vérifier le numéro et le contenu

Ce que la page ne fait pas

⚠

Pas d'action depuis la page détail

La page de détail est en lecture seule. Vous ne pouvez pas :

• Renvoyer aux non-ouvreurs depuis cette vue. Pour relancer, créez une nouvelle campagne ciblée sur les contacts à relancer (vous pouvez constituer une catégorie temporaire à partir de l'export de la première campagne).
• Exporter les résultats en CSV depuis cette vue. Pour archiver les statuts, copiez le tableau ou créez une demande d'export via une autre voie.
• Renvoyer un message à un destinataire en erreur. Si vous corrigez son email, la prochaine campagne enverra correctement, mais celle-ci ne sera pas rejouée.
• Annuler un envoi en cours. Une fois validée, la campagne suit son cours.

Cas particuliers

• Campagne programmée non encore partie : le tag de statut affiche Programmé pour le 15/05/2026 14:00. Le tableau Détail est vide (aucun envoi créé tant que la date n'est pas atteinte). Les KPI sont à zéro.
• Campagne en cours d'envoi : l'onglet En cours affiche les envois qui n'ont pas encore été traités par le worker. Rafraîchissez la page périodiquement pour suivre la progression.
• Doublon de vues : si un destinataire ouvre l'email 5 fois, le KPI Total Vu ne compte que 1 ouvreur (basé sur seen > 0), mais la colonne Vues de sa ligne affichera 5.
• Email réémis par le serveur du destinataire : certains serveurs réémettent les images avec un délai. Une ouverture peut être détectée plusieurs heures après l'envoi réel.

Articuler avec la liste des campagnes

Pour revenir à la liste, cliquez sur le bouton Retour aux campagnes en haut à gauche de la page (au-dessus du titre).

Le fil d'Ariane vous indique également votre position :

Campagnes de messages > Détail de la Campagne

Pour aller plus loin

• Liste des campagnes — la vue d'ensemble
• Créer une campagne — le workflow de création détaillé
• Désabonnement aux emails — comprendre les erreurs de désabonnement