Magicline Connect API

Votre assistant réserve des séances d’essai sans clé API Magicline.

Connecter un studio

Ouvrez Agent Tools → Marketplace → Magicline Connect API. Pour les informations du studio et les cours, utilisez le connecteur distinct Magicline Open API.
Indiquez l’URL de l’API Connect Magicline, par exemple https://your-studio.api.magicline.com/connect/v1, puis choisissez Charger les studios. Choisissez un studio ou Tous les studios de ce compte. Demandez l’adresse à l’administrateur du studio. L’API Connect doit être activée ; les réservations nécessitent aussi les séances d’essai en ligne.
Choisissez Connecter le studio. Famulor vérifie le studio. Les identifiants sont renseignés automatiquement ; la saisie manuelle reste possible. Aucune clé API Magicline n’est nécessaire.
Attribuez la connexion à votre assistant. Les cinq fonctions de studio et d’essai sont présélectionnées. Sélectionnez plusieurs studios pour partager les mêmes cinq outils.

Choisissez la Préférence de coach : Règle du studio, Avec un coach ou Sans coach. Cette dernière option nécessite l’autorisation du studio. Le choix s’applique aux disponibilités et aux réservations. Saisissez l’adresse API Connect et choisissez Charger les studios. Recherchez par nom ou ville, puis choisissez un studio ou Tous les studios de ce compte. Les identifiants sont remplis automatiquement. L’assistant confirme le lieu avant toute consultation ou réservation. La saisie manuelle reste possible.

Déroulement d’une réservation

Confirmez d’abord le studio. L’assistant consulte les champs requis et les créneaux disponibles, recueille les informations nécessaires et demande à l’appelant de confirmer le rendez-vous et le partage de ses données. Il confirme la réservation uniquement après une réponse positive. Aucun consentement marketing n’est supposé.

Coachs et disponibilités

Magicline gère les coachs selon les ressources du studio. La réservation avec ou sans coach dépend des règles du studio. Il n’est pas possible de choisir un coach précis. Un créneau disponible n’est pas une réservation. En cas de conflit, l’assistant recherche de nouveaux créneaux et demande un nouveau choix.

Résultat incertain

Un délai dépassé ne signifie pas que la réservation a échoué. Les demandes identiques simultanées ou répétées sont protégées contre les doublons. Vérifiez avec le studio avant toute nouvelle tentative si le résultat est incertain.

Automatisations

Connectez Magicline Connect API dans Automatisations → Connexions, ou importez sa connexion Agent Tools. Utilisez les actions de conditions, disponibilités et réservation. La confirmation de l’appelant doit précéder la réservation. Les données des cours utilisent le connecteur Open API distinct.

API, MCP, CLI & SDK

POST /api/v1/tools/magicline-connect/studios · MCP discover_magicline_connect_studios · CLI famulor discover-magicline-connect-studios. POST /api/v1/tools/magicline-connect · MCP connect_magicline_connect · CLI famulor connect-magicline-connect.

famulor discover-magicline-connect-studios --connect-api-base-url "https://your-studio.api.magicline.com/connect/v1" --search "Bremen"
famulor connect-magicline-connect --studio-id "1234567890" --connect-api-base-url "https://your-studio.api.magicline.com/connect/v1" --name magicline_trial_sessions

import { Famulor } from 'famulor-sdk';

const client = new Famulor({ apiKey: process.env.FAMULOR_API_KEY });
const { data: studios } = await client.api.discoverMagiclineConnectStudios({ body: { connect_api_base_url: 'https://your-studio.api.magicline.com/connect/v1', search: 'Bremen' } });
console.log(studios.studios);
const { data: tool } = await client.api.connectMagiclineConnect({ body: {
  studio_id: '1234567890',
  connect_api_base_url: 'https://your-studio.api.magicline.com/connect/v1',
  name: 'magicline_trial_sessions',
  trainer_mode: 'studio_default',
} });
console.log(tool.id);

Magicline Open API · Magicline Connect API

​Connecter un studio

​Déroulement d’une réservation

​Coachs et disponibilités

​Résultat incertain

​Automatisations

​API, MCP, CLI & SDK