Pour créer et mettre à jour des contacts en masse via programmation, utilisez l'API REST de Papo. Avec l'authentification par clé secrète (Bearer token) et la clé publique du compte, vous pouvez envoyer des requêtes qui insèrent de nouveaux enregistrements ou modifient des données existantes dans le CRM — idéal pour synchroniser des bases externes, migrer des listes ou maintenir le registre toujours à jour sans intervention manuelle.
L'API de Papo expose des endpoints d'écriture qui permettent de créer un contact (avec nom, e-mail et/ou téléphone) et de mettre à jour un contact existant. Combinés à l'authentification simple et au format JSON, ces endpoints rendent possibles les opérations en masse lorsqu'elles sont exécutées en séquence par des scripts, des outils d'automatisation (comme n8n) ou des intégrations personnalisées.
Résumé du processus d'intégration
| É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. Authentifier les appels | Inclure l'en-tête Authorization: Bearer sk_live_… dans toutes les requêtes d'écriture. |
La clé publique peut être envoyée dans l'en-tête X-Papo-Public-Key (facultatif). |
| 3. Préparer le payload | Construire un objet JSON avec les champs du contact (nom, e-mail, téléphone, etc.). | Les champs obligatoires et le format exact figurent dans la documentation de l'API. |
| 4. Envoyer les requêtes | Faire un POST vers l'endpoint de création ou un PUT/PATCH pour la mise à jour. | Chaque requête traite un contact ; pour de nombreux enregistrements, automatisez l'envoi en boucle. |
| 5. Vérifier les réponses | L'API renvoie success: true et les données du contact créé/mis à jour. |
En cas d'erreur, le corps contient le code et le message pour correction. |
Comment fonctionnent l'authentification et les endpoints
Tout appel qui modifie des données (création, mise à jour) exige la clé secrète du compte. Elle doit être envoyée comme token Bearer dans l'en-tête Authorization ou, alternativement, 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 usage est facultatif, mais si elle est envoyée, elle doit correspondre au même compte que la clé secrète.
L'URL de base de l'API est https://app.papo.global/api/v1. À partir de là, les endpoints de contacts acceptent les verbes HTTP appropriés pour créer un nouvel enregistrement ou modifier un existant. Comme la documentation complète détaille les paths, paramètres et champs acceptés, nous recommandons de consulter la référence officielle de l'API avant de coder.
Exemple d'authentification (requête de test)
Pour valider que vos clés fonctionnent, vous pouvez appeler l'endpoint GET /api/v1/me, qui renvoie les données du compte. Le modèle d'authentification est le même que celui utilisé dans tous les autres endpoints :
curl https://app.papo.global/api/v1/me \
-H "Authorization: Bearer sk_live_…" \
-H "X-Papo-Public-Key: pk_live_…"
La réponse réussie inclut success: true et l'objet data avec les informations du compte. À partir de là, il suffit de remplacer l'endpoint et la méthode HTTP selon l'opération souhaitée avec les contacts.
Créer et mettre à jour des contacts en masse
Bien que l'API traite un contact par requête, l'opération en masse est obtenue en exécutant plusieurs appels en séquence. Un script en Python, Node.js ou une automatisation dans n8n peut :
- Lire une liste de contacts depuis un fichier CSV, une base de données ou un ERP.
- Pour chaque enregistrement, construire le payload JSON avec les champs nécessaires.
- Envoyer la requête vers l'endpoint de création (si le contact n'existe pas) ou de mise à jour (en utilisant l'identifiant du contact).
- Collecter les réponses et traiter les éventuelles erreurs (e-mail en double, champ invalide, etc.).
Comme l'API est REST et utilise JSON, toute langue prenant en charge HTTP fonctionne. Papo fournit également des exemples en JavaScript et Python sur la page de documentation, qui peuvent être adaptés pour les endpoints de contact.
Déclencheurs automatiques après la création
Chaque fois qu'un nouveau contact est créé via l'API, les mêmes événements internes du CRM sont déclenchés. Si vous avez un Flow configuré avec le déclencheur « Contact créé », l'automatisation s'exécutera automatiquement — par exemple, en envoyant un message de bienvenue par WhatsApp ou en notifiant l'équipe commerciale. Cela signifie que l'intégration via l'API ne se contente pas de peupler la base, mais active aussi les flux de communication déjà existants dans le compte.
Pour qui cette intégration est indiquée
- Entreprises qui migrent depuis un autre CRM ou un tableur et doivent importer des milliers de contacts en une seule fois, en gardant la base Papo synchronisée.
- Opérations qui capturent des leads dans des systèmes externes (landing pages, ERP, e-commerce) et souhaitent qu'ils entrent automatiquement dans le CRM de Papo, prêts à recevoir un accompagnement ou des campagnes.
- Équipes IT qui construisent des intégrations personnalisées entre Papo et des outils internes, en utilisant l'API comme pont pour maintenir les données clients toujours à jour.
- Revendeurs white label qui gèrent plusieurs comptes et veulent automatiser la création de contacts à grande échelle pour leurs clients.
Questions fréquentes
Ai-je besoin d'une clé secrète pour créer ou mettre à jour des contacts ?
Oui. Toutes les opérations d'écriture (création, mise à jour) exigent une authentification avec la clé secrète du compte. La clé publique seule n'autorise pas les modifications.
Puis-je envoyer des milliers de contacts en une seule fois ?
L'API traite un contact par requête. Pour de gros volumes, vous devez automatiser l'envoi séquentiel, en respectant les limites de débit décrites dans la documentation officielle.
Les contacts créés via l'API déclenchent-ils le Flow « Contact créé » ?
Oui. L'événement de création est le même, quelle que soit l'origine. Si un Flow actif avec ce déclencheur existe, il s'exécutera pour chaque contact inséré via l'API.
Comment savoir si un contact existe déjà pour éviter les doublons ?
Vous pouvez utiliser les endpoints de recherche (en filtrant par e-mail ou téléphone) avant de créer. La documentation de l'API détaille les paramètres de requête disponibles.
L'API permet-elle de mettre à jour seulement certains champs du contact ?
Oui. Dans le corps de la requête de mise à jour, envoyez uniquement les champs que vous souhaitez modifier. Les autres restent inchangés.
Où trouver la liste complète des endpoints et paramètres ?
La référence complète est disponible sur la page de documentation de l'API. Vous y trouverez les paths, méthodes, payloads et exemples à jour.
Lire aussi
- Comment déclencher automatiquement un Flow lorsqu'un nouveau contact est créé dans le CRM
- Comment exporter les contacts extraits dans l'Extrator vers CSV et les importer dans le CRM de Papo
Commencez gratuitement et intégrez votre CRM à Papo via l'API →
Avec le premier utilisateur gratuit, vous pouvez déjà générer vos clés d'API et tester la création de contacts en masse sans coût initial.