Outils

Listes de diffusion

Gérez des listes de diffusion (Email Group) pour vos destinataires, avec leur type, leur base légale et leurs sources de mise à jour.

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

  1. Ouvrez la liste Liste de diffusion depuis la recherche.
  2. Cliquez sur + Créer un·e Liste de diffusion et saisissez un Titre, par exemple « Prospects région est ».
  3. Enregistrez.
  4. 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.

Pour tenir la liste à jour sans intervention, passez-la en mode Dynamique, ajoutez-lui une source (type de document et filtres) et cochez Mise à jour automatique quotidienne dans l'onglet Paramètres et critères. Voir Synchroniser une liste dynamique.

Écrire à la liste de diffusion

Vous pouvez rédiger un e-mail adressé aux membres éligibles d'une liste, directement depuis son formulaire. Les adresses sont placées en Cci : les destinataires ne voient pas les adresses des autres membres.

Prérequis : la liste est enregistrée, vous avez la permission Email sur la liste de diffusion, et un compte e-mail sortant est configuré.

Écrire à tous les membres éligibles

  1. Ouvrez la liste de diffusion et cliquez sur Écrire à la liste.
  2. Dokos ouvre la fenêtre de rédaction avec toutes les adresses éligibles en Cci.
  3. Rédigez le message et envoyez-le.

Une adresse est éligible si le membre est actif, si l'adresse est valide, et si le membre ne s'est pas désinscrit (désinscription globale, de la liste ou du type de liste). Les adresses génériques sont incluses.

Si aucun membre n'est éligible, Dokos affiche l'alerte « Aucune adresse e-mail éligible » et n'ouvre pas la fenêtre de rédaction.

Écrire à une partie des membres

  1. Cliquez sur Action > Copier les adresses.
  2. Dans la section Destinataires du message, cochez les adresses voulues. Tout sélectionner coche toutes les adresses éligibles.
  3. Cliquez sur Écrire à la liste dans Dokos. Seules les adresses cochées sont placées en Cci.
  4. Pour changer la sélection depuis la fenêtre de rédaction, cliquez sur le bouton Modifier les destinataires, sur la ligne des destinataires en copie cachée. La fenêtre Modifier les destinataires du message s'ouvre : cochez les adresses puis cliquez sur Mettre à jour les destinataires.

Si vous n'avez coché aucune adresse, Dokos affiche l'alerte No email addresses selected (libellé non traduit) et n'ouvre pas la fenêtre de rédaction. Si une adresse cochée n'est plus éligible au moment de l'envoi (par exemple parce que le membre s'est désinscrit entre-temps), Dokos refuse l'opération avec le message « Une ou plusieurs adresses sélectionnées ne sont plus éligibles. Actualisez la liste. » Actualisez alors la liste et recommencez.

Si Dokos ne peut pas charger les adresses, il affiche le message d'erreur reçu, ou à défaut « Impossible de charger les adresses e-mail éligibles. »

Aucun compte e-mail sortant

Si aucun compte e-mail sortant n'est configuré, l'envoi depuis une liste de diffusion est refusé avec le message Unable to send mail because no outgoing email account is configured. (libellé non traduit). Si vous avez le droit de lire les comptes e-mail, le message contient un lien Email Accounts (libellé non traduit) vers la liste des comptes e-mail : configurez-y un compte sortant par défaut, puis renvoyez le message. Sans ce droit, demandez la configuration à un administrateur.

Exemple fictif : la liste « Prospects région est » compte 120 membres, dont 4 désinscrits. Vous cliquez sur Écrire à la liste : la fenêtre de rédaction s'ouvre avec 116 adresses en Cci. Pour n'écrire qu'à deux contacts, vous passez par Action > Copier les adresses, vous cochez a.martin@exemple.test et b.durand@exemple.test, puis vous cliquez sur Écrire à la liste dans Dokos : seules ces deux adresses sont en Cci.

Paramètres de la liste

Ces champs sont dans l'onglet Paramètres et critères.

ChampRôle
TitreNom de la liste. Il sert aussi de nom au document. Obligatoire.
Type de liste de diffusionService : 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éfautBase 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 listeStatique (par défaut) ou Dynamique. Le menu Action > Synchroniser maintenant n'est proposé que pour une liste Dynamique.
Mise à jour automatique quotidienneMet la liste à jour chaque jour à partir de ses sources dynamiques.
Heure de synchronisation quotidienneHeure de la mise à jour quotidienne, dans le fuseau horaire du site (06:00 par défaut).
Email de confirmation, Email de bienvenue, URL de bienvenueModè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.

Pour retirer des membres d'une liste Service, Dokos vous demande un motif.

Synchroniser une liste dynamique

Une liste en mode Dynamique se remplit à partir de ses sources. Une source est un type de document (par exemple Client) accompagné de filtres : la synchronisation ajoute à la liste les adresses des documents qui répondent aux filtres. Elle s'exécute chaque jour si Mise à jour automatique quotidienne est cochée, et vous pouvez la lancer à la main.

Prérequis : la liste est enregistrée et en mode Dynamique, elle a au moins une source activée avec un Utilisateur responsable, et vous avez la permission d'écriture sur la liste.

Configurer une source

  1. Dans l'onglet Paramètres et critères, sous le champ Type de document source, repérez le tableau Sources de la liste. Il indique, pour chaque source, le type de document, les filtres sous forme lisible (un filtre par ligne), l'état (Activé ou désactivé) et la date de dernière mise à jour.
  2. Cliquez sur Ajouter une source. Ce bouton n'apparaît que si vous pouvez modifier la liste et créer des sources. Le formulaire de la source s'ouvre avec la liste déjà renseignée.
  3. Choisissez le DocType source.
  4. Cliquez sur Configurer les filtres pour restreindre les documents pris en compte. Ce bouton n'apparaît que si vous avez la permission d'écriture sur la source, ou si la source est en cours de création. Les filtres portent uniquement sur les champs du DocType source lui-même (voir Limites des filtres).
  5. Si besoin, choisissez le Champ e-mail générique : la liste déroulante propose les champs du type de document source qui contiennent une adresse e-mail. Quand vous choisissez ou changez le DocType source, la liste se met à jour, le champ et les filtres précédents sont vidés, et le premier champ e-mail compatible est sélectionné s'il en existe un. Vous pouvez ensuite choisir un autre champ ou laisser le champ vide : votre choix est conservé. Ce champ est facultatif : il sert à la sélection directe par e-mail, ou lorsqu'aucun contact n'est trouvé. Il est aussi proposé dans la saisie rapide d'une nouvelle source.
  6. Dans la section de résolution des destinataires, choisissez la Recherche des contacts et le Mode de sélection. Pour un type comme Client ou Fournisseur, choisissez Lien dynamique (les contacts liés au document) et Contact principal (le mode par défaut). Les trois modes de sélection sont :
    • Contact principal : un seul contact par document, le contact principal s'il existe, sinon le premier contact trouvé ;
    • Tous les contacts : tous les contacts trouvés ;
    • E-mail direct : l'adresse lue dans le Champ e-mail générique du document source, sans chercher de contacts. Elle demande une Recherche des contacts à Aucun.

    La valeur Contact de Recherche des contacts n'est acceptée que pour le type de document Contact.
  7. Renseignez l'Utilisateur responsable (obligatoire). La case Activé est cochée par défaut.
  8. Enregistrez.

Si la liste est Dynamique et n'a aucune source, la section affiche Configuration incomplete: this dynamic list has no source. Add a source to synchronize it. (libellé non traduit). Si aucune source n'est activée, elle affiche Configuration incomplete: this dynamic list has no enabled source. Enable a source to synchronize it. (libellé non traduit).

Ajouter des membres depuis un type de document

Le menu Ajouter depuis > Type de document du formulaire de la liste permet d'ajouter les documents d'un type, avec des filtres. La case Tenir cette liste de diffusion à jour automatiquement décide de la suite :

  • Cochée : les filtres sont enregistrés comme source de synchronisation. Elle est cochée par défaut quand la liste est en mode Dynamique, et décochée sinon.
  • Décochée : l'ajout est ponctuel, les filtres ne sont pas enregistrés et la liste ne sera pas resynchronisée à partir d'eux.

Cliquez ensuite sur Aperçu pour choisir les destinataires avant de les ajouter.

Ce qui arrive aux membres lors d'une synchronisation

  • Les documents qui ne répondent plus aux filtres d'une source perdent l'origine rattachée à cette source. Si le membre a d'autres origines actives (une autre source, par exemple), elles sont conservées.
  • Une personne désinscrite n'est jamais réinscrite par une synchronisation.
  • Un document peut encore répondre aux filtres alors que son adresse est exclue par une opposition. Dans ce cas, l'origine du membre pour cette source est conservée et l'opposition reste valable. Cela vaut pour toute opposition qui vise la liste : à cette liste, à ce type de liste, à toutes les listes, ou une désinscription globale. Cela vaut aussi pour un contact marqué comme désinscrit.

Pour vérifier le résultat sans rien modifier, cliquez sur Action > Prévisualiser les sources dynamiques : l'aperçu ne change pas les abonnements.

Limites des filtres

Une source n'enregistre des filtres que sur son propre type de document. Une source Client ne peut donc pas filtrer sur l'état d'un document lié, comme l'abonnement actif d'un client.

Une source sur le type Abonnement (Subscription) peut filtrer les champs d'un abonnement, par exemple son statut ou son client, mais elle sélectionne des abonnements, pas des clients. Les contacts retenus sont ceux que la résolution des destinataires trouve à partir de l'abonnement : le contact de facturation de l'abonnement ou les contacts liés directement à lui, pas ceux de son client. Pour toucher les contacts des clients selon leurs abonnements, il faut une conception dédiée, qui n'est pas disponible dans la configuration d'une source. Le résultat dépend des données du site.

Lancer une synchronisation à la main

  1. Ouvrez la liste de diffusion et cliquez sur Action > Synchroniser maintenant.
  2. Dokos ouvre l'onglet Journal de synchronisation et met la synchronisation en file d'attente : l'alerte « Synchronisation mise en file d'attente. » s'affiche, puis « Synchronisation en cours » pendant l'exécution.
  3. Suivez le résultat dans l'onglet Journal de synchronisation.

Le bouton Synchroniser maintenant de cet onglet fait la même chose. Il est désactivé pendant qu'une synchronisation est en cours ou si vous n'avez pas la permission d'écriture sur la liste. Si une synchronisation est déjà en file d'attente ou en cours, Dokos affiche « Une synchronisation est déjà en file d'attente ou en cours. » et n'en lance pas une seconde. Si l'onglet n'est pas encore chargé, Dokos affiche Synchronization controls are still loading. Please try again. (libellé non traduit) : réessayez.

Droits utilisés pendant la synchronisation

  • Une synchronisation lancée à la main utilise vos droits.
  • Une synchronisation planifiée utilise les droits de l'Utilisateur responsable de chaque source. Cet utilisateur doit être activé, avoir le droit de modifier la liste, de lire la source et de lire le type de document source. Sinon la source échoue avec le message The source needs an enabled responsible user for scheduled synchronization. (libellé non traduit) ou avec une erreur de permission.
  • Lors d'une synchronisation planifiée, si des documents déjà synchronisés ne sont plus lisibles par l'utilisateur responsable, la source échoue avec Some existing source documents are no longer accessible to the responsible user. (libellé non traduit), pour éviter de retirer ces membres par erreur.
  • L'aperçu utilise les droits de l'utilisateur connecté.

En cas d'erreur

  • Aucune source activée : la synchronisation est comptée en erreur, avec le message Configure a dynamic source with a responsible user before synchronization. (libellé non traduit), visible dans le journal de synchronisation et enregistré dans le journal d'erreurs du système. Ajoutez ou activez une source, puis relancez.
  • Échec d'une source : les modifications de cette source sont annulées, les autres sources continuent, et le motif de l'erreur est conservé dans le journal de synchronisation.
  • Erreur inattendue : l'exécution passe en échec, le détail est conservé dans le journal et une entrée est ajoutée au journal d'erreurs du système. Dans l'historique Synchronisations récentes de l'onglet Journal de synchronisation, l'exécution a le statut Échec. Si vous pouvez modifier la liste, le bouton Recommencer relance une exécution en échec, interrompue ou annulée.

Exemple fictif : la liste « Clients actifs » est en mode Dynamique. Vous cliquez sur Ajouter une source, choisissez le type Client, filtrez sur Désactivé = Non, indiquez comme Utilisateur responsable un utilisateur fictif gestionnaire@exemple.test, puis enregistrez. Un client vient d'être créé : vous cliquez sur Action > Synchroniser maintenant, et son adresse apparaît dans la liste une fois l'exécution terminée.

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 associées à la liste de diffusion et l'historique des exécutions. Il contient le bouton Synchroniser maintenant. Pour chaque source, il affiche le statut de la dernière synchronisation et le résumé de l'opération. Pour la dernière exécution, il indique le nombre d'entrées traitées et le nombre d'erreurs. 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.

synchronize_email_group_now

synchronize_email_group_now(email_group: str) -> dict

Met en file d'attente une synchronisation manuelle de la liste. La méthode nécessite la permission d'écriture sur la liste. Elle renvoie {"queued": True, "log_name": ..., "task_id": ...} quand l'exécution est créée, {"queued": False, "log_name": ...} si une synchronisation est déjà en file d'attente ou en cours, et {"queued": False, "reason": "busy"} si la mise en file d'attente est verrouillée par un autre appel.

run_import_now(name) est conservée comme alias de cette méthode et renvoie le même dictionnaire ; elle ne renvoie plus un nombre d'adresses ajoutées.