> ## 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.

# Mailchimp

> Ajoutez Mailchimp à votre projet Macaly

Mailchimp vous permet de collecter des abonnés par e-mail, d'envoyer des newsletters et de lancer des campagnes e-mail automatisées. Si vous voulez créer et développer une liste de diffusion depuis votre site Macaly, Mailchimp est l'un des moyens les plus populaires de le faire.

<Note>
  **Avez-vous vraiment besoin de Mailchimp ?** 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. Mailchimp est utile lorsque vous avez besoin de newsletters, de campagnes de drip ou de segmentation d'audience.
</Note>

## Pourquoi utiliser Mailchimp

* **Développez votre liste depuis votre site.** Collectez des abonnés et gérez-les en un seul endroit. Segmentez par centres d'intérêt, source d'inscription ou comportement.
* **Envoyez des newsletters sans toucher au code.** Concevez et envoyez des campagnes e-mail à votre audience. Planifiez-les ou envoyez-les instantanément.
* **Automatisez vos suivis.** Configurez des e-mails de bienvenue, des séquences de drip et des rappels de panier abandonné qui fonctionnent tout seuls.
* **Voyez ce qui fonctionne vraiment.** Suivez les taux d'ouverture, les taux de clic et quels liens génèrent le plus d'engagement.

## Ce dont vous avez besoin

Avant de commencer, assurez-vous d'avoir :

* Un **compte Mailchimp**. Créez-en un gratuitement sur [mailchimp.com](https://mailchimp.com)
* Une **audience Mailchimp** (liste de diffusion) pour collecter les abonnés

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

* **Formulaire d'inscription intégré.** Collez le code de formulaire généré par Mailchimp dans votre site. Idéal pour la collecte simple d'e-mails.
* **API Mailchimp.** Connectez vos formulaires à l'API de Mailchimp 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. Mailchimp génère un formulaire que vous pouvez intégrer à votre site.

<Steps>
  <Step title="Obtenez votre code d'intégration de formulaire">
    Dans Mailchimp, allez dans **Audience** puis **Formulaires d'inscription** puis **Formulaires intégrés**. Personnalisez les champs souhaités, puis copiez le code HTML généré.
  </Step>

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

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

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

  <Step title="L'agent place le formulaire">
    L'agent ajoute le formulaire à votre projet. Vous pouvez lui indiquer exactement où vous le voulez, comme le pied de page, une page dédiée ou un popup.
  </Step>
</Steps>

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

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

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

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

    * `MAILCHIMP_API_KEY` — votre clé API Mailchimp
    * `MAILCHIMP_AUDIENCE_ID` — l'audience à laquelle vous voulez ajouter les abonnés

    <Accordion title="Comment trouver votre clé API et identifiant d'audience">
      **Clé API :**

      1. Dans Mailchimp, cliquez sur votre icône de profil, puis **Compte et facturation**
      2. Allez dans **Extras** puis **Clés API**
      3. Cliquez sur **Créer une clé** et copiez-la

      **Identifiant d'audience :**

      1. Allez dans **Audience** puis **Tous les contacts**
      2. Cliquez sur **Paramètres** puis **Nom et paramètres par défaut de l'audience**
      3. Votre **identifiant d'audience** est affiché sur cette page
    </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 à mon audience Mailchimp via l'API.
    J'ai ajouté ma clé API et mon identifiant d'audience 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 votre audience Mailchimp">
    Allez dans **Audience** puis **Tous les contacts** dans Mailchimp. Votre e-mail de test devrait apparaître comme nouvel abonné.
  </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 audience Mailchimp. Cela envoie un e-mail de confirmation avant d'ajouter quelqu'un à votre liste
* L'agent peut aussi configurer des formulaires pop-up et des formulaires coulissants si vous voulez quelque chose de plus visible qu'une inscription en ligne


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