Listes de diffusion
Listes de diffusion
Les listes de diffusion (type de document Email Group) rassemblent des destinataires en un ensemble cohérent. Elles servent à cibler un envoi d'e-mails groupé, par exemple une campagne.
Le tableau de bord d'une liste de diffusion centralise les informations essentielles pour évaluer sa composition et surveiller son bon fonctionnement. Il affiche un décompte des destinataires par catégorie, la liste détaillée des membres et l'historique des opérations.
Créer une liste et ajouter des membres
- Ouvrez la liste Liste de diffusion depuis la recherche.
- Cliquez sur + Créer un·e Liste de diffusion et saisissez un Titre, par exemple « Prospects région est ».
- Enregistrez.
- Ajoutez des membres avec le menu d'ajout du formulaire : depuis un type de document (par exemple les contacts), depuis un fichier CSV, depuis une autre liste de diffusion, ou en saisissant des adresses e-mail.
L'import depuis un fichier CSV se fait en arrière-plan. Dokos vous demande la colonne qui contient les adresses, affiche un aperçu, puis un rapport des adresses importées, déjà présentes ou rejetées.
Pour tenir la liste à jour sans intervention, renseignez dans l'onglet Paramètres et critères le Type de document source et les Filtres d'import, puis cochez Mise à jour automatique quotidienne.
Paramètres de la liste
Ces champs sont dans l'onglet Paramètres et critères.
| Champ | Rôle |
|---|---|
| Titre | Nom de la liste. Il sert aussi de nom au document. Obligatoire. |
| Type de liste de diffusion | Service : messages nécessaires à la relation client ou au contrat (informations administratives, opérationnelles ou contractuelles). Marketing (par défaut) : offres, campagnes et lettres d'information, dont le destinataire peut se désinscrire à tout moment. Obligatoire. |
| Base légale par défaut | Base légale de collecte au sens du RGPD : Consentement (opt-in), Intérêt légitime, Nécessité contractuelle ou Héritée - non documentée. Pour une liste Marketing, Dokos impose Consentement (opt-in). |
| Mode de la liste | Statique (par défaut) ou Dynamique. |
| Mise à jour automatique quotidienne | Met la liste à jour chaque jour depuis le Type de document source et ses Filtres d'import. |
| Heure de synchronisation quotidienne | Heure de la mise à jour quotidienne, dans le fuseau horaire du site (06:00 par défaut). |
| Email de confirmation, Email de bienvenue, URL de bienvenue | Modèles d'e-mail et page affichée après l'inscription et la confirmation d'un abonné. |
Le type Héritée (Legacy) est réservé aux listes créées avant cette version. Vous ne pouvez pas créer de liste de ce type.
Le tableau de bord de la liste de diffusion
Le tableau de bord d'une liste de diffusion présente des indicateurs de synthèse, une liste des destinataires actifs et le journal des envois associés.
Les indicateurs de synthèse
Les indicateurs affichés en haut du tableau de bord sont les suivants :
- Total : nombre total d'adresses email présentes dans la liste et visibles par l'utilisateur.
- Actifs : nombre de destinataires dont le statut est actif et qui n'ont pas émis d'opposition à recevoir des communications.
- Désinscrits : nombre d'adresses ayant fait l'objet d'une opposition.
- Génériques : nombre d'adresses identifiées comme génériques.
Les adresses email sont identifiées comme génériques si elles sont rattachées à un rôle fonctionnel (par exemple contact, accueil, support ou facturation) ou si leur origine d'ajout a été qualifiée comme générique. Le tableau de bord repère notamment les préfixes courants correspondant à ces rôles pour les signaler automatiquement.
La liste des destinataires
Le tableau de bord liste les destinataires avec les informations suivantes :
- L'adresse email.
- Le nom et l'image du contact ou de l'utilisateur associé, s'ils existent dans l'application.
- Le statut d'inscription (actif ou désinscrit).
- Le type d'origine (manuel, générique ou rattaché à une source externe) avec les références aux enregistrements d'origine.
- La base légale de collecte et sa source.
- La date d'opposition, le cas échéant.
Filtrer la liste des destinataires
Vous pouvez filtrer la liste affichée par type d'origine, par base légale, par source de base légale ou par type de relation avec l'application (Contact, Utilisateur, Sans rattachement). Utilisez le champ de recherche pour cibler une adresse spécifique ou un nom de référence.
Exporter la liste des destinataires
Pour récupérer la liste des adresses email actives de la liste, cliquez sur le bouton d'exportation à droite de la liste. Vous obtiendrez une liste simple d'adresses exploitable pour un envoi ou un traitement externe.
Le journal des envois
L'onglet Journal des envois affiche les opérations d'envoi rattachées à la liste de diffusion. Il indique le statut et la date de la dernière modification de chaque envoi.
Le journal de synchronisation
L'onglet Journal de synchronisation liste les sources externes associées à la liste de diffusion. Pour chaque source, il affiche le statut de la dernière synchronisation et le résumé de l'opération. Si une synchronisation échoue, le motif de l'erreur est précisé pour faciliter le diagnostic.
Paramètres et critères de la liste de diffusion
Les informations de configuration de la liste de diffusion (titre, type, base légale de collecte, modèle d'accueil, options de mise à jour automatique et sources de synchronisation) sont réunies dans l'onglet Paramètres et critères.
Méthodes d'API publiques
Le tableau de bord repose sur des méthodes d'API publiques que vous pouvez exploiter dans vos développements.
get_dashboard_data
get_dashboard_data(email_group: str, category: str = "All", search: str = "", start: int = 0, page_length: int = 20, legal_basis: str = "", legal_basis_source: str = "", origin_type: str = "", relationship: str = "") -> dict
Renvoie les informations du tableau de bord d'une liste de diffusion. La méthode nécessite la permission de lecture sur la liste passée en argument.
Paramètres :
email_group: nom de la liste de diffusion.category: catégorie de destinataires à afficher (All,Active,Unsubscribed,Generic).search: chaîne de recherche filtrant les adresses email, les noms de contact et d'utilisateur, ainsi que les références des sources.start: index de départ pour la pagination (minimum 0).page_length: nombre de résultats renvoyés (entre 1 et 100).legal_basis: base légale de collecte à filtrer.legal_basis_source: source de la base légale à filtrer.origin_type: type d'origine à filtrer (Manual,Generic, etc.).relationship: type de relation à filtrer (Contact,User,Unlinked).
Valeur renvoyée : un dictionnaire contenant les clés suivantes :
counts: dictionnaire des décomptes (all,active,unsubscribed,generic).failed_sources: nombre de sources externes dont la dernière synchronisation a échoué.sources: liste des sources externes associées à la liste avec leurs informations de synchronisation.newsletters: liste des envois associés à la liste. Les envois viennent de l'application Newsletter, à installer séparément.newsletters_available: booléen indiquant si le type de document Newsletter (application Newsletter) est installé et accessible en lecture.members: page de destinataires correspondant aux critères de filtrage.total: nombre total de destinataires correspondant aux critères.start: index de départ de la page renvoyée.page_length: nombre de résultats par page effectif.
La méthode applique les permissions de lecture de l'utilisateur sur les enregistrements liés. Les sources externes et les oppositions ne sont renvoyées que si l'utilisateur possède la permission de les consulter. Les destinataires sans source lisible ne sont pas inclus dans les résultats.
get_dashboard_emails
get_dashboard_emails(email_group: str) -> list[str]
Renvoie la liste simple des adresses email actives et non désinscrites d'une liste de diffusion. La méthode nécessite la permission de lecture sur la liste passée en argument.