Comment utiliser l'API de Papo pour créer et mettre à jour des affaires dans le Kanban

Ouvrir dans

Voir en Markdown

Ouvrir dans ChatGPT Ouvrir dans Claude

Vitor

Dernière mise à jour le Oct 19, 2026

Pour créer et mettre à jour des affaires dans le Kanban par programmation, utilisez l'API REST de Papo. Avec l'authentification par clé secrète (jeton Bearer) et la clé publique du compte, vous pouvez envoyer des requêtes qui créent des cartes, déplacent les opportunités entre les étapes et marquent les résultats, en intégrant le tunnel de vente à des systèmes externes sans intervention manuelle.

L'API de Papo expose des opérations d'écriture pour le Kanban, permettant de travailler avec des tunnels, des étapes et des cartes du CRM. Cela permet de synchroniser un ERP, une landing page ou un outil de paiement avec le tunnel de vente, en gardant les opportunités toujours à jour.

Résumé de l'intégration avec le Kanban

É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 tableau de bord 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. Connaître les tunnels et les étapes	Lister les tunnels du Kanban et leurs étapes pour obtenir les identifiants nécessaires.	La réponse de l'API fournit les identifiants utilisés dans les appels suivants.
4. Créer ou déplacer des cartes	Envoyer l'opération pour créer une carte dans une étape, déplacer une carte d'un contact vers une autre étape ou marquer un résultat.	Chaque opération traite une action ; pour de nombreux enregistrements, automatisez l'envoi en boucle.
5. Valider la réponse	L'API renvoie `success: true` et les données de la carte ou de la liste.	En cas d'erreur, le corps de la réponse contient le code et le message pour corriger.

Ce que l'API permet de faire dans le Kanban

Avec les endpoints du Kanban, vous pouvez par programmation :

Lister les tunnels disponibles et leurs étapes, avec nom et position.
Lister les cartes du CRM.
Lister toutes les cartes gagnées, pour les rapports de ventes conclues.
Créer une carte dans une étape, éventuellement liée à un contact existant.
Déplacer la carte d'un contact vers une autre étape du tunnel.
Marquer des cartes comme gagnées ou comme perdues.
Créer un tunnel Kanban avec des étapes standard ou personnalisées.

Ces opérations permettent au tunnel de refléter automatiquement ce qui se passe en dehors de Papo, comme un achat confirmé, une réunion planifiée ou une inscription provenant du site.

Comment fonctionnent l'authentification et les appels

Chaque appel qui modifie des données exige la clé secrète du compte. Elle doit être envoyée comme jeton Bearer dans l'en-tête Authorization ou, alternativement, dans l'en-tête X-Papo-Secret-Key. La clé publique peut accompagner la requête dans l'en-tête X-Papo-Public-Key ; son utilisation est facultative, 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 du Kanban acceptent les verbes HTTP adaptés pour créer, déplacer, mettre à jour et lister. 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.

Pour valider que vos clés fonctionnent, vous pouvez appeler l'endpoint GET /api/v1/me, qui renvoie les données du compte. Le schéma d'authentification est le même que celui utilisé dans 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.

Flux type d'intégration avec des systèmes externes

Un script en Python, Node.js ou une automatisation dans des outils comme n8n peut exécuter le cycle complet du tunnel :

Lister les tunnels et étapes pour obtenir les identifiants de chaque colonne.
Créer une carte à l'étape initiale, en la liant à un contact si nécessaire.
Déplacer la carte vers une nouvelle étape lorsqu'un événement externe se produit — par exemple, paiement confirmé ou réunion planifiée.
Marquer la carte comme gagnée ou perdue lorsque l'opportunité est terminée.
Lister les cartes gagnées pour alimenter des rapports, des tableaux de bord ou des systèmes de BI.

Comme l'API est REST et utilise JSON, toute langue prenant en charge HTTP fonctionne. Les détails de payload et les champs de chaque opération se trouvent dans la documentation officielle.

À qui cette intégration est destinée

Entreprises qui captent des opportunités dans des systèmes externes, comme des landing pages, des ERP ou un e-commerce, et souhaitent qu'elles entrent automatiquement dans le tunnel de Papo.
Opérations qui doivent déplacer des cartes selon des événements de paiement, comme des passerelles de paiement ou des plateformes de facturation, sans ouvrir le CRM manuellement.
Équipes BI et data qui veulent extraire les cartes gagnées et les valeurs pour des tableaux de bord en temps réel.
Équipes IT qui construisent des intégrations personnalisées entre Papo et des outils internes, en utilisant l'API comme pont entre le tunnel de vente et le reste de l'opération.

Questions fréquentes

Faut-il utiliser la clé publique dans tous les appels ?

Non. La clé publique est facultative, mais, si elle est envoyée dans l'en-tête X-Papo-Public-Key, elle doit correspondre au même compte que la clé secrète.

Comment savoir quelles étapes existent dans mon tunnel ?

Listez les tunnels du Kanban via l'API. La réponse renvoie les étapes de chaque tunnel avec leurs identifiants, utilisés pour créer ou déplacer des cartes.

Puis-je créer une carte déjà liée à un contact ?

Oui. La création de carte permet de lier éventuellement à un contact existant, en conservant l'historique et les données du client associés à l'opportunité.

L'API permet-elle de mettre à jour la valeur d'une carte ?

L'API expose des opérations d'écriture pour les cartes du Kanban. Les champs exacts pouvant être mis à jour, y compris les valeurs, sont détaillés dans la documentation officielle de l'API.

Est-il possible de marquer une carte comme gagnée ou perdue via l'API ?

Oui. L'API permet de marquer des cartes comme gagnées et comme perdues, ainsi que de lister toutes les cartes gagnées pour les rapports et tableaux de bord.

Faut-il programmer ou peut-on utiliser des outils d'automatisation ?

Vous pouvez utiliser n'importe quelle langue prenant en charge HTTP ou des outils d'automatisation comme n8n, en exécutant les appels en séquence selon le flux souhaité.