Intégrations (API)

​

Vue d’ensemble

​

Calendly

​

Objectif

1. Connecter Calendly (OAuth)
2. Choisir un event_type (type de RDV)
3. Générer les outils Bookivox associés (toolset)
4. Utiliser ces outils dans l’agent

​

Endpoints (clé API)

​

Étape 1 : Démarrer l’OAuth

• Si l’en-tête Accept: application/json est présent, la réponse est JSON :

{ "authorize_url": "https://auth.calendly.com/oauth/authorize?..." }

• Sinon, le backend renvoie une redirection 302 vers authorize_url.

​

Étape 2 : Autorisation utilisateur

​

Étape 3 : Vérifier la connexion

{
  "connections": [
    {
      "credential_uuid": "...",
      "name": "Calendly",
      "calendly_email": "...",
      "calendly_timezone": "Europe/Paris",
      "selected_event_type_uri": null,
      "selected_event_type_name": null,
      "ready": false
    }
  ]
}

​

Étape 4 : Lister les event types

• 400 s’il existe plusieurs connexions et que credential_uuid est absent.
• 404 si Calendly n’est pas connecté.

​

Étape 5 : Sélectionner et générer les outils

{
  "credential_uuid": "...",
  "event_type_uri": "https://api.calendly.com/event_types/...",
  "default_timezone": "Europe/Paris"
}

{ "tools": { "find_slots": "<tool_uuid>", "book": "<tool_uuid>" } }

​

Étape 6 : Utiliser les outils dans l’agent

• récupérer un outil : GET /api/v1/api/tools/{tool_uuid}
• associer/activer les outils dans la configuration du workflow.

​

Découvrir toutes les intégrations

​

Voir aussi

• Guide produit : Calendly
• MCP