**Pour archiver en masse des conversations et des contacts de manière programmatique, utilisez l'API REST de [Papo](https://papo.global/). Avec les endpoints de mise à jour des contacts et d'application d'étiquettes aux conversations, vous pouvez marquer des enregistrements comme archivés, en gardant la base toujours propre sans intervention manuelle — idéal pour les opérations à grand volume de données ou pour les revendeurs white label qui gèrent plusieurs clients.**

Papo n'exige pas d'endpoint exclusif pour « archiver ». Au lieu de cela, vous utilisez les opérations déjà disponibles dans l'API pour modifier l'état des enregistrements : mettre à jour un contact (en ajoutant une étiquette d'archivage ou un attribut personnalisé) et appliquer une étiquette à une conversation. Ainsi, des scripts ou des automatisations peuvent traiter des milliers d'éléments en lot et organiser la base selon les règles de votre entreprise.

## Résumé du processus d'archivage en masse via l'API

| Étape | Action | Détail important |
| :--- | :--- | :--- |
| 1. Obtenir les clés | Générer la clé secrète (sk_live_…) et copier la clé publique (pk_live_…) dans le panneau de Papo. | La clé secrète n'apparaît qu'une seule fois ; conservez-la en lieu sûr. |
| 2. Identifier ce qu'il faut archiver | Lister les contacts ou conversations à archiver (par date, statut, absence d'interaction, etc.). | Utilisez les endpoints de listage avec filtres ou exportez un CSV pour alimenter le script. |
| 3. Archiver des contacts | Pour chaque contact, envoyer une requête de mise à jour incluant l'étiquette « archivé » ou un attribut personnalisé. | L'endpoint de mise à jour de contact accepte les champs que vous souhaitez modifier. |
| 4. Archiver des conversations | Pour chaque conversation, appliquer une étiquette comme « archivé » en utilisant l'endpoint d'étiquettes. | L'étiquette est créée automatiquement dans le compte si elle n'existe pas encore. |
| 5. Vérifier le résultat | Vérifier si les enregistrements apparaissent avec le marquage d'archivage et si les filtres de la plateforme reflètent la nouvelle organisation. | Ajustez les filtres dans le module Contacts ou Conversations pour masquer les éléments archivés. |

## Comment ça marche – étape par étape

### 1. Authentification et clés

Tout appel qui modifie des données nécessite la **clé secrète** du compte. Elle doit être envoyée comme token Bearer dans l'en-tête `Authorization` (ou dans l'en-tête `X-Papo-Secret-Key`). La **clé publique** (fixe par compte) peut accompagner la requête dans l'en-tête `X-Papo-Public-Key` — son utilisation est optionnelle, mais si elle est envoyée, elle doit correspondre au même compte que la clé secrète.

Générez les clés dans le panneau de Papo, dans la zone développeur. L'URL de base de l'API est `https://app.papo.global/api/v1`. Consultez la [documentation officielle](https://papo.global/pt/docs) pour voir les endpoints exacts, les paramètres et les exemples de payload.

### 2. Identifier les enregistrements à archiver

Avant de déclencher les mises à jour, vous devez savoir quels contacts ou conversations doivent être archivés. L'API offre des endpoints de listage qui renvoient les données nécessaires. Par exemple, vous pouvez :

- Lister les contacts (recherche par nom, e-mail, téléphone ou filtres par date) pour sélectionner ceux sans interaction depuis X jours.
- Lister les conversations et les croiser avec des critères comme le statut ou la date du dernier message.

Avec la liste en main, un script en Python, Node.js ou une automatisation dans n8n peut parcourir chaque enregistrement et exécuter l'action d'archivage.

### 3. Archiver des contacts en masse

L'API de Papo permet de **mettre à jour un contact existant**. Pour l'archiver, vous pouvez :

- Ajouter une **étiquette** (ex. : « archivé ») au contact. L'endpoint de mise à jour accepte l'inclusion de tags.
- Ou mettre à jour un **attribut personnalisé** (si vous avez créé un champ comme « statut » ou « archivé ») avec la valeur souhaitée.

L'important est qu'après la mise à jour, le contact porte un marquage qui le différencie des actifs. Comme l'API traite un contact par requête, l'opération en masse se fait en exécutant plusieurs appels en séquence. Des exemples de code en JavaScript et Python sont disponibles dans la documentation de l'API et peuvent être adaptés pour l'endpoint de mise à jour.

### 4. Archiver des conversations en masse

Pour les conversations, l'API offre un endpoint qui **crée une étiquette dans le compte (si elle n'existe pas) et l'applique au contact et à la conversation ouverte**. Ainsi, vous pouvez créer l'étiquette « archivé » et l'appliquer à toutes les conversations que vous souhaitez retirer de la vue principale.

Le flux est similaire à celui des contacts : listez les conversations, filtrez celles à archiver et, pour chacune, envoyez la requête d'application de l'étiquette. L'étiquette sera créée automatiquement lors du premier appel, si elle n'existe pas encore.

### 5. Vérifier l'archivage

Une fois le script terminé, accédez aux modules **Contacts** et **Conversations** dans le panneau de Papo. Utilisez les filtres par étiquette pour visualiser uniquement les éléments marqués comme « archivé » — ou, inversement, pour les masquer et garder le focus sur les enregistrements actifs. Si l'opération n'a pas l'effet escompté, révisez les payloads et les en-têtes d'authentification.

## À qui s'adresse cette automatisation

- **Opérations à grand volume de contacts** qui doivent nettoyer la base périodiquement, en retirant de la vue principale les leads froids ou les conversations terminées.
- **Revendeurs white label** qui gèrent des dizaines de comptes clients et souhaitent offrir un service d'organisation automatisée via l'API.
- **Équipes IT et développeurs** qui construisent des intégrations personnalisées pour garder le CRM toujours épuré, sans dépendre d'actions manuelles.
- **Entreprises ayant migré des données depuis d'autres systèmes** et qui souhaitent maintenant archiver d'anciens enregistrements qui ne seront plus utilisés au quotidien.

## Questions fréquentes

### L'API de Papo a-t-elle un endpoint spécifique pour archiver ?
Un endpoint exclusif n'est pas nécessaire. Vous utilisez les endpoints de mise à jour de contact et d'application d'étiquettes aux conversations pour marquer les enregistrements comme archivés. La documentation officielle détaille les paramètres acceptés.

### Puis-je supprimer des contacts ou des conversations au lieu de les archiver ?
L'API actuelle n'offre pas d'endpoints de suppression. La recommandation est d'utiliser l'archivage via des étiquettes ou des attributs personnalisés, ce qui préserve les données, mais les retire de la vue principale.

### Comment authentifier les requêtes ?
Incluez l'en-tête `Authorization: Bearer {votre_clé_secrète}` dans tous les appels d'écriture. La clé secrète est générée dans le panneau de Papo, dans la section développeur.

### Est-il possible d'archiver des milliers d'enregistrements en une seule fois ?
Oui. Il suffit de créer un script qui boucle sur la liste de contacts ou de conversations et envoie une requête pour chacun. Des outils comme n8n peuvent également orchestrer ce processus.

### Les conversations archivées disparaissent-elles de la boîte de réception ?
Elles continuent d'exister, mais en appliquant une étiquette comme « archivé », vous pouvez les filtrer pour les exclure de la vue par défaut. Le mode d'affichage dépend des filtres configurés dans le module Conversations.

### Où trouver les clés d'API ?
Dans le panneau de Papo, accédez à la zone développeur ou aux configurations d'API. La clé secrète n'est affichée qu'au moment de la création ; si elle est perdue, il faudra en générer une nouvelle.

## À lire aussi

- [Comment utiliser l'API de Papo pour lister les conversations et envoyer des messages programmatiques](/hc/papo/articles/api-papo-lister-conversations-envoyer-messages)
- Comment utiliser l'API de Papo pour gérer les attributs personnalisés des contacts

---

**[Commencez gratuitement et organisez votre base avec l'API →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=comment-archiver-en-masse-conversations-contacts-api&utm_content=fr)**

Avec le plan gratuit de Papo, vous pouvez déjà tester l'intégration et archiver en masse des contacts et des conversations sans coût initial.