Brevo / Q3 - Subscribe newsletter

1 - Création du fichier YAML

Objectif : Préparer un fichier YAML qui servira de configuration pour faire le lien entre votre projet et le compte Brevo. Ce fichier contiendra les informations essentielles, avec des champs dynamiques qui seront remplacés automatiquement par des variables provenant du formulaire.

1.1 Hébergement

Le fichier YAML doit être stocké dans l’hébergement suivant :
🔗 URL de l'hébergement : https://vault.zoho.eu/app#passcard/36734000000091031

1.2 Chemin d’accès

Le fichier doit être placé dans le répertoire suivant :
📂 Path : /web/storage/yaml/collections

1.3 Structure du fichier YAML

Le fichier doit contenir les informations nécessaires au lien entre le projet et le compte Brevo. Voici un exemple de structure avec des champs dynamiques entourés de {% %} :

1.4 Exemple de fichier YAML : 

apikey : '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'
data:
  contact:
    email: '{%request.email%}'
    emailBlacklisted: '{% request.newsletter %}'
    doubleOptin:
      language: '{%request.language%}'
      template:
        fr: 7
        de: 8
        default: 7
      redirect:
        fr: 'https://www.pidal.lu/fr/confirmation-abonnement-newsletter'
        de: 'https://www.pidal.lu/de/confirmation-abonnement-newsletter'
        default: 'https://www.pidal.lu/fr/confirmation-abonnement-newsletter'
    lists:
      - 5  # Contact Website
    attributes:
      LANG: '{% request.lang %}'
      FIRSTNAME: '{% request.firstname %}'
      LASTNAME : '{% request.lastname %}'

Détails des champs YAML pour Brevo

• api_key :
  Clé API du compte Brevo.
  
  

• data.contact.email :
  Champ obligatoire pour récupérer l'email saisi dans le formulaire.
  
  

• data.contact.emailBlacklisted (optionnel) :
  Si absent, tous les contacts seront ajoutés à la liste.
  Par exemple, pour une case "newsletter" cochée (valeur 1), l'application inverse cette valeur (false) pour ne pas blacklister le contact.
  
  

• data.contact.doubleOptin (optionnel) :
  Active le double opt-in si présent, sinon le contact est enregistré directement.
  
  

  • Multilingue :

    • Si le site est multilingue, utilisez la variable language pour adapter les template emails Brevo et les pages de confirmation.
    • Sinon, utilisez les valeurs par défaut pour le template et la redirection.
      
      
• data.contact.lists :
  ID de la ou des listes Brevo sous forme de tableau.
  
  
• data.contact.attributes :
  Permet de renseigner les champs personnalisés (custom fields) des listes Brevo.

 

---

 

2 - Liaison formulaire Q3

Pour configurer la liaison entre le formulaire Q3 et Brevo, ajoutez un champ de type http dans la configuration du formulaire. Ce champ permet d’envoyer les données du formulaire directement à l’API Brevo via un post.

 actions:
      name: Actions
      fields:
        brevo:
          type: http
          config:
            src: 'https://brevo.e-connect.lu/api/brevo/register/{nom_du_fichier_yaml}'
            method: POST
            timeout: 10

 

---

 

3 - Gestion des erreurs

En cas d'erreur, Greg reçoit automatiquement toutes les notifications par email.

 

4 - Template Brevo

 

N'oubliez pas d'ajouter le tag "optin" sur le template Brevo pour le double opt-in, sinon cela ne fonctionnera pas.