Blog

Alimenter une marketplace de planification

Sydney OlejnikNov 16, 2022

Une marketplace de planification : qu’est-ce que cela signifie ? Comment l’utiliser ?

Cal.com a été conçu pour alimenter votre marketplace de planification, mais beaucoup de gens sont perdus lorsqu’ils entendent l’expression « marketplace de planification ».

Que signifie exactement alimenter une marketplace de planification ?

Le scénario idéal pour n’importe quelle entreprise est qu’un client reste sur son site et ne soit pas redirigé vers un autre site pour la moindre action. L’infrastructure de planification de Cal.com permet aux organisations d’y parvenir facilement.

La meilleure façon d’expliquer pleinement comment cela fonctionne est d’utiliser un exemple.

Imaginons que vous ayez choisi d’utiliser les API de Cal.com pour alimenter la marketplace de planification de votre entreprise. À quoi cela ressemble-t-il ? Tout commence lorsqu’un client s’inscrit sur votre toute nouvelle plateforme, que nous allons appeler BestDogSitting. Lorsque le client crée un compte sur BestDogSitting, ce compte est également créé sur Cal.com via l’API (Single Sign On) ; le client peut alors ajouter ses disponibilités, qui sont récupérées dans la plateforme Cal.com via l’API, puis il peut sélectionner les pages d’événements qu’il souhaite. À mesure que Cal.com se développe et ajoute davantage d’API, les deux parties bénéficient de cette infrastructure solide.

Avec l’infrastructure de planification de Cal.com, BestDogSitting est également en mesure de créer des composants UI front-end et, en utilisant l’un de nos plus de 40+ points de terminaison API, d’envoyer ces données vers et depuis la plateforme Cal.com, créant ainsi une expérience de planification native pour les clients sans avoir à reconstruire l’ensemble de la solution de planification. S’il y a une chose que notre équipe a apprise, c’est que la planification et les fuseaux horaires sont extrêmement complexes et demandent bien plus de travail que la plupart des ingénieurs ne l’imaginent.

D’où vient tout cela ? La réponse est simple : Lean Hire.

Lean Hire est une marketplace de recrutement créée à l’origine par notre PDG, Peer Richelsen. Lorsqu’on utilise Lean Hire, les organisations ont la possibilité de faire du contract-to-hire comme période d’essai avec leurs candidats potentiels plutôt que de se lancer immédiatement. L’idée a été largement utilisée chez OnDeck (où elle a finalement été acquise) et elle est toujours utilisée chez Cal.com comme principale manière d’intégrer de nouveaux membres dans l’équipe.

Avec Lean Hire, chaque fois qu’un nouvel utilisateur était créé, le candidat devait soit ajouter son propre lien Calendly, soit Peer devait créer manuellement un nouveau compte pour lui. Ce n’était pas l’expérience idéale, car cela les éloignait du site Lean Hire, et Peer n’avait aucune donnée ni aucun contrôle sur ce qui se passait de l’autre côté.

En mode résolution de problème, Peer a réalisé qu’il lui fallait un produit de planification qui puisse soit être entièrement intégré au site web, soit disposer d’API robustes pour automatiser, en substance, des tâches telles que la création d’un nouvel utilisateur, la création de scheduling links, la création de disponibilités, et bien plus encore.

D’accord, c’est intéressant, mais qu’est-ce que tout cela signifie ?

Alimenter entièrement une marketplace de planification nécessite une forte automatisation via des API. Ces API permettent de créer entièrement l’expérience de planification pour que les entreprises paraissent aussi natives que si elles l’avaient créée elles-mêmes.

Cal.com résout largement ce problème. À mesure que nous continuons à nous développer et à ajouter davantage d’API, notre produit Platform devient plus puissant et, en plus, les organisations peuvent l’héberger elles-mêmes afin d’avoir accès à toutes les données de bout en bout. N’importe quelle organisation peut exécuter plusieurs types de requêtes pour comprendre ce que font ses utilisateurs. Cela n’est actuellement pas possible avec d’autres produits et est spécifique à ce que Cal.com propose. Avec Cal, les organisations peuvent avoir un contrôle total sur leurs données pour répondre au mieux à leurs besoins.

Sur site

Le produit Platform est également l’un des rares produits proposés en déploiement sur site. Sur site signifie que les organisations peuvent auto-héberger leurs données sur leurs propres serveurs. Grâce à l’auto-hébergement, les organisations ont un contrôle total sur les données de leurs utilisateurs. Avec ce contrôle global, les entreprises peuvent utiliser les données de leurs utilisateurs comme elles l’entendent. En outre, cela leur offre beaucoup plus de contrôle et de sécurité.

C’est génial ; comment puis-je utiliser cela pour avantager mon entreprise ?

Lorsque vous auto-hébergez avec Cal.com, vous vous donnez la possibilité de reprendre le contrôle de vos données. C’est au mieux fait via nos puissants points de terminaison API avec notre produit Platform. Pour vous donner quelques idées de ce qui peut être fait, voici quelques-uns de nos points de terminaison API les plus utilisés à ce jour :

Points de terminaison API [CRUD] :

Participants

Disponibilités

Références de réservation

Réservations

Champs personnalisés

Calendriers de destination

Références d’événements

Scheduling links

Adhésions

Paiements

Plannings

Calendriers sélectionnés

Teams

Utilisateurs

Webhooks

Voici quelques exemples d’utilisation de ces points de terminaison API :

API de Scheduling Link

Nos API peuvent être personnalisées et forkées pour répondre exactement à vos besoins. Vous trouverez ci-dessous quelques exemples de personnalisations actuelles et utilisées.

Pour créer un nouveau scheduling link, vous pourriez faire quelque chose comme ce qui suit :

[POST] : htttps://www.example.com/api/v1/event-types?apiKey=1234abcd

Paramètres du corps brut :

{

    "userId": 4,

    "title": "Tennis class",

    "slug": "tennis-class-{{$guid}}",

    "length": 60,

    "hidden": false,

    "position": 0,

    "teamId": null,

    "eventName": null,

    "timeZone": null,

    "periodType": "UNLIMITED",

    "periodStartDate": null,

    "periodEndDate": null,

    "periodDays": null,

    "periodCountCalendarDays": null,

    "requiresConfirmation": true,

    "recurringEvent": {

        "interval": 2,

        "count": 10,

        "freq": 2

    },

    "disableGuests": false,

    "hideCalendarNotes": false,

    "minimumBookingNotice": 120,

    "beforeEventBuffer": 0,

    "afterEventBuffer": 0,

    "schedulingType": null,

    "price": 0,

    "currency": "usd",

    "slotInterval": null,

    "successRedirectUrl": null,

    "description": null,

    "locations": [

        {

            "address": "London",

            "type": "inPerson"

        }

    ],

    "metadata": {}

}

Pour obtenir tous les scheduling links, vous pourriez faire quelque chose comme ce qui suit :

[GET] : htttps://www.example.com/api/v1/event-types?apiKey=1234abcd

Pour METTRE À JOUR/PATCHER un lien de planification individuel, vous pouvez procéder ainsi :

[PATCH] : htttps://www.example.com/api/v1/event-types/:id?apiKey=1234abcd

où :id est l'ID du type d'événement (numérique)

Paramètres bruts du corps :

{

    "title": "Football class",

     ...other_changes

}

Pour SUPPRIMER un lien de planification individuel, vous pouvez procéder ainsi :

[DELETE] : htttps://www.example.com/api/v1/event-types/:id?apiKey=1234abcd

où :id est l'ID du type d'événement (numérique)

Pour obtenir un type d'événement individuel, vous pouvez procéder ainsi :

[GET] : htttps://www.example.com/api/v1/event-types/:id?apiKey=1234abcd

où :id est l'ID du type d'événement (numérique)

Cal.com est la solution de planification de premier plan qui donne la priorité à votre capacité à alimenter une marketplace de planification. Nous sommes là pour vous aider à faire réussir votre organisation.

Vous voulez commencer ? Consultez notre documentation ici : https://developer.cal.com/api/quick-start 

Cal.com est désormais GRATUIT pour les particuliers - inscrivez-vous ici

Sydney Olejnik

Post by

Sydney Olejnik

Administrative Coordinator