Avec l'API REST de Papo, vous pouvez lister les étiquettes existantes, créer de nouvelles étiquettes et appliquer une étiquette à un contact avec une conversation ouverte — le tout via des requêtes authentifiées, sans ouvrir le tableau de bord. C'est la méthode programmatique pour automatiser la catégorisation et l'organisation du service depuis des systèmes externes, des CRM ou des outils d'automatisation.
L'API de Papo expose des ressources de Conversations qui incluent la gestion des étiquettes. Avec elles, votre équipe peut maintenir une taxonomie cohérente, préparer des catégories avant les campagnes et classer contacts et conversations en temps réel, en utilisant la même authentification que les autres endpoints de la plateforme.
Récapitulatif des opérations d'étiquette via l'API
| Opération | Ce qu'elle fait | Quand l'utiliser |
|---|---|---|
| Lister les étiquettes | Renvoie les étiquettes enregistrées dans le compte, avec nom et couleur pour l'identification visuelle. | Auditer la standardisation du compte ou synchroniser les étiquettes avec un autre outil. |
| Créer une étiquette | Crée une étiquette dans le compte sans l'appliquer à un contact. | Préparer de nouvelles catégories avant de les appliquer en masse ou dans des automatisations. |
| Appliquer une étiquette à un contact + conversation | Crée l'étiquette si elle n'existe pas encore et l'applique au contact et à la conversation ouverte. | Automatiser le tri, la qualification ou le classement dès qu'une conversation arrive. |
Comment fonctionne l'authentification de l'API
Toutes les routes d'écriture, y compris les opérations d'étiquettes, exigent la clé secrète du compte. Elle doit être envoyée comme jeton Bearer dans l'en-tête d'autorisation. La clé publique du compte 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. Les clés sont générées dans l'espace développeur du tableau de bord Papo. La clé secrète n'apparaît qu'une seule fois lors de la création ; conservez-la en lieu sûr et révoquez-la en cas de suspicion de fuite.
Comment l'utiliser en pratique
- Accédez à l'espace développeur/API du tableau de bord Papo et générez une clé secrète. Copiez également la clé publique du compte.
- Dans chaque requête, authentifiez-vous avec la clé secrète comme jeton Bearer. Si vous souhaitez renforcer la validation, envoyez la clé publique dans l'en-tête indiqué dans la documentation.
- Pour lister les étiquettes, appelez l'endpoint de listage des étiquettes de l'API. La réponse contient les étiquettes enregistrées, ce qui permet de cartographier ce qui existe déjà avant d'en créer de nouvelles.
- Pour créer une étiquette sans l'appliquer, envoyez un payload JSON avec les informations de l'étiquette à l'endpoint de création. Consultez la documentation officielle pour le format exact.
- Pour appliquer une étiquette à un contact avec une conversation ouverte, appelez l'endpoint d'étiquetage. Si l'étiquette n'existe pas encore, elle sera créée automatiquement et appliquée au contact et à la conversation ouverte.
Comme l'API est REST et utilise JSON, tout langage prenant en charge HTTP peut être utilisé pour intégrer des étiquettes à des scripts, des ERP, des CRM ou des outils d'automatisation. La documentation officielle sur https://papo.global/pt/docs fournit les détails d'authentification, les paramètres, les réponses et des exemples de code.
Pour qui cette intégration a du sens
- Les équipes qui utilisent des automatisations externes pour classer les conversations sans ouvrir l'interface de Papo.
- Les opérations qui doivent créer des étiquettes en lot avant des campagnes ou lors de la mise en place d'une nouvelle taxonomie de service.
- Les intégrateurs et revendeurs white label qui connectent Papo aux systèmes de leurs clients et veulent maintenir une catégorisation cohérente entre les comptes.
- Les entreprises qui utilisent déjà l'API de Papo pour les contacts et les messages et souhaitent compléter le flux avec des étiquettes.
Questions fréquentes
Dois-je créer l'étiquette avant de l'appliquer via l'API ?
Non. L'API dispose d'une ressource qui crée l'étiquette dans le compte si elle n'existe pas encore, puis l'applique au contact et à la conversation ouverte. Il existe aussi l'option de simplement créer l'étiquette, sans l'appliquer à aucun contact.
L'étiquette appliquée via l'API vaut-elle pour le contact et pour la conversation ?
Oui. La ressource d'étiquetage applique l'étiquette au contact et à la conversation ouverte, ce qui aide à classer à la fois l'historique du lead et le service en cours.
L'authentification est-elle la même que celle utilisée sur d'autres endpoints de Papo ?
Oui. Les routes d'écriture exigent la clé secrète du compte, envoyée comme jeton Bearer. La clé publique est facultative et, si elle est envoyée, doit correspondre au même compte.
Où trouver les chemins exacts et le format du payload ?
Dans la documentation officielle de l'API, disponible sur https://papo.global/pt/docs. Vous y trouverez les détails d'authentification, les paramètres, les réponses et des exemples de code pour les étiquettes et les autres ressources.
Puis-je utiliser l'API pour classer d'anciennes conversations en masse ?
La ressource d'application décrite sur la plateforme agit sur le contact et la conversation ouverte. Pour des cas spécifiques de migration ou de classement rétroactif, le mieux est de consulter la documentation officielle et de combiner le listage des conversations avec des appels en séquence, lorsque le flux le permet.
Lire aussi
- Comment utiliser l'API de Papo pour créer et mettre à jour des contacts en masse
- Comment utiliser l'API de Papo pour envoyer des modèles de message WhatsApp (HSM)
Créez votre compte gratuit et centralisez WhatsApp, Instagram, e-mail et SMS dans une seule boîte de réception, avec des étiquettes pour organiser le service.