Vue d'ensemble
Nous lançons une nouvelle expérience de calendrier et de gestion des disponibilités, conçue pour offrir plus de flexibilité à votre organisation, une meilleure visibilité et une façon plus intuitive de gérer vos plannings au quotidien.
Les principaux changements concernent l'onglet Calendrier et la page Disponibilités. Ces pages auront une apparence différente de celle que vous connaissez aujourd'hui, mais la plupart des fonctionnalités principales restent les mêmes, avec une interface mise à jour et de nouvelles possibilités.
À partir de la mi-septembre, nous transférerons progressivement les clients existants du calendrier actuel vers le nouveau calendrier, par vagues. Votre organisation recevra une date de transfert, qui vous sera communiquée par e-mail. Cette date est fixe.
D'ici à votre date de transfert, nous vous encourageons, ainsi que vos équipes, à vous familiariser avec les changements présentés dans cet article et dans nos autres pages du Centre d'aide. Vous pourrez ainsi aborder cette transition en toute confiance.
Vous n'êtes pas encore passé au nouveau calendrier ? Si vous utilisez toujours la version précédente du calendrier, sélectionnez ce lien pour accéder aux articles du Centre d'aide correspondants.
Dans cet article :
Qu'est-ce qui change avec la nouvelle interface ?
Changements des Disponibilités
Fonctionnement du transfert du calendrier
Checklist de préparation et du jour de bascule
Informations pour les développeurs et les utilisateurs de l'API
À qui s'adresse ce guide ?
Nous lançons un calendrier et une expérience de disponibilités actualisées, conçus pour offrir à votre cabinet plus de flexibilité, une meilleure visibilité et une gestion des rendez-vous plus intuitive.
Pour savoir si ce guide vous concerne, rendez-vous dans l'onglet Calendrier :
-
Si vous voyez l'icône "Nouveau" à côté de votre onglet "Calendrier" :
Vous utilisez déjà le nouveau calendrier. Vous n'avez pas besoin d'effectuer de transfert de calendrier, ce guide ne vous concerne donc pas. Explorez plutôt nos guides sur le Calendrier actualisé ci-dessous pour en découvrir toutes les fonctionnalités.
Vue d'ensemble des Disponibilités
Personnaliser l'affichage de votre Calendrier
Vous pouvez également vous inscrire à notre webinaire "Préparez-vous au Calendrier Semble actualisé", au cours duquel nous vous présenterons les prochains changements, mettrons en avant les nouveautés et partagerons des conseils pour vous aider à naviguer dans votre calendrier.
-
Si vous ne voyez pas l'icône "Nouveau" à côté de votre onglet "Calendrier" :
Votre cabinet utilise encore le calendrier actuel. Ce guide est fait pour vous.
Nous vous informerons dès que votre date de migration sera confirmée. En attendant, continuez la lecture pour comprendre ce qui change, à quoi vous attendre lors de la migration et comment préparer votre cabinet à cette transition.
Vous pouvez également vous inscrire à notre webinaire "Préparez-vous au Calendrier Semble actualisé", au cours duquel nous vous présenterons les prochains changements, mettrons en avant les nouveautés et partagerons des conseils pour vous accompagner tout au long du transfert.
Guides de démarrage rapide
Vous pouvez maintenant vous inscrire à notre webinaire Préparer le nouveau calendrier Semble. Nous y présenterons les changements à venir dans le calendrier, les nouveautés, ainsi que des conseils pour vous aider à préparer la transition.
Découvrez les bases en quelques minutes.
Suivez le guide accessible ci-dessous pour découvrir les bases de la navigation dans les nouvelles vues du calendrier, de la réservation de rendez-vous dans le calendrier et de la gestion des disponibilités des praticien(ne)s ou des disponibilités non attribuées.
Guide de démarrage rapide du nouveau calendrier
Pour naviguer entre les sections, sélectionnez Get Started en bas à droite de la page de démonstration interactive, puis choisissez la section que vous souhaitez parcourir.
Qu'est-ce qui change avec la nouvelle interface ?
Vous trouverez ci-dessous une vue d'ensemble des principaux changements apportés à l'onglet Calendrier et à vos paramètres Disponibilités. Pour consulter des guides plus détaillés, accédez aux pages suivantes du Centre d'aide :
Nous partagerons également un webinaire ici prochainement. Revenez sur cette page plus tard si vous souhaitez le regarder.
Aucune fonctionnalité n'est supprimée. Le nouveau calendrier inclut tout ce que vous utilisez aujourd'hui, ainsi que de nouvelles fonctionnalités. Les fonctionnalités ci-dessous seront déployées progressivement au cours de l'été.
Calendrier — Qu'est-ce qui change ?
1. Une nouvelle interface de calendrier
Le nouvel onglet Calendrier est conçu pour vous offrir plus d'espace et réduire le nombre de clics. La mise en page est légèrement différente, mais les actions principales — créer, modifier et gérer des rendez-vous — fonctionnent de la même manière.
2. Vue d'ensemble
La vue d'ensemble a été mise à jour pour afficher votre calendrier sous forme de chronologie, avec une disposition horizontale. Vous pouvez ainsi voir plus facilement, en un coup d'œil, quel(le) praticien(ne) reçoit quel patient, et dans quelle salle, tout au long de la journée. Cette vue vous offre plus de clarté qu'auparavant.
3. Rechercher des créneaux disponibles
L'interface permettant de rechercher le prochain créneau de rendez-vous disponible a été repensée pour être plus intuitive. Elle se rapproche davantage de l'expérience Online booking côté patient, ce qui vous permet de trouver et confirmer un horaire plus rapidement.
4. Navigation par date dans la barre latérale
Vous pouvez maintenant sélectionner les dates que vous souhaitez afficher directement depuis un mini-calendrier dans la barre latérale gauche. Cela vous permet d'accéder plus rapidement à un jour ou à une période spécifique.
5. Filtre « Planning actif uniquement »
Filtrez instantanément l’affichage pour ne voir que les praticiens ayant des disponibilités, afin de conserver uniquement les informations les plus pertinentes dans votre vue. Ce filtre est disponible uniquement dans la vue Salle.
| Fonctionnalité/zone | Expérience précédente | Nouvelle expérience |
|---|---|---|
| La vue d'ensemble — La vue d'ensemble affiche désormais votre calendrier sous forme de chronologie horizontale, ce qui permet de voir plus facilement quel(le) praticien(ne) reçoit quel patient, et dans quelle salle, tout au long de la journée. | 
|
 |
| Rechercher des créneaux disponibles — L'interface repensée pour trouver le prochain créneau disponible se rapproche désormais davantage de l'expérience Online booking côté patient, ce qui permet de trouver et confirmer un horaire plus rapidement. | 
|
|
| Navigation par date dans la barre latérale — Vous pouvez maintenant sélectionner les dates que vous souhaitez afficher directement depuis un mini-calendrier dans la barre latérale gauche. Cela vous permet d'accéder plus rapidement à un jour ou à une période spécifique. | 
|
|
|
Filtre « Planning actif uniquement » Filtrez instantanément l’affichage pour ne voir que les praticiens ayant des disponibilités, afin de conserver uniquement les informations les plus pertinentes dans votre vue. |
|
Prêt avant le jour de la transition (Calendrier) :
Remarque : aucune fonctionnalité n’est supprimée. Le calendrier repensé inclut tout ce que vous utilisez aujourd’hui, ainsi que des fonctionnalités supplémentaires. Les fonctionnalités ci-dessous seront déployées progressivement au cours de l’été et seront toutes disponibles avant le jour de votre transition.
1. Vue Mensuelle
La première version inclut les vues Jour, Trois jours, Semaine de travail et Semaine. La vue Mensuelle sera réintroduite dans une prochaine mise à jour.
2. Réservation avec plusieurs patients ou praticiens
La prise en charge de la réservation de rendez-vous avec plusieurs patients est prévue, suivie de la prise en charge de plusieurs praticiens.
3. Confirmer manuellement les rendez-vous
La première version n’affichera pas les rendez-vous nécessitant une confirmation manuelle de la même manière qu’auparavant : ils apparaîtront comme les autres rendez-vous qui ne nécessitent pas de confirmation manuelle. Nous travaillons à rendre cette fonctionnalité de nouveau disponible dès que possible.
D’autres nouveautés sont encore à venir. Nous continuerons à mettre à jour le Centre d’aide au fur et à mesure de leur déploiement.
Disponibilités — Qu'est-ce qui change ?
1. Modèles de répétition alternée
Vous pouvez désormais définir la fréquence de répétition d'une série de disponibilités récurrentes.
2. Dates de début et de fin pour les disponibilités
Une disponibilité récurrente peut désormais avoir une date de début et une date de fin définies. Vous pouvez ainsi planifier à l'avance les changements de planning, sans modifications manuelles au jour le jour, tout en conservant l'historique des disponibilités.
3. Plus de flexibilité lors de la modification des disponibilités récurrentes
Vous pouvez désormais choisir de mettre à jour une seule occurrence, d'ajuster la date de fin d'une série de disponibilités récurrentes à partir d'un point sélectionné, ou de mettre à jour toute la série. Vous gardez ainsi un meilleur contrôle lorsque les plannings doivent évoluer.
4. Les disponibilités générales s'appellent désormais Non attribuée
Le libellé a changé, mais le comportement reste exactement le même. Toute disponibilité qui n'est pas associée à un(e) praticien(ne) spécifique est désormais appelée
Non attribuée.
5. Absence a été renommé Indisponible
Le bloc Absence n'a pas été supprimé : il a simplement été renommé Indisponible et fonctionne de la même manière. Vous pouvez toujours ajouter un commentaire, par exemple « Pause déjeuner » ou « Réunion interne ». Celui-ci apparaîtra directement sur le bloc dans le Calendrier.
6. Motifs d'indisponibilité Vous pourrez catégoriser le motif d'un bloc d'indisponibilité, par exemple administration, réunions ou maladie. Cela permettra d'accéder à des rapports plus détaillés sur la capacité et l'utilisation.
7. Meilleure distinction des couleurs des salles Auparavant, les disponibilités des salles s'affichaient dans des couleurs visuellement similaires, ce qui rendait difficile la distinction entre les salles en un coup d'œil. Le nouveau code couleur offre une séparation visuelle plus claire, afin que vous puissiez identifier rapidement les salles qui ont des disponibilités.
Prêt avant le jour de bascule — Disponibilités
REMARQUE : Aucune fonctionnalité n'est supprimée. Le Calendrier actualisé inclut tout ce que vous utilisez aujourd'hui, ainsi que des fonctionnalités supplémentaires. Les fonctionnalités ci-dessous seront déployées progressivement pendant l'été et seront toutes disponibles avant votre jour de bascule.
1. Indisponibilité récurrente Vous pourrez bientôt configurer des blocs récurrents réguliers, par exemple des réunions hebdomadaires ou des pauses quotidiennes, sans avoir à les ajouter manuellement à chaque fois.
2. Bouton d'activation de l'alerte de double réservation Le bouton qui permettait d'activer ou de désactiver l'alerte de double réservation est temporairement supprimé. Toutefois, l'alerte elle-même reste en place et sera toujours active par défaut. Vous serez toujours averti(e) si vous tentez de réserver un rendez-vous qui chevauche un rendez-vous existant. Nous prévoyons de rendre ce paramètre à nouveau disponible dans les prochains mois.
Fonctionnement du transfert du calendrier
Le Calendrier actualisé utilise la même base de données de rendez-vous que le Calendrier que vous utilisez déjà. Vos rendez-vous resteront donc exactement identiques.
Les horaires de travail de vos praticien(ne)s, c'est-à-dire leurs disponibilités, doivent être transférés afin de prendre en charge les nouvelles fonctionnalités de planification récurrente.
Nous nous en chargeons pour vous pendant la nuit précédant votre jour de bascule. Lorsque vous vous connecterez, tout sera déjà configuré pour que vous puissiez commencer votre journée.
Le transfert de vos disponibilités vers le Calendrier actualisé n'entraîne aucune interruption de service. Vos patients peuvent donc prendre rendez-vous en ligne normalement.
Voici comment cela fonctionnera :
Notre équipe lancera un script pour copier vos disponibilités dans le Calendrier actualisé entre 18 h la veille et 9 h le matin de la bascule.
ATTENTION : NE modifiez PAS et ne créez PAS de disponibilités dans le Calendrier actuel pendant cette période. Toute modification effectuée pendant ce créneau ne sera pas copiée.
Rappel : la bascule n'entraîne aucune interruption de service et vos patients peuvent prendre rendez-vous comme d'habitude.
1. La veille au soir
Nos équipes lancent un script en dehors des heures d'activité afin de copier vos disponibilités dans le Calendrier actualisé. NE créez PAS de nouvelles disponibilités pendant cette période, car elles ne seront pas transférées.
2. Le matin
Il vous suffit de vous connecter à Semble : votre Calendrier actualisé — avec tous vos rendez-vous et vos disponibilités — sera prêt, exactement comme avant, pour que vous puissiez commencer votre journée immédiatement.
Checklist de préparation et du jour de bascule
Avant le jour de bascule :
- Demandez à tous les utilisateurs actifs de votre compte de réaliser la démonstration de formation, de lire ce guide et de consulter les articles du Centre d'aide :
- Convenez avec Semble de votre date de bascule et de la fenêtre de nuit pour le transfert de vos rendez-vous et disponibilités.
- Informez toutes les équipes sur les moments où il ne faut pas ajouter ni modifier de disponibilités.
Le jour de votre mise en production:
- Envisagez d'arriver un peu plus tôt pour vous familiariser avec la nouvelle interface et les nouvelles vues du Calendrier.
- Signalez tout problème directement à notre équipe d'assistance à l'adresse assistance@semble.fr. Pour éviter les doublons, vous pouvez désigner une personne de contact au sein de votre organisation, par exemple un(e) responsable ou un(e) référent(e) d'équipe.
- Lorsque vous contactez notre équipe d'assistance, veuillez inclure autant d'informations pertinentes que possible. Nous avons rédigé un guide sur les informations à fournir, disponible ici.
- Pour les responsables d'organisation : prévoyez du temps pour revoir et mettre à jour les disponibilités récurrentes. Ce n'est pas indispensable le premier jour, mais cela vous permettra de tirer le meilleur parti du nouveau Calendrier et de configurer efficacement les plannings de votre équipe.
Après votre mise en production :
- Continuez à nous faire part de vos retours ou à signaler tout problème. Nous vous recommandons de revenir sur ce guide régulièrement afin de rester informé(e) des dernières fonctionnalités et mises à jour. Nous mettrons également à jour nos guides principaux du Centre d'aide tout au long de la transition.
FAQ
Mes rendez-vous patients seront-ils transférés en toute sécurité ?
Oui. Vous ne perdrez pas un seul rendez-vous. Le nouveau Calendrier utilise exactement la même base de données de rendez-vous que celle que vous utilisez aujourd'hui — il vous offre simplement une interface plus rapide et mise à jour pour les consulter. Comme les rendez-vous ne sont pas réellement déplacés, il n'y a aucun risque qu'ils soient perdus.
Que devient notre planning du personnel actuel ?
Les horaires de travail existants de vos praticien(ne)s seront transférés en toute sécurité pendant la nuit précédant votre jour de bascule. Vous n'avez pas besoin de reconstruire vos plannings de zéro.
Pourquoi mes disponibilités doivent-elles être transférées si mes rendez-vous ne le sont pas ?
Vos rendez-vous sont stockés dans une base de données compatible avec le Calendrier actuel et le Calendrier actualisé : ils resteront donc identiques. Les disponibilités, en revanche, fonctionnent différemment. Le Calendrier actuel les enregistre sous forme de simples plages horaires, par exemple « Mardi, 9 h–17 h ».
Le Calendrier actualisé nécessite davantage d'informations pour gérer les modèles de répétition, ce qui implique une structure de données différente.Pour intégrer vos disponibilités existantes dans cette nouvelle structure, nous effectuons un transfert unique la veille de votre jour de bascule. Lorsque vous vous connecterez, tout sera déjà en place. Vous n'avez rien à faire.
ATTENTION : Ne créez, ne modifiez et ne supprimez aucune disponibilité à partir de 18 h la veille de votre jour de bascule, et ce jusqu'à 9 h le matin du jour de votre bascule.
Comment saurai-je quand mon organisation est planifiée pour la mise à jour ?
Nous vous contacterons directement par e-mail deux semaines avant votre date de transfert.
Y aura-t-il une interruption de service pendant les heures d'activité ?
Non. Le transfert des disponibilités sera effectué en dehors des heures d'activité par l'équipe Semble (entre 18 h et 9 h). Vos patients pourront toujours prendre rendez-vous en ligne normalement.
Il n'y aura aucune interruption de service ni d'impact sur votre activité.Veuillez ne pas créer, modifier ni mettre à jour de disponibilités, ni ajouter de nouvelles disponibilités ponctuelles, pendant cette période en dehors des heures d'activité, à partir de 18 h la veille de votre bascule et avant 9 h le jour de votre mise en production.
Pourquoi certains clients basculent-ils plus tôt, et puis-je avancer ma date ?
Les nouveaux clients Semble démarrent directement sur le Calendrier actualisé, car ils n'ont pas de données historiques à transférer. Pour nos clients existants, nous procédons par vagues afin de garantir la stabilité de la plateforme. Vous ne pouvez pas modifier la date qui vous a été attribuée, mais nous sommes certains que l'attente en vaudra la peine !
Pouvons-nous choisir de continuer à utiliser le Calendrier existant ?
Non. La nouvelle architecture du Calendrier est requise pour toutes les futures mises à jour de Semble et pour la stabilité de la plateforme. La mise à jour est donc obligatoire pour tous les comptes.
Quelque chose ne fonctionne pas — que dois-je faire ?
Si vous constatez un dysfonctionnement, nous vous recommandons d'interroger d'autres membres de votre organisation pour vérifier s'ils rencontrent le même problème. Si vous identifiez un problème affectant plusieurs personnes, signalez-le nous en envoyant un e-mail à assistance@semble.fr.
Lorsque vous nous contactez, veillez à inclure les informations pertinentes décrites dans ce guide : Comment obtenir de l'aide auprès de Semble.
REMARQUE : Si vous joignez des captures d'écran, veillez à masquer toute donnée sensible ou information personnelle identifiable au préalable. Vous pouvez utiliser l'option « Masquer les noms des patients » dans vos paramètres du Calendrier pour effectuer cette opération rapidement.
Comment puis-je accompagner mes équipes dans ce changement ?
Nous savons que le changement peut être difficile à appréhender, mais la nouvelle interface est très intuitive et fonctionne de manière très similaire aux autres calendriers que vous connaissez peut-être déjà, comme Google ou Outlook.
Nous vous recommandons de demander à vos équipes de regarder notre webinaire de préparation et de parcourir nos Guides de démarrage rapide ci-dessus. Nous avons également mis à jour notre Centre d'aide et continuerons à le faire afin que chacun dispose des informations nécessaires pour aborder ce changement aussi facilement que possible.
Que dois-je faire le jour J ?
Il n'y a rien de particulier à faire pour cette bascule. Nous vous suggérons d'envisager de commencer un peu plus tôt que d'habitude, afin de vous laisser le temps d'explorer le Calendrier actualisé et de vous familiariser avec vos processus avant le début de l'activité.
J'ai une question qui n'est pas traitée ici. Où puis-je obtenir de l'aide supplémentaire ?
Cette page a vocation à être un guide d'introduction et de démarrage rapide pour le Calendrier actualisé, mais nous ne prétendons pas avoir couvert toutes les questions que vous pourriez vous poser.La prochaine étape serait de consulter nos pages dédiées du Centre d'aide pour le Calendrier et les Disponibilités.Si vous avez encore des doutes, notre équipe d'assistance est disponible pour répondre à vos questions.
Vous pouvez leur envoyer un e-mail à assistance@semble.fr. Nous vous remercions de votre patience, car nous pourrions faire face à un volume de demandes plus élevé que d'habitude. Nous ferons tout notre possible pour vous aider aussi rapidement que possible !
Informations pour les développeurs et les utilisateurs de l'API
Cette section s'adresse aux organisations qui utilisent l'API Semble, par exemple si vous disposez d'un site web de prise de rendez-vous sur mesure, développé en interne ou par un développeur tiers. Si votre organisation n'utilise pas d'intégrations API personnalisées, vous pouvez passer cette section.
Pour un aperçu technique approfondi, inscrivez-vous à notre webinaire Le nouveau Calendrier Semble : Questions-Réponses techniques pour les utilisateurs de l'API, au cours duquel nous présenterons la nouvelle API du Calendrier, les points à prendre en compte pour l'intégration, et répondrons à vos questions techniques.
Dans cette section :
- Qu'est-ce qui change ?
- Votre calendrier de mise à jour des endpoints API
- Comment tester les nouveaux endpoints
- Plan de test recommandé étape par étape
- Éléments à valider dans les réponses
- Dépannage et erreurs courantes
- Webhooks
- Faire appel à un développeur tiers
Qu'est-ce qui change ?
Nous introduisons de nouveaux endpoints de disponibilités pour prendre en charge les fonctionnalités avancées de disponibilités récurrentes du Calendrier actualisé.Le modèle de données des disponibilités ayant fondamentalement changé dans le Calendrier actualisé, il nous est impossible de simplement mettre à jour les anciens endpoints.
Vous devez mettre à jour vos intégrations pour utiliser les nouveaux endpoints de disponibilités.Modifications des endpoints — consultez la Documentation développeur pour commencer avec le nouveau système de Calendrier Semble.
| Action | Endpoints existants | Nouveaux endpoints | Notes développeur |
|---|---|---|---|
| Récupérer les données de disponibilité | availabilitySettings | availabilityRules query | La structure de la réponse sera différente. Le nouveau availabilityRules utilise une nouvelle structure pour gérer la récurrence. |
| Bloquer du temps | CreateOutOfOfficeBooking | createAvailability — saisir unavailability: true pour rendre le créneau indisponible |
Out-of-office est désormais modélisé comme une indisponibilité. Mettez à jour votre write path pour que les blocs s'affichent correctement dans l'interface du Calendrier. |
| Gérer les plannings récurrents du personnel | availabilities | La query Availabilities restera entièrement compatible avec le nouveau Système de rendez-vous Semble. | |
| availabilitySlots | La nouvelle query availabilitySlots offrira des fonctionnalités supplémentaires, notamment : jusqu'à 4 semaines de données de disponibilité, disponibilité de plusieurs utilisateurs et salles, objets utilisateur et salle associés retournés dans la même query, support de la pagination. |
Votre calendrier de mise à jour des endpoints API
Vous n'avez pas besoin d'attendre que votre organisation ait basculé vers le nouveau Calendrier pour mettre à jour vos endpoints API. Vous pouvez commencer à développer et tester les nouveaux endpoints immédiatement.
Nous vous recommandons vivement de finaliser votre travail sur les endpoints API avant la date de mise en production de votre organisation, afin de garantir une transition fluide et de profiter immédiatement des nouvelles fonctionnalités du Calendrier actualisé.
Que dois-je faire, et quand ?
- Dès maintenant : votre environnement Sandbox a été activé avec le nouveau Calendrier et les nouveaux endpoints. Commencez à développer et tester les nouveaux endpoints immédiatement si vous prévoyez de les utiliser.
- Le jour de la bascule : il n'y a pas de breaking changes. Vos endpoints existants continueront de fonctionner le jour où vous basculerez vers le nouveau Calendrier. Vous pourrez passer aux nouveaux endpoints ce jour-là si vous avez terminé vos tests. Vous pouvez exécuter les anciens et les nouveaux endpoints en parallèle pour surveiller les performances.
- La date limite absolue : nous retirerons définitivement le Calendrier actuel et désactiverons les endpoints dépréciés à la fin du T4 2026. Vous devez finaliser votre migration vers les nouveaux endpoints avant cette date pour éviter toute interruption de service et perturbation de votre activité.
Comment tester les nouveaux endpoints
Les nouveaux endpoints sont soumis à une activation. Cela signifie qu'ils renverront des erreurs ou des résultats vides si vous tentez de les appeler sur un compte ne disposant pas des fonctionnalités du Calendrier actualisé.
Étape 1 : Tester dans votre Sandbox
Nous activerons le nouveau Calendrier dans votre environnement Sandbox afin que vous puissiez développer immédiatement contre les nouveaux endpoints, sans risque pour vos données de production.
Vous avez besoin d'un compte Sandbox ? Faites-en la demande auprès de votre Customer Success Manager ou contactez assistance@semble.fr.
Vous avez besoin de données ? Nous pouvons préremplir votre Sandbox avec des données de test réalistes, basées sur les modèles de rendez-vous de votre organisation (sans aucune information réelle sur les patients), pour que vous puissiez tester efficacement.
Étape 2 : Tester en production
Une fois que votre compte principal aura basculé vers le nouveau Calendrier, les nouveaux endpoints seront actifs en production. Nous vous recommandons de créer des « Patients test » fictifs pour valider l'intégration. Une fois satisfait(e) des réponses, vous pourrez passer à la mise en production.
Plan de test recommandé étape par étape
- Lire la documentation : familiarisez-vous avec la documentation développeur pour commencer avec le Système de rendez-vous Semble.
- Obtenir l'accès au Sandbox : assurez-vous que le nouveau Calendrier est activé sur votre Sandbox et que vos identifiants s'authentifient correctement.
- Cartographier vos appels : mappez vos appels d'endpoints existants vers leurs équivalents dans les nouveaux endpoints, en utilisant le tableau ci-dessus.
- Tester le Read Path en premier : interrogez availabilityRules pour les praticien(ne)s/salles que vous connaissez. Ne supposez pas que les nouveaux noms de champs correspondent aux anciens. Validez les champs de la réponse un par un par rapport à la documentation du nouveau endpoint.
- Tester le Write Path : créez des indisponibilités via l'API et confirmez qu'elles s'affichent correctement dans l'interface du Calendrier.
- Explorer le nouveau modèle : assurez-vous que votre parsing gère les nouvelles représentations de données, notamment les modèles récurrents, les modifications d'occurrence unique (« cet événement uniquement ») et les dates de début/fin pour le personnel temporaire.
- Couvrir les cas limites : vérifiez la gestion des erreurs pour les praticien(ne)s non validé(e)s, les disponibilités qui se chevauchent, les échecs d'authentification et les limites de pagination.
- Effectuer une régression end-to-end : testez l'intégralité de votre flux de réservation (ex. : récupération du créneau → création du rendez-vous → confirmation) dans le Sandbox.
- Déployer et surveiller : conservez les endpoints actuels comme solution de secours dans votre code jusqu'à ce que vous ayez vérifié que les nouveaux endpoints fonctionnent correctement en production.
Éléments à valider dans les réponses
- Noms et structure des champs — partez du principe qu'ils diffèrent entre les endpoints actuels et les nouveaux endpoints ; référez-vous à la documentation développeur comme guide de référence.
- Représentation des disponibilités récurrentes, des modifications de séries et des dates de début/fin.
- Apparence des disponibilités Non attribuées (praticien(ne) inconnu(e)).
- Pagination, limites de résultats, limites de débit et comportement de throttling.
- Formats d'erreur et codes de statut, ainsi que les différences de portée d'authentification pour la V2.
Dépannage et erreurs courantes
- Supposer que les noms de champs des nouveaux endpoints correspondent à ceux des endpoints actuels — ce n'est probablement pas le cas.
- Oublier que les nouveaux endpoints sont soumis à un feature flag. Si le Calendrier actualisé n'est pas activé sur ce compte, vous obtiendrez des erreurs ou des résultats vides.
- Tester en production avec des données réelles au lieu d'utiliser un Patient test.
- Laisser la mise à jour des endpoints trop proche de la date limite de retrait.
- Ne pas gérer le nouveau modèle de disponibilités (récurrent/série/dates de début-fin) dans votre parsing.
Webhooks
Les webhooks pour les disponibilités ne sont pas inclus dans cette version initiale. Ils figurent sur notre roadmap et sont en cours d'évaluation. En attendant, interrogez availabilityRules selon un calendrier raisonnable, mettez en cache lorsque possible, et réduisez gracieusement les appels pour rester dans les limites de débit.
Faire appel à un développeur tiers
Si vous ne disposez pas d'une équipe technique en interne, transmettez dès maintenant cette section à votre développeur ou agence externe afin qu'il puisse planifier le travail avant la date limite de retrait. Il peut demander l'accès au Sandbox via le point de contact principal de votre organisation.