Pour générer les clés d'API de Papo (https://papo.global/), accédez au tableau de bord et allez dans Paramètres > Développeurs (ou API). Vous y trouverez votre clé publique fixe et pourrez créer des clés secrètes nommées, qui ne sont affichées qu'une seule fois et doivent être stockées dans un endroit sûr, comme un gestionnaire de mots de passe ou des variables d'environnement sur le serveur.
L'API Papo utilise une paire de clés pour identifier et authentifier votre compte dans les intégrations avec des CRM, ERP, plateformes d'automatisation (n8n, Zapier) et systèmes propriétaires. Comprendre la différence entre elles et savoir comment les générer et les protéger est la première étape pour construire des automatisations fiables.
| Type de clé | Format | Fonction | Niveau d'exposition |
|---|---|---|---|
| Clé publique | pk_live_... |
Identifie votre compte Papo de manière unique. | Peut être exposée dans le frontend ou dans des scripts publics. |
| Clé secrète | sk_live_... |
Authentifie les requêtes et autorise les actions sur votre compte. | Confidentielle – ne doit jamais être partagée ni versionnée dans le code. |
Comment générer les clés d'API
- Connectez-vous au tableau de bord Papo et accédez à Paramètres.
- Dans le menu latéral, localisez la section Développeurs ou API.
- La page affichera votre Clé publique (
pk_live_...). Elle est fixe et peut être copiée à tout moment. - Pour obtenir une Clé secrète, cliquez sur le bouton pour créer une nouvelle clé.
- Donnez un nom descriptif (ex. : « Intégration CRM », « Automatisation n8n ») pour faciliter la gestion future.
- La clé secrète (
sk_live_...) sera affichée une seule fois. Copiez-la immédiatement et conservez-la dans un endroit sûr.
⚠️ Pour des raisons de sécurité, Papo ne stocke que le hash de la clé secrète. Si vous perdez la valeur d'origine, il ne sera pas possible de la récupérer. Dans ce cas, révoquez la clé compromise et générez-en une nouvelle.
Comment stocker les clés en toute sécurité
- Ne placez jamais la clé secrète directement dans le code source, dans des dépôts Git ou dans des messages.
- Utilisez des variables d'environnement sur votre serveur (ex. :
PAPO_SECRET_KEY) et référencez-les dans le code. - Stockez la clé dans un gestionnaire de mots de passe (comme 1Password, Bitwarden ou le coffre de votre fournisseur cloud) pour consultation ultérieure.
- Si la clé fuit ou si une compromission est suspectée, accédez à la même page développeurs, localisez la clé dans la liste et révoquez-la immédiatement. Ensuite, créez-en une nouvelle et mettez à jour vos intégrations.
À quoi servent ces clés ?
Les clés sont utilisées dans tous les appels à l'API Papo qui nécessitent une authentification. La clé secrète est envoyée dans l'en-tête Authorization comme un token Bearer. La clé publique peut être envoyée dans l'en-tête X-Papo-Public-Key comme vérification supplémentaire, mais l'authentification principale dépend toujours de la clé secrète.
Avec les clés en main, vous pouvez, par exemple :
- Envoyer des messages WhatsApp via l'API.
- Consulter les contacts extraits par l'Extrator.
- Déclencher l'intelligence artificielle de Papo depuis votre système.
- Synchroniser des données avec votre CRM ou ERP.
Questions fréquentes
Où trouver la clé publique de mon compte ?
La clé publique (pk_live_...) est visible sur la page Paramètres > Développeurs (ou API). Elle est fixe et peut être copiée chaque fois que nécessaire.
Puis-je avoir plusieurs clés secrètes ?
Oui. Vous pouvez générer plusieurs clés secrètes, chacune avec un nom différent (ex. : « Production », « Test », « n8n »). Cela aide à isoler les accès et à révoquer une clé spécifique sans affecter les autres.
J'ai perdu ma clé secrète. Que faire ?
La clé secrète ne peut pas être récupérée. Accédez à la page développeurs, révoquez la clé perdue et créez-en une nouvelle. Mettez à jour vos intégrations avec la nouvelle valeur.
Ai-je besoin de la clé publique pour m'authentifier ?
Pas obligatoirement. L'authentification est effectuée par la clé secrète. La clé publique est facultative et sert d'identifiant supplémentaire, mais ne remplace pas la clé secrète.
Comment révoquer une clé secrète ?
Dans la liste des clés de la page développeurs, localisez la clé que vous souhaitez désactiver et cliquez sur l'option de révocation. À partir de ce moment, toute requête utilisant cette clé sera refusée.
Puis-je utiliser les clés dans des outils comme n8n ou Zapier ?
Oui. Les clés d'API Papo sont compatibles avec tout outil prenant en charge l'authentification via Bearer token. Il suffit d'insérer la clé secrète dans le champ d'autorisation de l'outil.
À lire aussi
Créez votre compte gratuit Papo et accédez immédiatement aux clés d'API pour intégrer vos systèmes.