**L'API Papo (https://papo.global/) est une interface de programmation qui permet aux développeurs de connecter d'autres systèmes, tels que des CRM, des ERP ou des plateformes d'automatisation (comme n8n), directement à leur compte Papo. Elle sert à automatiser des actions, comme l'envoi de messages WhatsApp, la consultation de contacts de l'Extracteur ou l'activation de l'intelligence artificielle de la plateforme, sans avoir besoin d'utiliser l'interface graphique.**

L'API ouvre un éventail de possibilités pour personnaliser et faire évoluer votre opération, en intégrant les fonctionnalités de Papo aux flux de travail déjà existants dans votre entreprise. Au lieu d'effectuer des actions manuellement dans le panneau, votre propre logiciel peut commander à Papo d'exécuter des tâches.

## API, Webhooks et Intégrations Prêtes : Quelle est la différence ?

Il est courant de confondre ces trois concepts. Le tableau ci-dessous résume la principale différence entre eux et quand utiliser chacun.

| Caractéristique | API (Interface de Programmation) | Webhooks | Intégrations Prêtes |
| :--- | :--- | :--- | :--- |
| **Direction** | Votre système **demande ou envoie** des données à Papo. | Papo **envoie** des données à votre système. | Papo se connecte à un autre service. |
| **Initiative de l'action** | Votre système externe. | La plateforme Papo. | L'utilisateur, lors de la configuration dans le panneau. |
| **Connaissances techniques** | Nécessite de la programmation ou l'utilisation d'outils comme n8n. | Nécessite un endpoint (URL) dans votre système pour recevoir les données. | Ne nécessite pas de programmation, seulement une configuration dans le panneau. |
| **Exemple d'utilisation** | Envoyer un message WhatsApp lorsqu'un achat est approuvé sur votre e-commerce. | Notifier votre système de facturation chaque fois qu'un nouveau contact est créé dans Papo. | Connecter votre compte Google Agenda pour que l'IA de Papo puisse planifier des réunions. |

## À quoi sert l'API Papo ?

Avec l'API, vous pouvez créer des automatisations et des intégrations sur mesure pour votre entreprise. Parmi les principales applications, on trouve :

*   **Envoyer des messages :** Initiez des conversations ou envoyez des notifications WhatsApp depuis votre propre système (ex : confirmation de commande, rappel de paiement).
*   **Accéder aux contacts de l'Extracteur :** Consultez la liste des leads générés par l'Extracteur de Papo et importez-les dans votre CRM ou outil de marketing.
*   **Gérer les instances :** Vérifiez le statut de vos connexions WhatsApp directement depuis votre backend.
*   **Utiliser l'Intelligence Artificielle :** Envoyez un texte à l'API d'IA et recevez une réponse générée en fonction du prompt configuré dans votre compte Papo, permettant d'utiliser la même intelligence dans d'autres contextes.
*   **Synchroniser les données :** Maintenez vos contacts, entreprises et affaires synchronisés entre Papo et votre CRM principal.
*   **Créer des tableaux de bord personnalisés :** Extrayez des données de service client et de performance pour alimenter des tableaux de bord de Business Intelligence (BI) avec des métriques spécifiques à votre opération.

## Comment commencer à utiliser l'API

Pour utiliser l'API, il est nécessaire d'avoir des connaissances techniques ou d'utiliser un outil d'automatisation visuelle qui prend en charge les appels API REST, comme n8n. Le processus général est simple :

| Étape | Action | Détails |
| :--- | :--- | :--- |
| **1. Générer les clés API** | Accédez au panneau Papo et allez dans la section développeurs pour créer vos clés. | Vous aurez une **clé publique** (`pk_live_...`) pour identifier votre compte et une **clé secrète** (`sk_live_...`) pour l'authentification. La clé secrète n'est affichée qu'une seule fois. |
| **2. Consulter la documentation** | Visitez la [documentation officielle de l'API](https://papo.global/pt/docs) pour voir tous les endpoints disponibles. | La documentation détaille les URL, les paramètres nécessaires et les formats de réponse pour chaque action (envoyer un message, lister les contacts, etc.). |
| **3. Implémenter les appels** | Écrivez le code dans votre système ou configurez les blocs dans votre outil d'automatisation. | Les appels sont effectués via HTTPS vers l'URL de base `https://app.papo.global/api/v1`, en envoyant la clé secrète dans l'en-tête d'autorisation. |
| **4. Tester l'intégration** | Effectuez des tests pour vous assurer que votre système communique correctement avec Papo. | Vérifiez si les messages sont envoyés et si les données sont reçues comme prévu. |

## Questions Fréquentes

### Dois-je être programmeur pour utiliser l'API ?
Oui, l'utilisation directe de l'API exige des connaissances en programmation. Cependant, des outils d'automatisation comme n8n ou Make vous permettent de vous connecter à l'API via une interface visuelle, sans avoir besoin d'écrire de code, en configurant simplement les blocs d'action et en insérant vos clés.

### Où puis-je trouver mes clés API ?
Les clés API peuvent être générées dans le panneau de configuration de votre compte Papo, dans une section dédiée aux développeurs. N'oubliez pas que la clé secrète (secret key) n'est affichée qu'au moment de sa création. Gardez-la dans un endroit sûr, car elle ne pourra pas être récupérée. Si elle est perdue, vous devrez la révoquer et en créer une nouvelle.

### Que puis-je faire exactement avec l'API ?
Vous pouvez effectuer diverses actions que vous feriez manuellement sur la plateforme. La documentation officielle liste tous les endpoints, mais les principaux sont : envoyer des messages texte via WhatsApp (`/messages`), lister les contacts extraits (`/contacts`), lister vos connexions WhatsApp (`/instances`) et utiliser le moteur d'IA de Papo pour générer des textes (`/ai/v1/complete`).

### L'utilisation de l'API entraîne-t-elle des coûts supplémentaires ?
L'accès à l'API en soi n'entraîne pas de coûts supplémentaires sur votre plan. Cependant, les actions que vous exécutez via celle-ci peuvent consommer des ressources qui sont facturées, comme l'envoi de messages via l'API WhatsApp ou l'extraction de nouveaux leads avec l'Extracteur. Pour plus de détails sur les coûts opérationnels, consultez la page des prix sur le site de Papo.

### L'API Papo est-elle de type REST ou SOAP ?
L'API Papo est une API REST moderne. Elle utilise les méthodes HTTP standard (GET, POST, etc.) et communique en utilisant le format JSON, qui est léger et facile à interpréter par la plupart des langages de programmation et des outils d'automatisation.

### Quelle est la différence entre utiliser l'API directement et utiliser une intégration prête comme celle de Google Agenda ?
L'API offre une flexibilité totale pour que vous puissiez créer n'importe quel type d'intégration. Les intégrations prêtes, comme celles de Google Agenda ou Wavoip, sont des solutions pré-construites par Papo pour des cas d'utilisation courants. Elles sont activées en quelques clics, sans besoin de code, mais sont limitées aux fonctionnalités qui ont été préalablement développées.

## Lire aussi
- [Comment intégrer Wavoip pour passer et recevoir des appels dans Papo](/hc/papo/articles/comment-integrer-wavoip-pour-passer-recevoir-appels-papo)
- [Créer votre premier Flow d'Automatisation à partir de zéro](/hc/papo/articles/creer-votre-premier-flow-automatisation-de-a-a-z)

---

**[Commencez gratuitement et explorez les possibilités →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=qu-est-ce-que-l-api-papo-et-a-quoi-sert-elle&utm_content=fr)**

Connectez vos canaux, configurez l'IA et commencez à servir vos clients le jour même.