Avec l'API REST de Papo, vous pouvez automatiser l'administration des équipes sans ouvrir le panneau : lister les équipes, créer des équipes, lister les membres d'une équipe, ajouter des utilisateurs à une équipe et lister ou créer des boîtes de réception. C'est la façon programmatique de garder la structure de service synchronisée avec des systèmes externes, de grandes opérations et des reventes white label.
L'API de Papo expose des ressources d'équipes et de boîtes avec la même authentification que les autres endpoints de la plateforme. Avec elles, votre équipe peut provisionner de nouvelles structures, auditer qui fait partie de chaque groupe et préparer le routage des conversations sans intervention manuelle dans le panneau.
Récapitulatif des opérations sur les équipes et les membres via l'API
| Opération | Ce qu'elle fait | Quand l'utiliser |
|---|---|---|
| Lister les équipes | Renvoie les équipes enregistrées dans le compte. | Auditer la structure avant de créer une nouvelle équipe. |
| Créer une équipe | Crée une équipe avec un nom et une description facultative. | Provisionner une nouvelle équipe via un script, un ERP ou un CRM. |
| Lister les membres d'une équipe | Renvoie les utilisateurs qui font partie de cette équipe. | Vérifier qui est inclus et éviter les accès incorrects. |
| Ajouter des utilisateurs à l'équipe | Inclut un ou plusieurs utilisateurs en indiquant les ID séparés par des virgules. | Synchroniser l'équipe avec l'effectif actuel d'agents. |
| Lister les boîtes | Renvoie les boîtes avec le canal, dans la vue administrateur. | Vérifier les canaux disponibles et leur organisation. |
| Créer une boîte de réception | Crée une nouvelle boîte de réception. | Provisionner de nouveaux canaux avec la structure d'équipes. |
Comment fonctionne l'authentification de l'API
Les opérations d'écriture, y compris celles sur les équipes et les membres, exigent la clé secrète du compte. Elle doit être envoyée comme token 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 panneau Papo. La clé secrète n'apparaît qu'une seule fois lors de la création ; conservez-la dans un endroit sûr et révoquez-la en cas de suspicion de fuite.
Étapes pour gérer les équipes et les membres via l'API
- Accédez à l'espace développeur/API du panneau Papo et générez une clé secrète. Copiez également la clé publique du compte si vous souhaitez une validation supplémentaire.
- À chaque requête, authentifiez-vous avec la clé secrète comme token Bearer. Si vous renforcez la validation, envoyez la clé publique dans l'en-tête indiqué dans la documentation.
- Listez les équipes existantes pour cartographier la structure actuelle avant d'en créer de nouvelles.
- Créez une équipe en envoyant un payload JSON avec un nom et, si nécessaire, une description. Consultez la documentation officielle pour le format exact.
- Listez les membres de l'équipe pour auditer qui est déjà inclus et éviter les doublons.
- Ajoutez des utilisateurs à l'équipe en indiquant les ID séparés par des virgules. Cette étape synchronise l'équipe avec l'effectif actuel d'agents.
- Listez les boîtes de réception avec la vue administrateur pour vérifier les canaux existants et utiliser aussi l'API pour créer des boîtes lorsque c'est nécessaire.
Comme l'API est REST et utilise JSON, tout langage prenant en charge HTTP peut être utilisé pour intégrer les équipes et les membres à 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
- Grandes opérations qui doivent créer et ajuster des équipes fréquemment sans ouvrir manuellement le panneau.
- Équipes IT et automatisation qui synchronisent la structure d'agents avec des annuaires, les RH ou des systèmes internes.
- Revendeurs white label qui provisionnent des comptes clients de manière standardisée, en réutilisant la même logique d'équipes et de boîtes.
- Entreprises qui utilisent déjà l'API de Papo pour les contacts et les conversations et souhaitent compléter le flux avec l'administration des équipes.
L'API gère la structure des équipes et l'inclusion des membres. Les rôles utilisateur, comme Agent ou Administrateur, et les permissions granulaires continuent d'être définis dans le panneau. En ajoutant un utilisateur à une équipe et en le connectant aux boîtes de réception pertinentes, vous contrôlez l'accès opérationnel aux conversations.
Questions fréquentes
L'API de Papo définit-elle le rôle de l'utilisateur, comme Agent ou Administrateur ?
Non. L'API des équipes et des membres se concentre sur la création d'équipes, la liste des membres et l'inclusion d'utilisateurs. La définition du rôle et des permissions de chaque utilisateur se fait dans le panneau. En incluant un utilisateur dans une équipe et dans les bonnes boîtes, vous restreignez l'accès aux conversations opérationnelles.
Puis-je créer une équipe sans ajouter de membres dans la même étape ?
Oui. L'API permet de créer une équipe avec un nom et une description facultative, sans inclure immédiatement des utilisateurs. Ensuite, vous pouvez ajouter des membres à l'aide de l'opération d'inclusion en lot.
Comment l'API identifie-t-elle le compte dans les requêtes ?
Par la clé secrète envoyée comme token Bearer. La clé publique est facultative et, si elle est envoyée, elle doit correspondre au même compte que la clé secrète.
Cette API fonctionne-t-elle pour la revente white label ?
Oui. Les revendeurs peuvent utiliser l'API pour provisionner des équipes et des membres dans les comptes clients de manière standardisée, en réduisant la configuration manuelle et en maintenant la cohérence entre les opérations.
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 équipes, les membres et les autres ressources.
À lire aussi
- Comment utiliser l'API Papo pour créer et gérer des étiquettes (tags)
- Comment gérer les utilisateurs et les permissions dans votre plateforme white label
Commencez gratuitement et automatisez les équipes et les membres via l'API →
Le premier utilisateur est gratuit pour toujours, vous pouvez donc valider l'intégration avant de structurer votre opération.