**Avec l’API de Papo (https://papo.global/), vous automatisez la création, l’envoi et l’analyse de campagnes d’e‑mail marketing directement depuis votre système, sans accéder manuellement au tableau de bord. Les endpoints d’Email Marketing permettent de gérer les campagnes, les templates, les audiences et les métriques de performance via des appels REST, en utilisant la même authentification par clé secrète que le reste de l’API.**

## Résumé des opérations via l’API

| Opération | Ce que vous pouvez faire par programmation |
| :--- | :--- |
| **Lister les campagnes** | Obtenir la liste des campagnes avec des métriques (envois, ouvertures, clics) pour alimenter des tableaux de bord ou des rapports. |
| **Créer une campagne en brouillon** | Créer une nouvelle campagne d’e‑mail à l’état de brouillon, en définissant l’audience, le template, l’expéditeur et la planification. |
| **Déclencher une campagne** | Lancer (envoyer) une campagne déjà en brouillon ou en pause, en démarrant les envois réels. |
| **Envoyer un e‑mail individuel** | Envoyer immédiatement un seul e‑mail, idéal pour les communications transactionnelles ou les tests. |
| **Lister les templates** | Récupérer les modèles d’e‑mail enregistrés dans le compte pour les réutiliser dans les campagnes. |
| **Lister les audiences** | Obtenir les listes de contacts (audiences) disponibles, y compris les dynamiques, pour une segmentation automatique. |

Toutes les opérations suivent le standard REST, avec des réponses en JSON et une authentification via `Authorization: Bearer <secret_key>`. Comme tout autre endpoint de Papo, vous avez besoin d’une clé secrète (`sk_live_…`) générée dans le tableau de bord dans **Developers**.

## Comment ça marche : automatiser le cycle complet d’une campagne

### 1. Authentifiez‑vous et explorez les endpoints

Avant tout appel, obtenez votre clé secrète dans le tableau de bord de Papo (section **Developers**). L’URL de base est la même que celle de l’API générale, et toutes les requêtes doivent inclure l’en-tête d’autorisation. Une fois la clé en main, vous pouvez lister les audiences et les templates existants pour planifier la campagne.

### 2. Créez une campagne en mode brouillon

Utilisez l’endpoint de création de campagne d’e‑mail (mode brouillon) pour préparer l’envoi sans l’envoyer immédiatement. Dans la requête, vous indiquez :
- Les identifiants d’envoi (boîte e‑mail configurée).
- L’ID du template (ou le payload du contenu si vous créez inline).
- L’audience (ID de la liste ou un tableau de contacts).
- Des configurations optionnelles comme la date/heure de planification et les fenêtres d’envoi.

La réponse renvoie l’identifiant unique de la campagne, ce qui vous permet de la récupérer ultérieurement.

### 3. Déclenchez la campagne ou planifiez l’envoi

Avec l’ID de la campagne en main, vous pouvez la déclencher (lancer) avec un autre appel. Si vous préférez une planification automatique, il suffit d’inclure les champs de date et d’heure au moment de la création – la campagne restera en brouillon programmé et sera envoyée au moment défini.

### 4. Suivez les performances

Utilisez l’endpoint de listage des campagnes pour consulter les métriques à tout moment. Vous recevrez des données telles que le total des envois, le taux d’ouverture et le nombre de clics. Ces chiffres peuvent être importés dans des tableaux de bord de votre système (par exemple, Google Data Studio, Power BI ou des feuilles de calcul) à l’aide d’appels périodiques ou de webhooks.

## Cas d’usage typiques

- **Nurturing de leads piloté par les événements :** Un webhook de votre ERP indique qu’un lead a atteint un certain score ; votre système déclenche automatiquement une campagne d’e‑mail via l’API, en faisant passer le lead à l’étape suivante.
- **Rapports d’entreprise unifiés :** Votre outil de BI consulte périodiquement les métriques des campagnes et les combine avec les données de ventes, le tout de manière programmée.
- **Automatisations dans n8n ou Zapier :** Créez des flux qui, à la réception d’un nouveau contact dans le CRM, créent un brouillon de campagne de bienvenue et la déclenchent sans intervention manuelle.
- **Revente en marque blanche :** Intégrez la création et la gestion de campagnes dans votre propre portail client, en conservant l’identité visuelle de votre marque tout en utilisant l’infrastructure de Papo.

## À qui s’adresse cette solution

- Développeurs et équipes informatiques qui souhaitent intégrer le marketing par e‑mail à des systèmes internes.
- Agences qui doivent générer des campagnes en lot pour des dizaines de clients sans accéder au tableau de bord de chacun.
- Revendeurs en marque blanche qui veulent proposer l’envoi d’e‑mails dans le cadre de leur portefeuille d’offres, contrôlé via l’API.
- Entreprises qui utilisent des automatisations dans n8n, Zapier ou des scripts personnalisés.

## Questions fréquentes

### Ai-je besoin d’une clé API différente pour utiliser les endpoints d’Email Marketing ?
Non. Les mêmes clés (publique et secrète) que vous utilisez déjà pour les autres ressources de Papo fonctionnent sur les endpoints d’e‑mail. L’authentification est la même, via l’en-tête `Authorization: Bearer`.

### Puis-je envoyer un seul e‑mail, comme une notification transactionnelle ?
Oui. L’API permet des envois individuels et immédiats, sans avoir besoin de créer une campagne. Il suffit d’indiquer le destinataire, l’objet, le contenu et les identifiants d’envoi.

### Comment savoir si la campagne a réellement été déclenchée ?
Lorsque vous appelez l’endpoint de lancement, l’API renvoie le statut de la campagne. Ensuite, vous pouvez consulter la liste des campagnes pour vérifier si le statut est passé de « brouillon » à « en cours d’envoi » ou « terminée » et obtenir les métriques de progression.

### Quelles métriques l’API renvoie-t-elle ?
Les réponses incluent au moins le total d’e‑mails envoyés, les ouvertures et les clics. Les champs exacts disponibles sont documentés dans l’endpoint de listage, qui peut être exploré avec des outils comme Postman ou l’interface de découverte de l’API elle-même.

### Puis-je créer des templates d’e‑mail via l’API ?
La fonctionnalité actuelle de listage des templates permet de récupérer les modèles déjà existants dans le compte. La création de nouveaux templates peut se faire via le tableau de bord ; vérifiez la documentation à jour pour confirmer si la route de création est disponible via l’API.

### Est-il possible de planifier une campagne pour une date spécifique ?
Oui. Lors de la création du brouillon, vous pouvez indiquer la date et l’heure souhaitées. La campagne restera dans cet état et sera envoyée automatiquement au moment programmé, à condition qu’elle ne soit pas mise en pause manuellement.

## À lire aussi

- [Comment utiliser l’API de Papo pour gérer les séquences de suivi](/hc/papo/articles/comment-utiliser-api-papo-gerer-sequences-suivi)
- [Comment utiliser l’API de Papo pour créer et mettre à jour des contacts en masse](/hc/papo/articles/comment-utiliser-api-papo-creer-mettre-a-jour-contacts-masse)

---

**[Commencez gratuitement →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=comment-utiliser-api-papo-gerer-campagnes-email-marketing&utm_content=fr)**

Centralisez vos canaux, automatisez les réponses avec l’IA et gérez les campagnes d’e‑mail — le tout dans un seul tableau de bord, sans coût initial.