Prise de rendez-vous
Calendly dans votre produit et vos agents IA, via une API
Le toolkit Calendly couvre les types d'événement, les créneaux libres, les événements planifiés et leurs invités : les lister et les lire, créer et modifier des types d'événement individuels, réserver une réunion, l'annuler et générer des liens de planification à usage unique. Le client connecte Calendly une fois par OAuth, et votre produit ou agent IA appelle chaque opération via un seul endpoint Connect, sans construire le flux OAuth ni stocker de jetons.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/calendly_create_event_type/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"owner": "<owner>",
"name": "<name>"
}
}Fonctionnement
Du client connecté au premier appel à Calendly.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Calendly. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Calendly.
Réserver depuis votre produit
Lisez les créneaux libres d'un type d'événement et créez l'invité depuis votre propre écran, pour que le client réserve sans quitter votre application.
Synchroniser les réunions au CRM
Listez les événements planifiés et leurs invités, avec réponses et suivi UTM, puis écrivez-les dans votre CRM ou outil de reporting.
Planification par un agent IA
Donnez à l'agent les outils de créneaux libres et de lien de planification, pour qu'il propose un créneau, le réserve ou envoie un lien à usage unique à un prospect.
Tools
12 tools Calendly
- Obtenir l'utilisateur actuelGETRenvoie l'utilisateur Calendly connecté : uri, l'URI de l'utilisateur que demandent Lister les types d'événement, Lister les événements planifiés et Créer un type d'événement, et current_organization, l'URI de l'organisation, avec name, email, scheduling_url et timezone.
- Lister les types d'événementGETListe les types d'événement d'un utilisateur ou d'une organisation : envoyez user ou organization. Chaque élément a uri, name, duration en minutes, scheduling_url et active. La réponse contient collection et pagination : passez pagination.next_page_token comme page_token pour lire la page suivante.
- Obtenir un type d'événementGETRenvoie un type d'événement, avec name, duration en minutes, duration_options, locations, custom_questions (les questions de réservation auxquelles répond Créer un invité d'événement), scheduling_url et active.
- Créer un type d'événementPOSTCrée un type d'événement individuel (one-on-one) pour un utilisateur et le renvoie. Seul ce type (solo) peut être créé par l'API, et il est créé inactif sauf si active vaut true.
- Modifier un type d'événementPATCHModifie un type d'événement individuel et le renvoie. Seuls les champs envoyés changent. Seuls les types d'événement de type solo peuvent être modifiés par l'API.
- Lister les créneaux libres d'un type d'événementGETListe les heures de début libres d'un type d'événement sur une plage allant jusqu'à 31 jours dans le futur. Chaque élément a start_time en UTC, invitees_remaining et scheduling_url. Il n'y a pas de pagination : demandez une plage plus courte si besoin.
- Lister les événements planifiésGETListe les réunions planifiées d'un utilisateur ou d'une organisation : envoyez user ou organization. Chaque élément a uri, name, status, start_time et end_time en UTC, event_type et invitees_counter. La réponse contient collection et pagination : passez pagination.next_page_token comme page_token pour lire la page suivante.
- Obtenir un événement planifiéGETRenvoie une réunion planifiée, avec name, status, start_time et end_time en UTC, event_type, location, invitees_counter, event_memberships (les hôtes) et, si elle a été annulée, cancellation.
- Annuler un événement planifiéPOSTAnnule une réunion planifiée pour tous ses invités et renvoie l'annulation. Un événement de groupe est annulé en entier : on ne peut pas annuler un seul invité d'un événement de groupe par l'API.
- Lister les invités d'un événementGETListe les invités d'une réunion planifiée, avec name, email, status, questions_and_answers, tracking (les paramètres UTM de la réservation), no_show, cancel_url et reschedule_url. La réponse contient collection et pagination : passez pagination.next_page_token comme page_token pour lire la page suivante.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/calendly, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Calendly
Dois-je intégrer l'API Calendly moi-même ?
Non. Connect fournit 12 tools Calendly décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Calendly ?
Avec le mode accepté par le toolkit : OAuth avec l'app de votre produit. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
