Oui, vous pouvez gérer les services, les horaires et les rendez-vous via l'API en utilisant le module Rendez-vous de Papo. 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
- 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.
- À 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.
- 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.
- 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.
- Consultez la documentation officielle sur
https://papo.global/pt/docspour 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
- Comment utiliser l'API de Papo pour créer et gérer des étiquettes (tags)
Commencez à intégrer votre agenda via l'API → Inscrivez-vous à Papo et accédez à l'API REST pour automatiser vos rendez-vous dès le premier utilisateur.