Avec l'API REST de Papo, vous pouvez lister les boîtes de réception existantes et créer de nouvelles connexions pour des canaux comme WhatsApp et Instagram — le tout via des requêtes authentifiées, sans ouvrir le tableau de bord. C'est la manière programmatique de provisionner des canaux d'assistance, d'intégrer des systèmes externes et de maintenir l'opération multicanal alignée sur l'automatisation.
L'API de Papo expose des ressources de boîtes de réception qui permettent de consulter la configuration actuelle et d'ajouter de nouveaux canaux. Ainsi, les équipes IT, les intégrateurs et les revendeurs white label peuvent gérer les connexions en lot, répliquer des configurations entre comptes et automatiser l'activation de canaux sans dépendre de l'interface.
Aperçu des opérations de boîte de réception via l'API
| Opération | Ce qu'elle fait | Quand l'utiliser |
|---|---|---|
| Lister les boîtes | Renvoie les boîtes de réception du compte, avec le canal associé (WhatsApp, Instagram, e-mail, etc.) et les détails de la configuration. | Auditer les canaux actifs, synchroniser avec des systèmes de supervision ou préparer des migrations. |
| Créer une boîte | Crée une nouvelle boîte de réception en définissant le canal, le nom et les agents qui y auront accès. | Provisionner automatiquement des canaux lors de l'intégration de nouveaux clients, unités ou marques. |
Comment fonctionne l'authentification de l'API
Tous les appels à l'API, y compris la liste des boîtes, exigent la clé secrète du compte. Elle doit être envoyée comme jeton Bearer dans l'en-tête Authorization. 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 dans un endroit sûr et révoquez-la en cas de suspicion de fuite.
Pour valider l'authentification, vous pouvez appeler le point de terminaison GET /api/v1/me, qui renvoie les données du compte. Le schéma d'authentification est le même que pour tous les autres points de terminaison :
curl https://app.papo.global/api/v1/me \
-H "Authorization: Bearer sk_live_…" \
-H "X-Papo-Public-Key: pk_live_…"
Comment gérer les boîtes de réception 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
X-Papo-Public-Key. - Pour lister les boîtes de réception, appelez le point de terminaison de liste des boîtes. La réponse contient l'identifiant de chaque boîte, le canal configuré et d'autres propriétés, ce qui permet de cartographier ce qui existe déjà avant de créer de nouvelles boîtes.
- Pour créer une nouvelle boîte, envoyez une charge utile JSON avec les informations du canal souhaité — par exemple, WhatsApp (API officielle de Meta), Instagram, e-mail ou Telegram. Incluez le nom de la boîte et les identifiants des agents qui doivent y avoir accès. Consultez la documentation officielle pour le format exact des champs et les valeurs acceptées.
- Après la création, la boîte est immédiatement disponible dans le tableau de bord et commence à recevoir des messages dès que la connexion du canal est établie (pour les canaux nécessitant un appairage, comme WhatsApp, l'API renvoie les instructions nécessaires).
Comme l'API est REST et utilise JSON, tout langage prenant en charge HTTP peut être utilisé pour intégrer la gestion des boîtes à des scripts, des outils d'automatisation (comme n8n) ou des systèmes de provisionnement. 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
- Équipes IT qui provisionnent des canaux en lot pour de nouvelles unités, franchises ou marques, sans avoir à accéder au tableau de bord une par une.
- Revendeurs white label qui souhaitent automatiser la création de boîtes pour chaque nouveau client, en conservant une configuration standardisée.
- Opérations qui migrent ou répliquent des configurations entre comptes, en utilisant la liste pour auditer et la création pour reproduire les canaux.
- Intégrateurs qui connectent Papo à des systèmes externes de gestion de canaux, en garantissant que l'environnement de support reflète automatiquement les changements.
Questions fréquentes
Ai-je besoin de la clé secrète pour lister les boîtes de réception ?
Oui. La liste des boîtes exige une authentification avec la clé secrète du compte, car elle renvoie des informations sensibles de la configuration. Le schéma est le même que pour les autres appels à l'API : envoyez le jeton Bearer dans l'en-tête Authorization.
Puis-je créer une boîte de réception pour WhatsApp via l'API ?
Oui. Lors de la création d'une boîte, vous indiquez le type de canal souhaité — notamment WhatsApp (API officielle de Meta) et d'autres canaux pris en charge. La charge utile doit respecter le format attendu pour le canal choisi, conformément à la documentation officielle.
Est-il possible de mettre à jour une boîte de réception existante via l'API ?
L'API actuelle permet de lister et de créer des boîtes de réception. Pour modifier les configurations d'une boîte existante (comme changer les agents ou la renommer), vous pouvez utiliser le tableau de bord Papo ou, si nécessaire, recréer la boîte avec les nouveaux paramètres.
Comment associer des agents à une boîte lors de la création ?
Dans la charge utile de création, vous pouvez indiquer les identifiants des agents qui doivent avoir accès à la boîte. Ces ID peuvent être obtenus via l'API des équipes et des membres. Consultez la documentation pour le format exact.
L'authentification est-elle la même que celle utilisée sur les autres points de terminaison de Papo ?
Oui. Tous les appels qui accèdent aux ressources du compte utilisent la clé secrète 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 de la charge utile ?
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 boîtes de réception et les autres ressources.
À lire aussi
- Comment utiliser l'API de Papo pour gérer les équipes et les membres
- Comment utiliser l'API de Papo pour créer et gérer des étiquettes (tags)
Commencez à automatiser vos connexions dès maintenant →
Créez votre compte gratuit et intégrez des canaux via l'API sans ouvrir le tableau de bord.