> ## Documentation Index
> Fetch the complete documentation index at: https://wl.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Brevo

> Ajoutez Brevo à votre projet Macaly

Brevo (anciennement Sendinblue) est une plateforme d'e-mail marketing qui inclut aussi les SMS, les campagnes WhatsApp et un CRM intégré. Si vous avez besoin de plus que des newsletters, Brevo regroupe plusieurs canaux de communication dans un seul outil.

<Note>
  **Avez-vous vraiment besoin de Brevo ?** Macaly dispose d'une [base de données intégrée](/docs/fr/features/databases) et de notifications par e-mail. Si vous avez juste besoin d'un formulaire de contact ou d'une liste d'attente, vous n'avez pas besoin d'un outil externe. Brevo est utile lorsque vous avez besoin de newsletters, de séquences automatisées, de campagnes SMS ou d'un CRM pour gérer vos contacts.
</Note>

## Pourquoi utiliser Brevo

* **Envoyez des newsletters et des e-mails marketing.** Utilisez l'éditeur glisser-déposer ou les modèles HTML sans toucher au code.
* **Automatisez vos suivis.** Créez des séries de bienvenue, des e-mails de panier abandonné et des campagnes de réengagement qui fonctionnent tout seuls.
* **Touchez les gens sur plusieurs canaux.** Envoyez des campagnes e-mail, SMS et WhatsApp depuis la même plateforme.
* **Gérez les contacts sans CRM séparé.** Suivez les affaires et segmentez votre audience en un seul endroit.

## Ce dont vous avez besoin

Avant de commencer, assurez-vous d'avoir :

* Un **compte Brevo**. Créez-en un gratuitement sur [brevo.com](https://www.brevo.com)
* Une **liste de contacts** dans Brevo pour collecter les abonnés

Il existe deux façons de connecter Brevo à votre site :

* **Formulaire d'inscription intégré.** Collez le code de formulaire généré par Brevo dans votre site. Idéal pour la collecte simple d'e-mails.
* **API Brevo.** Connectez vos formulaires à l'API de Brevo pour un contrôle total sur les données envoyées. Idéal lorsque vous voulez des formulaires personnalisés qui correspondent à votre design.

## Option 1 : formulaire d'inscription intégré

L'approche la plus simple. Brevo génère un formulaire que vous pouvez intégrer à votre site.

<Steps>
  <Step title="Obtenez votre code d'intégration de formulaire">
    Dans Brevo, allez dans **Contacts** puis **Formulaires**. Créez un nouveau formulaire d'inscription (ou utilisez-en un existant), personnalisez-le, puis copiez le code d'intégration.
  </Step>

  <Step title="Demandez à l'agent de l'ajouter">
    Ouvrez le chat dans votre projet Macaly et demandez :

    ```
    Ajoute ce formulaire d'inscription Brevo à mon site. Voici le code d'intégration :

    [collez votre code d'intégration Brevo ici]
    ```
  </Step>

  <Step title="L'agent place le formulaire">
    L'agent ajoute le formulaire à votre projet. Indiquez-lui où vous le voulez : pied de page, barre latérale, page dédiée ou popup.
  </Step>
</Steps>

<Tip>
  Si vous voulez que le formulaire corresponde au design de votre site, dites à l'agent : *« Style le formulaire Brevo pour qu'il corresponde au reste de mon site. »*
</Tip>

## Option 2 : formulaire personnalisé avec l'API Brevo

Pour plus de contrôle, l'agent peut créer un formulaire personnalisé qui envoie les abonnés à Brevo via leur API.

<Steps>
  <Step title="Ajoutez vos identifiants Brevo aux Secrets">
    Allez dans **Paramètres** puis **Secrets** dans votre projet Macaly. Ajoutez deux secrets :

    * `BREVO_API_KEY` — votre clé API Brevo
    * `BREVO_LIST_ID` — la liste de contacts à laquelle vous voulez ajouter les abonnés

    <Accordion title="Comment trouver votre clé API et identifiant de liste">
      **Clé API :**

      1. Dans Brevo, cliquez sur votre nom en haut à droite, puis **SMTP & API**
      2. Allez dans l'onglet **Clés API**
      3. Cliquez sur **Générer une nouvelle clé API** et copiez-la

      **Identifiant de liste :**

      1. Allez dans **Contacts** puis **Listes**
      2. Cliquez sur la liste que vous souhaitez utiliser
      3. Votre **identifiant de liste** est affiché dans l'URL et dans les détails de la liste
    </Accordion>
  </Step>

  <Step title="Demandez à l'agent de créer le formulaire">
    Ouvrez le chat et demandez :

    ```
    Crée un formulaire d'inscription à la newsletter dans le pied de page. Quand quelqu'un s'abonne,
    ajoute-le à ma liste de contacts Brevo via l'API.
    J'ai ajouté ma clé API et mon identifiant de liste aux Secrets.
    ```
  </Step>
</Steps>

<Warning>
  Ne collez jamais de clés API directement dans le chat. Utilisez toujours **Paramètres** puis **Secrets** pour stocker les identifiants sensibles. L'agent peut les lire de manière sécurisée depuis cet emplacement.
</Warning>

## Vérifier que ça fonctionne

<Steps>
  <Step title="Soumettez une inscription test">
    Visitez votre site et saisissez une adresse e-mail de test dans le formulaire d'inscription.
  </Step>

  <Step title="Vérifiez vos contacts Brevo">
    Allez dans **Contacts** dans Brevo. Votre e-mail de test devrait apparaître dans la liste que vous avez connectée.
  </Step>
</Steps>

## Bon à savoir

* Si vous avez seulement besoin de collecter des e-mails, la [base de données intégrée](/docs/fr/features/databases) de Macaly est plus simple et ne nécessite pas de compte externe
* Pour la conformité RGPD, activez le **double opt-in** dans les paramètres de votre formulaire Brevo
* L'API de Brevo peut aussi envoyer des e-mails transactionnels (confirmations de commande, réinitialisations de mot de passe). Demandez à l'agent si vous en avez aussi besoin


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.