Joomla est un système de gestion de contenu open-source pour gérer le contenu des sites web. Il utilise un cadre modèle-vue-contrôleur, qui peut être utilisé seul afin de créer des applications en ligne solides. Vous pouvez installer et configurer l'offre Brevo sur votre site web Joomla pour pouvoir :

• synchroniser vos utilisateurs et contacts avec Brevo,
• créer un formulaire et l'ajouter à votre site web,
• envoyer des emails transactionnels via Brevo,
• suivre l'activité de votre site web.

Pour connecter votre compte Brevo à votre site web Joomla, suivez la procédure ci-dessous.

Avant de commencer

Réunissez les informations suivantes avant l'installation :

• Vos identifiants de compte Brevo.
• Votre clé API v3. Pour en savoir plus, consultez notre article dédié Créez et gérez vos clés API.
• Votre mot de passe SMTP. Pour en savoir plus, consultez notre article dédié Qu'est-ce que Brevo SMTP ?
• Vos identifiants d'accès au panneau d'administration du site Web Joomla.

Pour utiliser toutes les fonctionnalités du package, assurez-vous que votre compte Brevo a été validé et que l'envoi d'emails à partir des plateformes Campagnes et Transactionnel de Brevo a été activé.

Vous trouverez également le package Brevo dans le répertoire des extensions de Joomla.

Étape 1 : installation et configuration de l'offre Brevo

La procédure est la même que pour les autres packages Joomla. Une fois que vous êtes connecté à votre back office Joomla, cliquez sur Extensions > Gérer > Installation.

Le package d'installation :

• ajoute des fichiers et tableaux à votre site Web,
• crée un onglet Brevo dans le menu Composants,
• crée des éléments de sous-menu correspondants aux différentes sections du composant Brevo.

En fonction des plugins d'installation activés, quatre options standards vous sont proposées sur la page d'installation :

1. Installer à partir du Web
2. Transférer un paquet
3. Installer à partir d'un répertoire
4. Installer à partir d'une URL

1. Installer à partir du Web

Si la fonctionnalité « Installer à partir du web » est activée sur votre site web, accédez à l'onglet correspondant, puis saisissez « Brevo » dans la barre de recherche. Cliquez sur le nom du package pour ouvrir le répertoire, puis cliquez sur le bouton Installer. Une fois confirmé, l'offre est automatiquement installée.

2. Transférer un paquet

• Téléchargez un fichier ici : https://github.com/brevo/joomla-plugin/tree/master/build/J3/package
• Sélectionnez la version la plus récente, puis cliquez sur « Download » pour enregistrer le package sur votre ordinateur.
• Lorsque le téléchargement est terminé, transférez le fichier.

3. Installer à partir d'un répertoire

Si vous avez téléchargé le paquet d'installation dans un dossier spécifique sur votre serveur, vous pouvez utiliser cette option d'installation. Saisissez le chemin du fichier pour ce dossier spécifique, puis cliquez sur le bouton Vérifier et installer. Joomla essaiera automatiquement d'ouvrir le paquet et d'exécuter l'installation.

4. Installer à partir d'une URL

En utilisant cette option, vous devez fournir à Joomla le lien URL direct pour le paquet d'installation. Le lien d'installation du paquet est le suivant :https://raw.github.com/brevo/joomla-plugin/master/build/J3/package/pkg_sendinblue_v1_0_0.zip.

Après avoir cliqué sur le bouton Vérifier et installer, Joomla tente d'ouvrir automatiquement le package et lance l'installation :

Configurer le composant Brevo

D'abord, copiez votre clé API v3 à partir de votre compte Brevo en suivant ce tutoriel.

Allez ensuite dans le panneau d'administration de Joomla, cliquez sur Composants > Brevo. Sur le Tableau de bord Brevo, sélectionnez l'icône API Paramètres.

Collez votre clé API v3 dans le champ correspondant.

Cliquez sur le bouton Enregistrer en haut de la page.  Vous verrez alors les données de votre compte Brevo sur votre Tableau de bord. Si vous ne voyez pas vos données, il est probable que vous n'utilisez pas une clé API valide.

Configurer des options avancées

Nous vous conseillons de laisser toutes les options avancées sur leur valeur par défaut. Si vous souhaitez modifier les paramètres d'un composant à l'échelle globale, cliquez sur le bouton Options situé en haut à droite de votre Tableau de bord.

Cette page vous permet de modifier les éléments suivants :

1. Paramètres globaux

• URL de base : l'URL utilisée pour toutes les requêtes API. Ne modifiez pas la valeur par défaut.
• Expiration de la connexion (secondes) : si vous rencontrez des problèmes de connectivité, essayez d'augmenter cette valeur.

2. Paramètres avancés

• Balise du template d'opt-in : balise utilisée dans les templates email de Brevo
• Nom de l'attribut double opt-in : nom de l'attribut Brevo utilisé lors du processus de confirmation
• Période de validité du lien opt-in (minutes) : temps accordé aux abonnés pour confirmer leur abonnement
• Dossier temporaire double opt-in et liste temporaire double opt-in : permettent de stocker temporairement des données au sujet d'un abonné jusqu'à ce que celui-ci confirme son abonnement

Étape 2 : synchronisation des utilisateurs et des contacts avec Brevo

Allez dans le panneau d'administration de Joomla, puis dans le Tableau de bord Brevo. Sélectionnez l'icône Exporter les contacts.

• Cette fonctionnalité vous permettra d'exporter les utilisateurs/contacts de Joomla et leurs données (c.-à-d. les adresses email et les noms).
• Gardez à l'esprit que l'identifiant unique d'un utilisateur/contact est son adresse email.

Sur le côté gauche, vous choisirez les options d'exportation pour vos utilisateurs et contacts Joomla. Sur le côté droit, vous choisirez la ou les listes Brevo auxquelles ils seront ajoutés, ainsi que la manière de gérer les utilisateurs/contacts existants.

1. Exporter des utilisateurs Joomla

Définissez « Oui » ou « Non » pour chaque option.

• Exporter tous les groupes d'utilisateurs
• En sélectionnant « oui », tous les groupes d'utilisateurs seront ajoutés à Brevo.
• En sélectionnant « Non », vous avez la possibilité de choisir des groupes d'utilisateurs spécifiques qui seront ajoutés à Brevo.
• Exportation bloquée : « Non » est sélectionné par défaut, ce qui signifie que les utilisateurs bloqués ne sont pas ajoutés à Brevo.  Si vous sélectionnez « Oui », tous les contacts bloqués seront ajoutés à Brevo.
• Exporter non groupé : « Non » est sélectionné par défaut. Cela signifie que tous les utilisateurs qui ne sont pas affectés à un groupe d'utilisateurs ne seront pas ajoutés à Brevo. Si vous sélectionnez « Oui », ils seront ajoutés à Brevo.

2. Exporter des contacts Joomla

Définissez « Oui » ou « Non » pour chaque option.

• Exporter toutes les catégories de contacts
• En sélectionnant « Oui », toutes les catégories de contacts seront ajoutées à Brevo.
• En sélectionnant « Non », vous avez la possibilité de sélectionner la catégorie de contacts qui sera ajoutée à Brevo.
• Exporter non publié : « Non » est sélectionné par défaut. Cela signifie que tous les contacts non publiés ne seront pas ajoutés à Brevo. Si vous sélectionnez « Oui », ils seront ajoutés à Brevo.

3. Options de listes

• Mode d'exportation : ce mode détermine ce qu'il faut faire avec les contacts qui existent déjà dans Brevo
• « Ajouter aux listes » : les utilisateurs/contacts resteront dans leurs listes Brevo existantes et seront ajoutés à toutes les nouvelles listes sélectionnées.
• « Réassigner aux listes » : les utilisateurs/contacts seront retirés de leurs listes Brevo existantes et seront ajoutés à toutes les nouvelles listes sélectionnées.
• Utiliser toutes les listes
• En sélectionnant « Oui », vos utilisateurs/contacts Joomla seront ajoutés à toutes vos listes Brevo.
• En sélectionnant « Non », vous avez la possibilité de choisir la ou les listes Brevo dans lesquelles vos utilisateurs/contacts Joomla seront ajoutés. Les options de la liste s'affichent dans le champ déroulant.

Exemple :

Notre contact, exemple@brevo.com est actuellement dans Liste 1, Liste 2 et Liste 3.

S'il fait partie d'un groupe qui doit être ajouté dans Liste 1, Liste 3 et Liste 4, alors :

• si le mode d'exportation est défini sur « ajouter aux listes » : exemple@brevo.com sera abonné aux quatre listes : Liste 1, Liste 2, Liste 3 et Liste 4 ;
• si le mode d'exportation est défini sur « Réassigner aux listes » : exemple@brevo.com ne sera abonné qu'à Liste 1, Liste 3 et Liste 4.

4. Options de nom de l'utilisateur / du contact

Cette option permet de gérer la façon dont le nom de votre utilisateur/contact Joomla sera divisé en attributs Brevo.

• Premier mot de l'attribut : sélectionnez FIRSTNAME dans le menu déroulant
• Reste des mots de l'attribut : sélectionnez LASTNAME dans le menu déroulant

Lorsque vous avez terminé de sélectionner vos options d'exportation, cliquez sur le bouton Exporter les contacts.

Créer un formulaire avec le paquet Joomla

1. Créez un formulaire

Dans le panneau d'administration de Joomla, cliquez sur Composants > Brevo. Sélectionnez l'icône Formulaires d'abonnement. Pour créer un nouveau formulaire d'abonnement, cliquez sur le bouton Nouveau en haut à gauche.

Sur cette page, vous verrez tous vos formulaires. Vous pouvez utiliser les boutons de modification standard de Joomla pour les gérer.

2. Nommez votre formulaire

Commencez par donner un nom à votre formulaire.

3. Sélectionnez votre (vos) liste(s)

Vous pouvez ici sélectionner la (les) liste(s) Brevo à laquelle (auxquelles) un visiteur sera abonné lorsqu'il soumettra le formulaire. Vous pouvez choisir n'importe quel nombre de listes dans différents dossiers.

4. Configurer l'e-mail de confirmation

Allez dans l'onglet Confirmation.

Lorsqu'un nouvel abonné soumet un formulaire, il y a plusieurs façons d'assurer le suivi :

• Pas de confirmation : les visiteurs seront inscrits à la (aux) liste(s) sélectionnée(s) sans aucune notification
• Confirmation simple : les visiteurs seront abonnés à la (aux) liste(s) sélectionnée(s) et notifiés par :
• un email de suivi : sélectionnez un template email sur votre compte Brevo qui sera envoyé pour souhaiter la bienvenue à votre nouvel abonné ;
• une page de confirmation : en sélectionnant « Oui », vous pouvez spécifier la page sur laquelle un visiteur sera redirigé après avoir soumis un formulaire avec succès. Saisissez simplement l'URL dans le champ « Page de confirmation personnalisée ».

• Double confirmation : les visiteurs qui soumettent un formulaire seront ajoutés à la liste Temp - DOUBLE OPTIN et un e-mail de confirmation leur demandant de cliquer pour confirmer leur abonnement leur sera envoyé. Une fois qu'ils auront cliqué, ils seront ajoutés à la (aux) liste(s) Brevo sélectionnée(s).
• Email opt-in : sélectionnez un template email de votre compte Brevo qui sera utilisé par votre nouvel abonné pour confirmer son abonnement. Note : le site template doit contenir la balise double opt-in car elle sera remplacée par un lien de confirmation généré.
• Une page de redirection de formulaire : en sélectionnant « Oui », vous pouvez spécifier la page sur laquelle un visiteur sera redirigé après avoir soumis un formulaire avec succès. Saisissez simplement l'URL dans le champ « Page de redirection du formulaire personnalisé ».
• Confirmation finale : en sélectionnant « Oui », votre nouvel abonné recevra un email de confirmation finale après avoir confirmé l'email opt-in. Sélectionnez un template email dans votre compte Brevo.
• Page de confirmation : en sélectionnant « Oui » votre nouvel abonné sera redirigé vers une page de confirmation après avoir confirmé l'email opt-in.  Saisissez simplement l'URL dans le champ « Page de confirmation personnalisée ». Il peut s'agir d'une page de remerciement ou d'une landing page sur laquelle vous fournissez des informations supplémentaires.

5. Personnaliser les messages d'information

Allez dans l'onglet Messages. Cet onglet permet de personnaliser les messages de base.

6. Ajouter des blocs et des champs de formulaire

Allez dans l'onglet blocs et champs du formulaire pour créer votre formulaire. Chaque formulaire est composé de blocs. Vous pouvez personnaliser chaque bloc pour qu'il ait différentes options et différentes représentations visuelles.

• Pour créer le premier bloc, cliquez sur l'icône « + » en haut à gauche du sous-formulaire de blocs.
• Pour créer le prochain bloc, cliquez sur l'icône « + » en bas à droite du dernier bloc.
• Pour supprimer un bloc, utilisez la croix rouge « X » dans le coin supérieur droit du bloc.
• En utilisant l'icône à trois points sur le côté gauche de chaque bloc, vous pouvez glisser-déposer les blocs pour les réorganiser. 

Il existe deux groupes de base de types de blocs :

1. Blocs « Type d'attribut » : ces blocs comporteront le mot « attribut » comme préfixe.  Ce type de bloc permet aux visiteurs d'intégrer des données spécifiques.
2. Blocs « Type spécifique » : ce type de blocs est utilisé pour créer des éléments dans le formulaire, par exemple, du texte, des images, un séparateur, entre autres.

Types de blocs :

Blocs de type spécifique :

• Texte et image : utilisés pour ajouter du texte ou des images personnalisés au formulaire, ajoutez du contenu à l'aide de l'éditeur de texte. Assurez-vous que l'éditeur est configuré dans vos paramètres d'utilisateur.
• Séparateur : permet d'ajouter un séparateur afin de rendre le formulaire plus lisible.
• Opt-in : permet d'ajouter une case à cocher « opt-in ».  Les visiteurs ne pourront pas soumettre un formulaire si cette case n'est pas cochée.
• Captcha : permet d'ajouter un captcha à un formulaire.  Pour utiliser ce type de bloc, vous devez avoir installé et activé le plugin captcha sur votre site web. Il est fortement recommandé que chaque formulaire comporte un champ captcha.

Blocs de type d'attribut :

• Email : utilisé pour permettre aux visiteurs d'entrer leur adresse email. Une adresse email valide est requise et sera signalée si elle n'est pas saisie correctement.
• Texte de l'attribut : utilisé pour permettre aux visiteurs de saisir une valeur textuelle, par exemple, « Nom ».
• Numéro d'attribut : utilisé pour permettre aux visiteurs de saisir une valeur numérique ; la saisie sera validée s'il s'agit d'une valeur numérique.
• Date de l'attribut : utilisé pour permettre aux visiteurs d'entrer une valeur de date ; les visiteurs auront un calendrier présenté pour entrer la valeur, par exemple, « Date de naissance ».
• Changer d'attribut : utilisé pour permettre aux visiteurs d'entrer une valeur Oui/Non.  Le visiteur verra la case à cocher.
• Choix unique d'attribut : utilisé pour permettre aux visiteurs de faire une sélection à partir d'une liste d'options. Le visiteur verra des boutons radio ou des cases à cocher.

Les deux types de blocs, spécifique et attribut, disposent des paramètres suivants :

• visible : ce bouton vous permet d'activer ou de désactiver facilement un bloc.
• classe de bloc : classe ajoutée au bloc.
• style : règles de style CSS spécifiques ajoutées à un bloc, un attribut de style de l'élément de bloc.
• classe de contrôle de bloc : classe ajoutée pour contrôler les éléments à l'intérieur d'un bloc.

La plupart des types de blocs d'attributs ont les boutons et les paramètres suivants :

• changement obligatoire : les visiteurs doivent saisir une valeur dans ce champ.
• afficher le libellé avec la possibilité de saisir le texte du libellé : vous pouvez définir et choisir si le libellé doit s'afficher à côté d'un champ.
• afficher l'aide, avec la possibilité de saisir le texte d'aide : vous pouvez définir et choisir si des explications supplémentaires doivent être affichées.

Lorsque vous avez terminé de créer votre formulaire, cliquez sur le bouton Enregistrer en haut à gauche.

7. Ajouter un formulaire

Pour afficher les formulaires que vous avez créés, connectez-vous à votre panneau d'administration Joomla :

1. Allez dans Extensions > Modules.
2. Cliquez sur le bouton +Nouveau en haut à gauche.
3. Sélectionnez le formulaire d'abonnement Brevo.

Commencez par ajouter un titre.

Dans ce module, vous devrez sélectionner le formulaire d'abonnement que vous venez de créer.

Des paramètres supplémentaires permettent d'ajouter du texte avant et après le module. Si votre site web n'est pas en anglais, nous vous recommandons de définir le paramètre du module sur le libellé du bouton.

Définissez d'autres paramètres standard tels que :

• Afficher le titre : si vous sélectionnez « Afficher », le titre sera affiché sur votre site.
• Position : choisissez l'endroit où le formulaire apparaîtra sur votre site.

En fonction de la version du template Joomla utilisé par votre site web et des autres éléments de style supplémentaires, il est important de comprendre la représentation visuelle de votre formulaire fini. 

Le module utilise les contrôles et les classes de formulaire standard de Joomla pour le rendu des formulaires et il existe des options pour ajouter des classes et des styles pour chaque bloc de formulaire. C'est pourquoi votre formulaire peut être facilement personnalisé en fonction de vos préférences.

Par exemple, si vous avez le type de bloc « choix simple d'attribut » dans votre formulaire et que vous utilisez la version par défaut du template Joomla « Protostar », en définissant le paramètre « classe de contrôle du bloc » sur « btn-group btn-group-yesno » pour ce bloc, vous obtiendrez des boutons radio rendus avec les classes de boutons par défaut de Joomla, ce qui devrait également exister dans de nombreux autres modèles.

Envoyez des emails transactionnels via Brevo,

1. Configurer le mot de passe SMTP

Depuis votre panneau d'administration Joomla, sur le Tableau de bord Brevo, cliquez sur l'icône SMTP Paramètres pour configurer vos emails transactionnels.

Collez votre mot de passe SMTP et cliquez sur le bouton Définir les paramètres d'email Joomla. La configuration de Joomla sera mise à jour.

2. Envoyer un email de test

Vous pouvez envoyer un email de test pour confirmer que tout se passe bien : 

• Saisissez votre adresse email dans le champ Email de test.
• Cliquez sur le bouton Envoyer un email de test .
• Vérifiez vos emails.

Cet email de test sera également enregistré dans les Logs transactionnels de votre compte Brevo.

Suivez l'activité de votre site web grâce à l'automatisation du marketing

Définir l'automatisation marketing

Tout d'abord, assurez-vous que vous avez activé l'automatisation marketing sur votre compte Brevo. Pour ce faire, connectez-vous, allez dans l'onglet automatisation du menu supérieur et cliquez sur le bouton ESSAYER GRATUITEMENT. 

Lorsque vous installez le paquet Joomla, le plugin d'automatisation marketing Brevo est automatiquement disponible. Il ne vous reste plus qu'à l'activer. 

Depuis votre panneau d'administration Joomla, sur le Tableau de bord Brevo. Cliquez sur l'icône Automatisation marketing.

1. Cliquez sur le bouton Activer le plugin.
   
2. Cliquez sur le bouton Définir l'identifiant de suivi du plugin. Cela permettra de récupérer l'ID de suivi de l'automatisation marketing de votre compte Brevo.

Suivi de l'activité du site web

Maintenant que le tracker d'automatisation Brevo est intégré à votre site web, toutes les pages visitées par vos contacts seront automatiquement suivies. Vous trouverez ces logs dans votre compte Brevo sous automatisation > Logs > log d'événements :

• page
• identifier

Consultez ce guide pour en savoir plus sur l'utilisation de vos logs d'automatisation. 

Automatiser vos communications marketing

L'automatisation utilise les « scénarios » pour créer des expériences marketing en plusieurs étapes pour vos contacts :

• Envoyer un message de bienvenue à votre nouvelle liste d'abonnés  
• Créer une série d'emails de bienvenue pour les nouveaux utilisateurs du site web

Les scénarios peuvent également vous aider à gérer les processus marketing internes, tels que : 

• Attribuer une note aux nouveaux clients potentiels en fonction de leur comportement sur votre site web
• Ajouter de nouveaux attributs à vos contacts actuels ou les déplacer dans une nouvelle liste sur la base d'un achat récent 

Vous pouvez déclencher le démarrage d'un scénario en fonction de nombreux éléments, y compris lorsque les contacts : 

• sont identifiés sur votre site web ;
• visitent une page ;
• sont ajoutés à une liste de contacts ;
• et plus encore !

Brevo propose des modèles de scénario prêts à l'emploi ou vous pouvez faire preuve de créativité et créer un scénario personnalisé pour répondre à vos besoins.

Consultez ce guide pour en savoir plus sur la création d'un scénario d'automatisation ou visitez Automatisation et créez votre premier scénario dès aujourd'hui. 

⏭ Et après ?

• 6 raisons d'adopter l'automatisation marketing
• Qualifiez vos contacts à l'aide du système de notation de Brevo

🤔 Vous avez des questions ?

Pour toute question, n’hésitez pas à contacter notre service client en créant un ticket à partir de votre compte. Si vous n’avez pas encore de compte, vous pouvez nous contacter ici.

Si vous avez besoin d'aide pour un projet impliquant Brevo, nous pouvons vous mettre en relation avec un Partenaire Brevo certifié.