MailChimp pour Dolibarr/Documentation utilisateur : Différence entre versions

De ATM
Sauter à la navigation Sauter à la recherche
Ligne 1 : Ligne 1 :
== Présentation du module ==  
+
= Présentation du module =
  
Ce module permet de connecter Dolibarr à votre compte Mailchimp (Cloud Mailing). Piloter vos campagnes de mails via MailChimp en restant sur Dolibarr.
+
Ce module permet de connecter Dolibarr à votre compte Mailchimp (Cloud Mailing). Pilotez vos campagnes de mails via MailChimp en restant sur Dolibarr !
 +
Le connecteur Mailchimp va exporter rapidement vos contacts Dolibarr vers vos listes Mailchimp et effectuer l’envoi de masse depuis Dolibarr avec Mailchimp.
 +
Pour utiliser ce connecteur, ceci nécessite une bonne compréhension du fonctionnement de l’envoi d’emails avec Mailchimp.
  
* Disponible sur [https://www.dolistore.com/fr/outils-systemes/685-MailChimp-pour-Dolibarr-3-7---3-9.html?search_query=mailchimp&results=1 Dolistore]
+
= Informations pratiques =
  
== Introduction ==
+
* Ce module fonctionne à partir de la version 5.0.x de Dolibarr
  
=== Présentation du module MailChimp ===
+
* Disponible sur [Dolistore]
  
MailChimp est un module pour Dolibarr destiné à la synchronisation des contacts et l'envoi de mails en masse avec MailChimp.
+
* Retrouvez également le [http://wiki.atm-consulting.fr/index.php/Guide_installation_de_module/Guide_installation_de_module Guide d'installation de module]
  
Mailchimp pour Dolibarr nécessite une connaissance préalable et la bonne compréhension du fonctionnement de l'envoi d'emails avec mailChimp.com.
+
* Formation préconisée = 0,5 jour
  
 +
= Configuration du module =
  
=== Caractéristiques techniques ===
+
* Pour configurer ce nouveau module, il faut aller dans "'''Accueil'''", puis dans le menu de gauche "'''Configuration'''" -> "'''Modules'''"; recherchez alors le module [[Fichier:Object mailchimp.png]] “‘’’Mailchimp’’’”.
  
'''Version du module mailchimp''' : 1.13
+
[[Image:Confmailchimp1.png|center|thumb|1300px|Configuration Mailchimp pour Dolibarr]]
'''Langage d'interface''' : Français / Anglais / Espagnol
 
'''Version de Dolibarr supportées''' : 3.7 - 3.9
 
'''Moteur de base de données supporté''' : MySQL/PgSQL (>=9.1)
 
  
== Démarrage ==
+
* Écran de configuration du connecteur Mailchimp pour Dolibarr :
=== Installation ===
 
''' Installation intitiales '''
 
  
* Télécharger le fichier archive du module (.zip) depuis le site web DoliStore.com.
+
[[Image:Confmailchimp2.png|center|thumb|1300px|Configuration Mailchimp pour Dolibarr]]
  
* Décompresser le fichier .zip en le plaçant dans le répertoire /custom de Dolibarr.
 
  
* Toujours vérifier les autres opérations d'installation dans le fichier README-FR.
+
Le connecteur MailChimp nécessite l'enregistrement des informations de connexion à MailChimp en renseignant votre identifiant et votre clé API (Disponible depuis mon compte MailChimp -> Extras -> Clé API).
 
 
'''Remarque''' : L’installation du module MailChimp pour Dolibarr nécessite la présence d’un dossier "custom" dans le dossier "htdocs".
 
 
 
Le répertoire "/custom", initialement, a été créé pour différencier les modules natifs de Dolibarr des modules ajoutés par les utilisateurs. Tous les modules additionnels n’utilisent pas ce répertoire et peuvent être installés dans le répertoire racine. Dans le cas où le répertoire "custom" est nécessaire pour le déploiement de modules, suivre la procédure suivante :
 
 
 
'''Attention''' : la réalisation de la procédure suivante nécessite des compétences en programmation malgré la simplicité de la procédure expliquée ci-après.
 
 
 
* Dans votre répertoire d'installation de Dolibarr ouvrir le fichier htdocs/conf/conf.php.
 
 
 
* Trouver les lignes :
 
  //$dolibarr_main_url_root_alt=... et //$dolibarr_main_document_root_alt=...
 
 
 
Ou
 
 
 
  #$dolibarr_main_url_root_alt=... et #$dolibarr_main_document_root_alt=...
 
 
 
* Supprimez les "'''//'''" (ou le "'''#'''") de ces lignes et affectez une valeur cohérentes par rapport à votre installation de Dolibarr en vous référant aux lignes :
 
 
 
  $dolibarr_main_url_root=... et $dolibarr_main_document_root=...
 
 
 
 
 
* Par exemple pour un système UNIX/Linux/MacOS X, à partir de Dolibarr 3.5 :
 
 
 
  $dolibarr_main_url_root = 'http://localhost/Dolibarr/htdocs';
 
 
 
  $dolibarr_main_document_root = '/var/www/Dolibarr/htdocs';
 
 
 
  $dolibarr_main_url_root_alt = '/custom';
 
 
 
  $dolibarr_main_document_root_alt = '/var/www/Dolibarr/htdocs/custom';
 
 
 
 
 
* Par exemple pour un système Microsoft Windows, à partir de Dolibarr 3.5 :
 
 
 
  $dolibarr_main_url_root = 'http://localhost/Dolibarr/htdocs';
 
 
 
  $dolibarr_main_document_root = 'C:/votre_site /Dolibarr/htdocs';
 
 
 
  $dolibarr_main_url_root_alt = '/custom';
 
 
 
  $dolibarr_main_document_root_alt = 'C:/votre_sites/Dolibarr/htdocs/custom';
 
 
 
 
 
'''Installation des mises à jour'''
 
 
 
* Télécharger le fichier archive du module (.zip) depuis le site web DoliStore.com.
 
 
 
* Désactiver le module à mettre à jour de l’environnement Dolibarr.
 
 
 
* Décompresser le fichier archive (.zip) contenant la nouvelle version dans le dossier "votreDolibarr\htdocs\custom".
 
 
 
* Rafraîchir la page de configuration des modules dans le navigateur.
 
 
 
* Réactiver le module mis à jour.
 
 
 
=== Activation ===
 
 
 
L’activation du module, qu’elle soit initiale ou de mise à jour, se fait en cliquant sur l’icône à droite en bout de ligne dans la page de configuration des modules : Accueil > Configuration > modules > modules interface.
 
 
 
Il est parfois nécessaire de répéter l’opération de désactivation/ réactivation afin de s’assurer de la bonne installation d’un module.
 
 
 
 
 
=== Configuration ===
 
 
 
La page de configuration du module MailChimp pour Dolibarr est accessible depuis la page de configuration des modules de Dolibarr dans Accueil > Configuration > modules > modules interface :
 
 
 
[[Image:Mc1.png|center|thumb|1300px|Configuration Mailchimp pour Dolibarr]]
 
 
 
Le connecteur MailChimp nécessite l'enregistrement des informations de connexion à MailChimp en renseignant votre identifiant et votre clé API (mon compte MailChimp> Extras > Clé API).
 
  
 
Sélectionnez ensuite l'option qui vous convient entre :
 
Sélectionnez ensuite l'option qui vous convient entre :
Ligne 110 : Ligne 38 :
 
* ''Tous vos emails continueront de partir via le SMTP défini dans la configuration Dolibarr''
 
* ''Tous vos emails continueront de partir via le SMTP défini dans la configuration Dolibarr''
  
Le module ne servira qu'à alimenter/synchroniser vos listes et segments MailChimp. Vous pouvez aussi choisir d'activer le stockage de l'historique de l'activité des contacts dans la base de données de Dolibarr ('''Attention''' cela peux augmenter la taille de votre base de données et ralentir la mise à jour des statuts des destinataires).
+
Le module ne servira qu'à alimenter/synchroniser vos listes et segments MailChimp. Vous pouvez aussi choisir d'activer le stockage de l'historique de l'activité des contacts dans la base de données de Dolibarr ('''Attention''' cela peut augmenter la taille de votre base de données et ralentir la mise à jour des statuts des destinataires).
 +
 
  
=== Permissions utilisateurs aux fonctionnalités du module ===
+
= Permissions utilisateurs =
  
 
Le module MailChimp pour Dolibarr gère les autorisations en fonction des utilisateurs ou groupes d’utilisateurs.
 
Le module MailChimp pour Dolibarr gère les autorisations en fonction des utilisateurs ou groupes d’utilisateurs.
  
[[Image:MC2.png|center|thumb|800px|MailChimp pour Dolibarr]]
+
[[Image:MC30.png|center|thumb|800px|MailChimp pour Dolibarr]]
  
== Fonctionnement ==
+
 
 +
= Utilisation du module =
  
 
Les fonctionnalités du module MailChimp sont accessibles depuis le menu principal de Dolibarr par l'onglet MailChimp :
 
Les fonctionnalités du module MailChimp sont accessibles depuis le menu principal de Dolibarr par l'onglet MailChimp :
  
[[Image:MC5.png|center|thumb|800px|MailChimp pour Dolibarr]]
+
[[Image:MC31.png|center|thumb|800px|MailChimp pour Dolibarr]]
 
 
 
 
Le menu principal vous affichera la liste des campagnes emailing enregistrées dans MailChimp et un bouton pour "Mettre à jour le statut des destinataires Dolibarr depuis MailChimp pour toutes les campagnes".
 
 
 
[[Image:MC6.png|center|thumb|1000px|MailChimp pour Dolibarr]]
 
 
 
 
 
  '''Mettre à jour le statut des destinataires Dolibarr depuis Mailchimp pour toutes les campagnes'''
 
  Ce bouton sert à actualiser le statut des destinataires en fonction de toutes les campagnes d'emailing.
 
 
 
 
 
Les liens de menu secondaire permettent l'affichage :
 
 
 
* Des listes et segments existants dans MailChimp
 
 
 
* De la page de création d'un nouvel emailing
 
 
 
* De la liste des emailings effectués depuis Dolibarr :
 
 
 
[[Image:MC10.png|center|thumb|800px|MailChimp pour Dolibarr]]
 
 
 
== Envoyer un nouvel emailing ==
 
=== Création de l'emailing ===
 
 
 
Depuis les menus MailChimp > MailChimp > nouvel emailing, lancer la création d'un nouvel emailing en remplissant les champs nécessaires et le corps du message en utilisant les balises de remplacement.
 
 
 
Cliquez sur le bouton '''Créer''' :
 
 
 
[[Image:MC12.png|center|thumb|800px|MailChimp pour Dolibarr]]
 
  
 +
Le menu principal vous affichera la liste des campagnes emailing enregistrées dans MailChimp et un bouton pour "’’’Mettre à jour le statut des destinataires Dolibarr depuis MailChimp pour toutes les campagnes’’’".
 +
[[Image:MC32.png|center|thumb|800px|MailChimp pour Dolibarr]]
  
 +
Les liens de menu secondaire permettent :
 +
[[Image:MC33.png|center|thumb|800px|MailChimp pour Dolibarr]]
 +
* ‘’’Liste de destinataires mailchimp’’’ : visualisez et accédez aux listes et segments Mailchimp depuis Dolibarr
 +
* ‘’’Nouvel emailing’’’ : créer une nouvelle campagne Mailchimp depuis Dolibarr
 +
* ‘’’Liste des campagnes Dolibarr’’’ : accédez à vos listes d’emailing créées depuis Dolibarr
 +
 +
 +
= Envoyer un nouvel emailing =
 +
==Création de l’emailing==
 +
* Depuis le menu principal on clique sur ‘’’Mailchimp’’’, puis dans le menu de gauche sur ‘’’ Nouvel emailing’’’; voici l’écran sur lequel nous allons suivre les étapes de création de l’emailing :
 +
 +
[[Image:MC34.png|center|thumb|800px|MailChimp pour Dolibarr]]
 +
 +
Il faut maintenant remplir les champs obligatoire (pour rappel, les champs obligatoires sont en bleus) ; à défaut Dolibarr vous l’indiquera par un message d’erreur vous invitant à compléter les champs manquants
 
   Pour une utilisation optimale et de meilleurs résultats, contentez-vous, dans l'éditeur de mail natif de Dolibarr, de copier les balises de remplacement (*|FNAME|*, *|LNAME|*, *|EMAIL|* et *|UNSUB|*).  
 
   Pour une utilisation optimale et de meilleurs résultats, contentez-vous, dans l'éditeur de mail natif de Dolibarr, de copier les balises de remplacement (*|FNAME|*, *|LNAME|*, *|EMAIL|* et *|UNSUB|*).  
 
   Vous pourrez travailler le contenu de l'emailing avec MailChimp.
 
   Vous pourrez travailler le contenu de l'emailing avec MailChimp.
 +
Une fois les champs complétés, vous pouvez cliquer sur le bouton au bas [[Fichier:MC35.png]], et passer à l’étape suivante : la sélection des destinataires.
 +
 +
==Sélection des destinataires==
  
 +
Depuis l’onglet “‘’’Destinataires’’’” vous allez pouvoir sélectionner les tiers et contacts que vous souhaitez ajouter à vos listes et segments dans Mailchimp.
 +
[[Image:MC36.png|center|thumb|800px|MailChimp pour Dolibarr]]
  
Une fois l'emailing enregistré, cliquez sur l'onglet '''MailChimp''' de sa fiche pour ajouter les destinataires.
+
‘’’En standard dans Dolibarr’’’ vous pouvez également activer l’onglet ‘’’Sélection de destinataires avancée’’’
 
+
[[Image:MC37.png|center|thumb|800px|MailChimp pour Dolibarr]]
=== Destinataires ===
+
 
+
* Cet onglet vous permet de sélectionner vos destinataires selon différents critères plus précis que dans l'onglet “Destinataires” (localisation, Chiffre d'affaires, effectifs, etc...)
* '''Ajout de destinataires'''
+
* C'est une option cachée présente en standard dans Dolibarr.
 
+
* Pour l'activer il faut se rendre en '''Configuration''' -> '''Divers''' et renseigner la clé  '''EMAILING_USE_ADVANCED_SELECTOR''' mettre la valeur 1
Les destinataires de l'emailing doivent faire partie d'une liste et d'un segment MailChimp.
+
 
+
== Synchronisation des contacts ==
Si tel est le cas pour tous les destinataires de l'emailing, ajoutez les destinataires MailChimp en sélectionnant la liste et le segment avec les liste déroulantes des champs ''Choisissez une liste a laquelle ajouter ces emails'' et ''Choisissez un segment auquel ajouter ces emails''.
+
* Il faut maintenant synchroniser vos contacts Dolibarr avec Mailchimp afin de les exporter dans une liste/segment de Mailchimp.  
 
+
* Pour cela, il faut se rendre sur l’onglet ‘’’Mailchimp’’’
Cliquez ensuite sur le bouton '''Importer les contacts MailChimp''' (supprime et remplace les destinataires Dolibarr par les emails des liste/segment MailChimp sélectionnés). Les contacts présents dans le segment sélectionné seront ajoutés en destinataires de l'emailing.
+
[[Image:MC38.png|center|thumb|800px|MailChimp pour Dolibarr]]
 
+
Dans le cas où des destinataires ne sont pas enregistrés dans MailChimp, des outils de synchronisation existent :
+
 
+
* Il faut, en premier lieu, renseigner le nom d’expéditeur; en cas d’oubli au moment de l’export de votre liste, l’outil vous le rappelera
 
+
* La synchronisation va alors se faire en 2 étapes :
* '''Synchronisation de destinataires'''
+
** 1 - Export de vos contacts vers votre liste Mailchimp
 
+
** 2 - Export de vos contacts dans le segment souhaité
[[Image:MC14.png|center|thumb|800px|MailChimp pour Dolibarr]]
+
===1 - Export de vos contacts vers votre liste Mailchimp===
 
+
* Pour l’export des contacts vers Mailchimp, l’opération doit se faire en deux étapes pour être conforme au fonctionnement de Mailchimp.
 
+
* Pour la première étape, il faut donc exporter les contacts vers une liste mailchimp.
Le bouton '''Exporter les destinataires Dolibarr actuels vers une liste/segment MailChimp''' permet d'ajouter les destinataires de Dolibarr non présents dans une liste et un segment MailChimp à la liste et au segment sélectionnés avec les mêmes listes déroulantes que précédemment.
+
* Sélectionnez la liste mailchimp concernée :
 
+
[[Image:MC39.png|center|thumb|800px|MailChimp pour Dolibarr]]
Avec ce même bouton, il est possible d'ajouter les destinataires Dolibarr dans une nouvelle liste (à créer dans MailChimp) et un nouveau segment qu'il est possible de créer depuis Dolibarr.
+
* Puis cliquez sur le bouton ‘’’Exporter les contacts vers la liste’’’
 
+
[[Image:MC40.png|center|thumb|800px|MailChimp pour Dolibarr]]
Le bouton '''Mettre à jour uniquement le segment sélectionné''' (ne seront ajoutés au segment que les contacts déjà présents dans la liste MailChimp) ajoute au segment sélectionné les destinataires qui font déjà partie de la liste à laquelle appartient le segment sélectionné.
+
* Il faut ensuite attendre la fin de cette opération pour passer à l’étape suivante: l’outil grise le bouton suivant, tant que la première étape est en cours :
 
+
[[Image:MC41.png|center|thumb|800px|MailChimp pour Dolibarr]]
 
+
* La première étape terminée, le message suivant apparaît, et vous pouvez passer à l’étape 2.
* '''Autres options'''
+
[[Image:MC42.png|center|thumb|800px|MailChimp pour Dolibarr]]
 
+
Le bouton '''Sauver le lien liste/segment entre la campagne Dolibarr et la campagne MailChimp uniquement''' permet l'affectation d'une liste/segment de MailChimp à la campagne Dolibarr, sans synchronisation des contacts.
+
===2 - Export de vos contacts vers un segment de votre liste Mailchimp===
 
+
* Vous pouvez maintenant sélectionner le segment concerné (cf zone “‘’’1’’’”) ou le créer le cas échéant (cf “‘’’2’’’”)
Une fois la création de l'email effectuée, les destinataires sélectionnés, revenez sur l'onglet '''Fiche emailing''' pour le valider et pouvoir l'exporter vers MailChimp et le modifier.
+
* Vous pouvez maintenant cliquer sur le bouton “‘’’Exporter les contacts vers un segment’’’”
 
+
Pensez aussi à indiquer le nom de l'expéditeur de l'emailing !
+
===Les autres boutons de synchronisation de contacts===
 
+
* ‘’’Importer les contacts Mailchimp’’’ : supprime et remplace les destinataires Dolibarr pas les emails des liste/segment Mailchimp sélectionnés.
=== Modification de l'email avec MailChimp ===
+
* ’’’Sauver le lien Liste/Segment entre la campagne Dolibarr et la campagne Mailchimp uniquement’’’ : permet l'affectation d'une liste/segment de MailChimp à la campagne Dolibarr, sans synchronisation des contacts.
 
+
* ‘’’Mettre à jour uniquement le segment sélectionné’’’ : ce bouton sert à la suite de l’envoi de votre campagne, les statuts des contacts seront alors mis à jour.
Après la validation de l'emailing, revenez sur l'onglet '''MailChimp''' et cliquez sur le bouton '''Créer la campagne MailChimp'''.
 
 
 
L'emailing créé dans Dolibarr apparaîtra alors dans la liste de vos campagnes depuis MailChimp :
 
 
 
[[Image:MC15.png|center|thumb|300px|MailChimp pour Dolibarr]]
 
 
 
Depuis MailChimp.com, modifiez les propriétés de l'email avec les boutons '''Edit''' en suivant les étapes :
 
 
 
[[Image:MC16.png|center|thumb|800px|MailChimp pour Dolibarr]]
 
 
 
  '''Attention''' : N'envoyez pas l'emailing depuis Mailchimp !
 
 
 
=== Envoi de l'emailing ===
 
 
 
Pour une utilisation optimale du module MailChimp et de ses fonctionnalités, il est recommandé d'envoyer l'emailing '''par MailChimp depuis Dolibarr avec le bouton ''Envoi de la campagne MailChimp''''' : En suivant cette procédure, vos destinataires auront été synchronisés entre Dolibarr et MailChimp et le contenu des mails sera plus riche que ne le permet l'éditeur natif de Dolibarr.
 
 
 
 
 
'''Par MailChimp, depuis Dolibarr'''
 
 
 
Utilisez le bouton '''Envoyer la campagne MailChimp''' depuis l'onglet MailChimp de la fiche de l'emailing :
 
 
 
[[Image:MC17.png|center|thumb|800px|MailChimp pour Dolibarr]]
 
 
 
 
 
''' Par Dolibarr '''
 
 
 
Vous pouvez envoyer l'emailing depuis Dolibarr avec le bouton '''envoi emailing''' de la fiche de l'emailing. Dans ce cas, l'emailing est envoyé avec les fonctionnalités natives du module emailing de Dolibarr.
 
  
  '''Attention : En cas d'envoi de l'emailing par Dolibarr'''
+
==Validation de l’emailing==
  Si l'envoi de l'emailing est fait par Dolibarr, seuls seront pris en compte les contacts ajoutés depuis Mailchimp. Le contenu du mail est dans ce cas celui créé dans Dolibarr.
 
  
'''Directement par MailChimp'''
+
* Vous pouvez maintenant valider votre emailing sur la ‘’’Fiche emailing’’’, bouton  [[Fichier:MC44.png]], puis créer votre campagne Mailchimp depuis l’onglet ‘’’Mailchimp’’’, bouton [[Fichier:MC45.png]], en bas à droite.
  
Envoyez votre emailing immédiatement ou en différé, depuis MailChimp, depuis les bouton présents en bas de page :
+
* La campagne apparaît alors dans votre liste de campagnes sur Mailchimp.com.
  
[[Image:MC17.png|center|thumb|800px|MailChimp pour Dolibarr]]
+
* Vous pouvez alors modifier votre email sur Mailchimp en suivant le déroulé habituel de Mailchimp jusqu’à la création de votre template.
  
  '''Attention : En cas d'envoi d'emailing directement depuis Mailchimp'''
+
  ATTENTION : N’envoyez pas l’emailing depuis Mailchimp !
  Si l'envoi de l'emailing est fait depuis mailchimp, la synchonisation des informations, notamment le statut des contacts sera partielle !
 
  Envoyez plutôt l'emailing depuis Dolibarr via l'onglet Mailchimp !
 
  
=== Suivi de l'emailing ===
 
  
MailChimp permet le suivi des emails. Vous pourrez mettre à jour le statut des contacts suite à cet emailing dans Dolibarr depuis la fiche de l'emailing ou depuis la page d'accueil du module MailChimp.
+
==Envoi de l’emailing==
  
 +
‘’’Pour une utilisation optimale du module MailChimp et de ses fonctionnalités, il est recommandé d'envoyer l'emailing par MailChimp depuis Dolibarr avec le bouton Envoi de la campagne MailChimp’’’ : En suivant cette procédure, vos destinataires auront été synchronisés entre Dolibarr et MailChimp et le contenu des mails sera plus riche que ne le permet l'éditeur natif de Dolibarr.
  
* Depuis la fiche de l'emailing, avec le bouton '''Mettre à jour le statut des destinataires Dolibarr depuis MailChimp''', les statuts des contacts seront mis à jour seulement suite à la campagne. De plus, le modèle de l'email créé depuis MailChimp sera importé dans Dolibarr. Vous aurez alors la possibilité de le cloner sans avoir à refaire entièrement le modèle.
+
‘’’Par MailChimp, depuis Dolibarr’’’
 +
* Utilisez le bouton Envoyer la campagne MailChimp [[Fichier:MC46.png]] depuis l'onglet MailChimp de la fiche de l'emailing.
  
* Depuis la page d'accueil du module, les statuts des contacts seront mis à jour en fonction de toutes les campagnes effectuées avec le bouton '''Mettre à jour le statut des destinataires Dolibarr depuis MailChimp pour toutes les campagnes'''.
+
* ‘’’Par Dolibarr’’’
 +
Vous pouvez envoyer l'emailing depuis Dolibarr avec le bouton ‘’’Envoi emailing’’’ de la fiche de l'emailing. ‘’’Dans ce cas, l'emailing est envoyé avec les fonctionnalités natives du module emailing de Dolibarr.’’’
  
La fiche d'un emailing envoyé affiche les informations des destinataires, la liste MailChimp utilisée, le statut d'envoi de l'emailing et un lien vers des statistiques plus détaillées disponibles sur  MailChimp.com.
+
* ‘’’Directement par Mailchimp’’’
  
 +
Envoyez votre emailing immédiatement ou en différé, depuis MailChimp directement, en suivant le déroulé habituel.
  
== FAQ ==
+
    ‘’’Attention : En cas d'envoi d'emailing directement depuis Mailchimp’’’
 +
Si l'envoi de l'emailing est fait depuis mailchimp, la synchronisation des informations, notamment le statut des contacts sera partielle !
 +
Envoyez plutôt l'emailing depuis Dolibarr via l'onglet Mailchimp !
  
* Il se peut qu'il soit nécessaire de cliquer plusieurs fois sur votre export de liste pour que la liaison avec Mailchimp s'opère correctement.
 
  
 +
= Suivi d’emailing==
  
 +
* MailChimp permet le suivi des emails. Vous pourrez mettre à jour le statut des contacts suite à cet emailing dans Dolibarr depuis la fiche de l'emailing ou depuis la page d'accueil du module MailChimp.
 +
* Depuis la fiche de l'emailing, avec le bouton ‘’’Mettre à jour le statut des destinataires Dolibarr depuis MailChimp’’’, les statuts des contacts seront mis à jour seulement suite à la campagne. De plus, le modèle de l'email créé depuis MailChimp sera importé dans Dolibarr. Vous aurez alors la possibilité de le cloner sans avoir à refaire entièrement le modèle.
 +
Depuis la page d'accueil du module, les statuts des contacts seront mis à jour en fonction de toutes les campagnes effectuées avec le bouton ‘’’Mettre à jour le statut des destinataires Dolibarr depuis MailChimp pour toutes les campagnes’’’.
 +
La fiche d'un emailing envoyé affiche les informations des destinataires, la liste MailChimp utilisée, le statut d'envoi de l'emailing et un lien vers des statistiques plus détaillées disponibles sur MailChimp.com.
  
== Historique et Mise à jour ==
+
= Historique du module =
  
* le 16/03/2017 : correctif
+
* Version 1.17 disponible depuis le 12/12/2017

Version du 11 décembre 2017 à 15:36

Présentation du module

Ce module permet de connecter Dolibarr à votre compte Mailchimp (Cloud Mailing). Pilotez vos campagnes de mails via MailChimp en restant sur Dolibarr ! Le connecteur Mailchimp va exporter rapidement vos contacts Dolibarr vers vos listes Mailchimp et effectuer l’envoi de masse depuis Dolibarr avec Mailchimp. Pour utiliser ce connecteur, ceci nécessite une bonne compréhension du fonctionnement de l’envoi d’emails avec Mailchimp.

Informations pratiques

  • Ce module fonctionne à partir de la version 5.0.x de Dolibarr
  • Disponible sur [Dolistore]
  • Formation préconisée = 0,5 jour

Configuration du module

  • Pour configurer ce nouveau module, il faut aller dans "Accueil", puis dans le menu de gauche "Configuration" -> "Modules"; recherchez alors le module Object mailchimp.png “‘’’Mailchimp’’’”.
Configuration Mailchimp pour Dolibarr
  • Écran de configuration du connecteur Mailchimp pour Dolibarr :
Configuration Mailchimp pour Dolibarr


Le connecteur MailChimp nécessite l'enregistrement des informations de connexion à MailChimp en renseignant votre identifiant et votre clé API (Disponible depuis mon compte MailChimp -> Extras -> Clé API).

Sélectionnez ensuite l'option qui vous convient entre :

  • Tous les emails seront envoyés par MailChimp

Cette configuration nécessite l'activation d'une clé API Mandrill en complément de la clé API MailChimp. La clé API Mandrill vous donnera accès à un serveur SMTP duquel partira l'emailing.

La configuration initiale de l'envoi d'email enregistrée dans Dolibarr est modifiée par cette option. Pour revenir à la configuration de départ de votre Dolibarr, désactiver cette option après l'envoi de votre emailing.

  • Tous vos emails continueront de partir via le SMTP défini dans la configuration Dolibarr

Le module ne servira qu'à alimenter/synchroniser vos listes et segments MailChimp. Vous pouvez aussi choisir d'activer le stockage de l'historique de l'activité des contacts dans la base de données de Dolibarr (Attention cela peut augmenter la taille de votre base de données et ralentir la mise à jour des statuts des destinataires).


Permissions utilisateurs

Le module MailChimp pour Dolibarr gère les autorisations en fonction des utilisateurs ou groupes d’utilisateurs.

MailChimp pour Dolibarr


Utilisation du module

Les fonctionnalités du module MailChimp sont accessibles depuis le menu principal de Dolibarr par l'onglet MailChimp :

MailChimp pour Dolibarr

Le menu principal vous affichera la liste des campagnes emailing enregistrées dans MailChimp et un bouton pour "’’’Mettre à jour le statut des destinataires Dolibarr depuis MailChimp pour toutes les campagnes’’’".

MailChimp pour Dolibarr

Les liens de menu secondaire permettent :

MailChimp pour Dolibarr
  • ‘’’Liste de destinataires mailchimp’’’ : visualisez et accédez aux listes et segments Mailchimp depuis Dolibarr
  • ‘’’Nouvel emailing’’’ : créer une nouvelle campagne Mailchimp depuis Dolibarr
  • ‘’’Liste des campagnes Dolibarr’’’ : accédez à vos listes d’emailing créées depuis Dolibarr


Envoyer un nouvel emailing

Création de l’emailing

  • Depuis le menu principal on clique sur ‘’’Mailchimp’’’, puis dans le menu de gauche sur ‘’’ Nouvel emailing’’’; voici l’écran sur lequel nous allons suivre les étapes de création de l’emailing :
MailChimp pour Dolibarr

Il faut maintenant remplir les champs obligatoire (pour rappel, les champs obligatoires sont en bleus) ; à défaut Dolibarr vous l’indiquera par un message d’erreur vous invitant à compléter les champs manquants

 Pour une utilisation optimale et de meilleurs résultats, contentez-vous, dans l'éditeur de mail natif de Dolibarr, de copier les balises de remplacement (*|FNAME|*, *|LNAME|*, *|EMAIL|* et *|UNSUB|*). 
 Vous pourrez travailler le contenu de l'emailing avec MailChimp.

Une fois les champs complétés, vous pouvez cliquer sur le bouton au bas MC35.png, et passer à l’étape suivante : la sélection des destinataires.

Sélection des destinataires

Depuis l’onglet “‘’’Destinataires’’’” vous allez pouvoir sélectionner les tiers et contacts que vous souhaitez ajouter à vos listes et segments dans Mailchimp.

MailChimp pour Dolibarr

‘’’En standard dans Dolibarr’’’ vous pouvez également activer l’onglet ‘’’Sélection de destinataires avancée’’’

MailChimp pour Dolibarr
  • Cet onglet vous permet de sélectionner vos destinataires selon différents critères plus précis que dans l'onglet “Destinataires” (localisation, Chiffre d'affaires, effectifs, etc...)
  • C'est une option cachée présente en standard dans Dolibarr.
  • Pour l'activer il faut se rendre en Configuration -> Divers et renseigner la clé EMAILING_USE_ADVANCED_SELECTOR mettre la valeur 1

Synchronisation des contacts

  • Il faut maintenant synchroniser vos contacts Dolibarr avec Mailchimp afin de les exporter dans une liste/segment de Mailchimp.
  • Pour cela, il faut se rendre sur l’onglet ‘’’Mailchimp’’’
MailChimp pour Dolibarr


  • Il faut, en premier lieu, renseigner le nom d’expéditeur; en cas d’oubli au moment de l’export de votre liste, l’outil vous le rappelera
  • La synchronisation va alors se faire en 2 étapes :
    • 1 - Export de vos contacts vers votre liste Mailchimp
    • 2 - Export de vos contacts dans le segment souhaité

1 - Export de vos contacts vers votre liste Mailchimp

  • Pour l’export des contacts vers Mailchimp, l’opération doit se faire en deux étapes pour être conforme au fonctionnement de Mailchimp.
  • Pour la première étape, il faut donc exporter les contacts vers une liste mailchimp.
  • Sélectionnez la liste mailchimp concernée :
MailChimp pour Dolibarr
  • Puis cliquez sur le bouton ‘’’Exporter les contacts vers la liste’’’
MailChimp pour Dolibarr
  • Il faut ensuite attendre la fin de cette opération pour passer à l’étape suivante: l’outil grise le bouton suivant, tant que la première étape est en cours :
MailChimp pour Dolibarr
  • La première étape terminée, le message suivant apparaît, et vous pouvez passer à l’étape 2.
MailChimp pour Dolibarr

2 - Export de vos contacts vers un segment de votre liste Mailchimp

  • Vous pouvez maintenant sélectionner le segment concerné (cf zone “‘’’1’’’”) ou le créer le cas échéant (cf “‘’’2’’’”)
  • Vous pouvez maintenant cliquer sur le bouton “‘’’Exporter les contacts vers un segment’’’”

Les autres boutons de synchronisation de contacts

  • ‘’’Importer les contacts Mailchimp’’’ : supprime et remplace les destinataires Dolibarr pas les emails des liste/segment Mailchimp sélectionnés.
  • ’’’Sauver le lien Liste/Segment entre la campagne Dolibarr et la campagne Mailchimp uniquement’’’ : permet l'affectation d'une liste/segment de MailChimp à la campagne Dolibarr, sans synchronisation des contacts.
  • ‘’’Mettre à jour uniquement le segment sélectionné’’’ : ce bouton sert à la suite de l’envoi de votre campagne, les statuts des contacts seront alors mis à jour.

Validation de l’emailing

  • Vous pouvez maintenant valider votre emailing sur la ‘’’Fiche emailing’’’, bouton MC44.png, puis créer votre campagne Mailchimp depuis l’onglet ‘’’Mailchimp’’’, bouton MC45.png, en bas à droite.
  • La campagne apparaît alors dans votre liste de campagnes sur Mailchimp.com.
  • Vous pouvez alors modifier votre email sur Mailchimp en suivant le déroulé habituel de Mailchimp jusqu’à la création de votre template.
  ATTENTION : N’envoyez pas l’emailing depuis Mailchimp !


Envoi de l’emailing

‘’’Pour une utilisation optimale du module MailChimp et de ses fonctionnalités, il est recommandé d'envoyer l'emailing par MailChimp depuis Dolibarr avec le bouton Envoi de la campagne MailChimp’’’ : En suivant cette procédure, vos destinataires auront été synchronisés entre Dolibarr et MailChimp et le contenu des mails sera plus riche que ne le permet l'éditeur natif de Dolibarr.

‘’’Par MailChimp, depuis Dolibarr’’’

  • Utilisez le bouton Envoyer la campagne MailChimp MC46.png depuis l'onglet MailChimp de la fiche de l'emailing.
  • ‘’’Par Dolibarr’’’

Vous pouvez envoyer l'emailing depuis Dolibarr avec le bouton ‘’’Envoi emailing’’’ de la fiche de l'emailing. ‘’’Dans ce cas, l'emailing est envoyé avec les fonctionnalités natives du module emailing de Dolibarr.’’’

  • ‘’’Directement par Mailchimp’’’

Envoyez votre emailing immédiatement ou en différé, depuis MailChimp directement, en suivant le déroulé habituel.

   ‘’’Attention : En cas d'envoi d'emailing directement depuis Mailchimp’’’
Si l'envoi de l'emailing est fait depuis mailchimp, la synchronisation des informations, notamment le statut des contacts sera partielle !
Envoyez plutôt l'emailing depuis Dolibarr via l'onglet Mailchimp !


Suivi d’emailing=

  • MailChimp permet le suivi des emails. Vous pourrez mettre à jour le statut des contacts suite à cet emailing dans Dolibarr depuis la fiche de l'emailing ou depuis la page d'accueil du module MailChimp.
  • Depuis la fiche de l'emailing, avec le bouton ‘’’Mettre à jour le statut des destinataires Dolibarr depuis MailChimp’’’, les statuts des contacts seront mis à jour seulement suite à la campagne. De plus, le modèle de l'email créé depuis MailChimp sera importé dans Dolibarr. Vous aurez alors la possibilité de le cloner sans avoir à refaire entièrement le modèle.

Depuis la page d'accueil du module, les statuts des contacts seront mis à jour en fonction de toutes les campagnes effectuées avec le bouton ‘’’Mettre à jour le statut des destinataires Dolibarr depuis MailChimp pour toutes les campagnes’’’. La fiche d'un emailing envoyé affiche les informations des destinataires, la liste MailChimp utilisée, le statut d'envoi de l'emailing et un lien vers des statistiques plus détaillées disponibles sur MailChimp.com.

Historique du module

  • Version 1.17 disponible depuis le 12/12/2017