**Oui, vous pouvez gérer les services, les horaires et les rendez-vous via l'API en utilisant le module Rendez-vous de [Papo](https://papo.global/). L'API REST vous permet de lister les services, les professionnels et les patients, de consulter l'agenda et de créer de nouveaux rendez-vous de manière programmatique, en intégrant tout le flux de réservation à votre site, application ou système externe.**

Le module Rendez-vous de Papo a été conçu pour être le centre de contrôle de votre agenda. Il organise quatre piliers : les services que vous proposez (avec nom, durée et prix), les professionnels qui les exécutent, la disponibilité des horaires de chacun et les rendez-vous réalisés. Avec l'API, vous pouvez automatiser ces opérations sans accéder manuellement au tableau de bord, en maintenant une intégration fluide entre Papo et vos autres outils.

## Résumé des opérations de Rendez-vous via l'API

| Opération | Ce qu'elle fait | Quand l'utiliser |
| :--- | :--- | :--- |
| Lister les services | Renvoie les services de rendez-vous enregistrés, avec durée et prix. | Synchroniser le catalogue de services avec votre site ou application pour que le client voie les options en temps réel. |
| Lister les professionnels | Renvoie la liste des intervenants ou membres de l'équipe qui réalisent les services. | Afficher les professionnels disponibles et leurs spécialités dans une interface de réservation externe. |
| Lister les patients | Renvoie les patients enregistrés, avec nom, téléphone et ID. | Vérifier si un client existe déjà dans le CRM avant de créer un nouveau rendez-vous ou de le lier à un enregistrement existant. |
| Lister les rendez-vous | Renvoie les rendez-vous avec filtre par statut (ex. : confirmé, en attente). | Auditer les réservations, intégrer avec des systèmes de reporting ou vérifier l'occupation de l'agenda avant de proposer de nouveaux horaires. |
| Planifier un rendez-vous | Crée un rendez-vous réel dans l'agenda d'un professionnel, pour un service et un patient spécifiques. | Permettre aux clients de réserver directement depuis votre site ou application, ou automatiser la création de réservations à partir de systèmes externes. |

## Comment fonctionne l'authentification de l'API

Toutes les opérations d'écriture dans les Rendez-vous exigent la clé secrète de votre compte Papo, 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 tableau de bord Papo. La clé secrète n'est affichée qu'une seule fois lors de sa création ; conservez-la en lieu sûr et révoquez-la immédiatement en cas de suspicion de fuite.

## Comment l'utiliser en pratique

1.  Accédez à l'espace développeur/API dans le tableau de bord Papo et générez une clé secrète. Copiez également la clé publique du compte.
2.  À chaque requête, authentifiez-vous avec la clé secrète comme token Bearer. Si vous souhaitez renforcer la validation, envoyez la clé publique dans l'en-tête indiqué dans la documentation.
3.  **Pour construire l'interface de réservation**, listez d'abord les services et professionnels disponibles. Ainsi, vous pouvez alimenter dynamiquement les options sur votre site ou application avec les données réelles de votre compte Papo.
4.  **Pour créer un rendez-vous**, appelez l'endpoint de création de rendez-vous, en envoyant dans le payload JSON les identifiants du service, du professionnel, du patient et la date/heure souhaitée. L'API validera la disponibilité dans l'agenda configuré dans le module Rendez-vous et créera le rendez-vous.
5.  Consultez la documentation officielle sur `https://papo.global/pt/docs` pour obtenir les chemins exacts, les paramètres obligatoires et des exemples de code. Toutes les réponses sont au format JSON.

L'API permet également de lister les rendez-vous existants avec un filtre par statut. Cela est utile pour construire des tableaux de suivi, envoyer des rappels automatiques ou intégrer le statut des réservations avec d'autres systèmes.

## À qui s'adresse cette intégration

- **Cliniques, cabinets et salons de beauté** qui souhaitent proposer une réservation en ligne sur leur propre site, avec disponibilité en temps réel.
- **Plateformes SaaS et marketplaces** qui doivent connecter l'agenda des prestataires de services à un système de réservation externe.
- **Revendeurs white label** qui créent des solutions personnalisées pour les clients finaux et souhaitent exposer le module Rendez-vous via l'API.
- **Entreprises avec des flux automatisés** qui déclenchent la création de rendez-vous à partir d'événements dans des CRM, ERP ou outils d'automatisation.

## Questions fréquentes

### Dois-je avoir le module Rendez-vous configuré pour utiliser l'API ?
Oui. Il est nécessaire que les services, les professionnels et leurs disponibilités soient déjà enregistrés dans le module Rendez-vous de Papo pour que l'API puisse les lister et valider les rendez-vous.

### L'API permet-elle de créer un nouveau service ou professionnel ?
Les ressources de l'API se concentrent sur la liste des services et professionnels existants et sur la planification des rendez-vous. Pour créer ou modifier des services et professionnels, utilisez le tableau de bord Papo.

### Comment l'API sait-elle si un créneau est libre ?
Lorsque vous envoyez une requête pour planifier un rendez-vous, l'API de Papo consulte la disponibilité configurée pour le professionnel et le service choisi ce jour et à cette heure. En cas de conflit, le rendez-vous ne sera pas créé et l'API renverra une erreur.

### Puis-je utiliser l'API pour planifier un rendez-vous au nom d'un patient qui n'est pas encore dans le CRM ?
Vous pouvez d'abord utiliser l'API de Contacts de Papo pour créer le patient (avec nom, e-mail et/ou téléphone), puis utiliser l'ID renvoyé pour créer le rendez-vous. Consultez la documentation pour l'endpoint de création de contacts.

### L'IA de Papo peut-elle planifier automatiquement via l'API ?
L'Intelligence Artificielle de Papo, comme Super Chat, planifie directement via la conversation sur WhatsApp, en consultant l'agenda du module Rendez-vous. L'API est la voie pour les intégrations programmatiques externes, comme un système de réservation en ligne.

### Où puis-je voir le format exact du payload pour planifier ?
Dans la documentation officielle de l'API, 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 ressources de Rendez-vous.

## Lire aussi

- [Comment utiliser l'API de Papo pour créer et mettre à jour des contacts en masse](/hc/papo/articles/comment-utiliser-api-papo-creer-mettre-a-jour-contacts-masse)
- [Comment utiliser l'API de Papo pour créer et gérer des étiquettes (tags)](/hc/papo/articles/api-papo-creer-gerer-etiquettes-tags)

---

**[Commencez à intégrer votre agenda via l'API →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=comment-utiliser-api-papo-gerer-rendez-vous&utm_content=fr)**
Inscrivez-vous à Papo et accédez à l'API REST pour automatiser vos rendez-vous dès le premier utilisateur.