Pour commencer à utiliser l'API de Papo Global (https://papo.global/), vous devez générer une clé secrète dans le tableau de bord, authentifier les requêtes avec l'en-tête Authorization et effectuer des appels REST vers la base https://app.papo.global/api/v1. Le premier test pratique consiste à lister les contacts de l'Extrator avec une simple commande cURL.
L'API de Papo est de type REST, utilise JSON et accepte les requêtes de toute origine (CORS activé). Avec elle, vous connectez des CRM, des plateformes d'automatisation (comme n8n), des ERP ou votre propre backend à l'écosystème de service client, de vente et d'IA de Papo.
Résumé des éléments essentiels
| Élément | Description |
|---|---|
Clé publique (pk_live_…) |
Identifiant fixe de votre compte, peut être exposée dans le front-end |
Clé secrète (sk_live_…) |
Jeton d'authentification, doit être gardé secret et utilisé uniquement sur le serveur |
| Authentification | En-tête Authorization: Bearer sk_live_... (ou X-Papo-Secret-Key) dans tous les appels sauf GET /api/v1 |
| URL de base | https://app.papo.global/api/v1 |
| Endpoint d'exemple | GET /api/v1/contacts — liste les contacts extraits (Extrator), avec pagination |
Étape par étape pour le premier appel
1. Créez vos clés d'API
Accédez à la page des développeurs dans le tableau de bord de Papo (disponible sur app.papo.global/developers). Là, vous pouvez générer une clé secrète nommée — par exemple, « premier-test » — et la copier immédiatement. La clé n'est affichée qu'une seule fois ; ensuite, vous ne pourrez que la révoquer et en créer une autre.
La clé publique (pk_live_…) est fixe par compte et reste visible sur cette même page à tout moment. Bien qu'optionnelle dans les requêtes, si vous l'envoyez, elle doit être associée au même compte que la clé secrète.
2. Choisissez l'endpoint
Pour ce guide, nous utiliserons GET /api/v1/contacts, qui liste les leads extraits par le module Extrator. Vous pouvez paginer les résultats avec les paramètres page (par défaut 1) et per_page (1 à 100, par défaut 20). Une requête textuelle avec q est également acceptée pour rechercher par entreprise, téléphone ou e-mail.
3. Effectuez l'appel avec cURL
Avec la clé secrète en main, construisez la requête. L'exemple suivant liste jusqu'à 20 contacts :
curl "https://app.papo.global/api/v1/contacts?page=1&per_page=20" \
-H "Authorization: Bearer sk_live_…"
Remplacez sk_live_… par votre clé secrète. Si vous souhaitez utiliser l'en-tête alternatif, faites :
curl "https://app.papo.global/api/v1/contacts" \
-H "X-Papo-Secret-Key: sk_live_…"
La réponse est un JSON avec success: true et les données dans l'objet data. En cas d'erreur, le JSON contiendra success: false et un objet error avec un code et un message explicatifs.
À partir de là, vous pouvez explorer d'autres endpoints documentés sur la page de l'API, comme l'envoi de messages (POST /api/v1/messages), les détails du compte (GET /api/v1/me) ou la complétion de textes avec l'IA (POST /api/ai/v1/complete).
À qui s'adresse ce guide
Ce contenu s'adresse aux développeurs qui souhaitent intégrer Papo avec des systèmes externes — CRM, outils d'automatisation (n8n, par exemple) ou applications propres. Si vous êtes un utilisateur final qui souhaite simplement connecter des canaux et assurer le service client, le Centre d'aide propose d'autres articles plus adaptés.
Questions fréquentes
Dois-je envoyer la clé publique à chaque appel ?
Non. La clé publique est optionnelle. Si vous choisissez de l'envoyer, elle doit correspondre au compte de la clé secrète utilisée.
La clé secrète expire-t-elle ?
Non, elle n'expire pas automatiquement. Vous pouvez la révoquer à tout moment depuis le tableau de bord et en créer une nouvelle si vous soupçonnez une fuite.
Puis-je tester l'API avec un compte gratuit ?
Oui. Le premier utilisateur de Papo est gratuit et vous pouvez générer des clés pour explorer l'API. Les accès à des modules comme Extrator peuvent consommer du solde selon l'usage, mais la création des clés et les appels de lecture de base sont testables sans coût supplémentaire.
Que faire si je perds la clé secrète ?
Créez une nouvelle clé nommée dans le tableau de bord des développeurs. L'ancienne clé ne pourra pas être récupérée ; elle ne pourra qu'être révoquée pour des raisons de sécurité.
Puis-je utiliser l'API pour envoyer des messages en masse ?
Oui, l'endpoint POST /api/v1/messages permet d'envoyer des messages texte. Cependant, respectez les politiques de consentement et les conditions d'utilisation de la plateforme.
L'API liste-t-elle uniquement les contacts de l'Extrator ?
L'endpoint GET /api/v1/contacts retourne les contacts extraits. Pour gérer la base unifiée du CRM (rechercher, créer et mettre à jour n'importe quel contact), vous pouvez consulter la documentation complète de l'API.
À lire aussi : Comment utiliser l'API de Papo pour créer un formulaire d'inscription et alimenter automatiquement le CRM · Comment utiliser l'API de Papo pour surveiller la consommation de crédits et les factures de la revente en marque blanche
Commencez gratuitement sur Papo Global →
Premier utilisateur 0 R$, sans carte bancaire. En savoir plus sur papo.global.