Zum Hauptinhalt springen
Ihr Assistent bucht Probetrainings ohne Magicline-API-Schlüssel.

Studio verbinden

  1. Öffnen Sie Agent Tools → Marketplace → Magicline Connect API. Für Studio- und Kursdaten verwenden Sie den separaten Connector Magicline Open API.
  2. Geben Sie die Magicline-Connect-API-URL ein, zum Beispiel https://your-studio.api.magicline.com/connect/v1, und wählen Sie Studios laden. Wählen Sie ein Studio oder Alle Studios dieses Kontos. Die Adresse erhalten Sie vom Studio-Administrator. Connect API muss aktiviert sein; für Buchungen zusätzlich Online-Probetrainings.
  3. Wählen Sie Studio verbinden. Famulor prüft das Studio. Die Studio-IDs werden automatisch übernommen; eine manuelle Eingabe ist ebenfalls möglich. Ein Magicline-API-Schlüssel ist nicht erforderlich.
  4. Weisen Sie die Verbindung Ihrem Assistenten zu. Die fünf Studio- und Probetrainingsfunktionen sind vorausgewählt. Bei mehreren Studios können Sie dieselben fünf Tools gemeinsam verwenden.
Wählen Sie den Trainerwunsch: Studio-Vorgabe, Mit Trainer oder Ohne Trainer. Die letzte Option funktioniert nur, wenn das Studio es erlaubt. Die Einstellung gilt für Terminabfragen und Buchungen. Geben Sie die Connect-API-Adresse ein und wählen Sie Studios laden. Suchen Sie nach Name oder Ort und wählen Sie ein Studio oder Alle Studios dieses Kontos. IDs werden automatisch übernommen. Der Assistent nutzt wenige gemeinsame Tools für die freigegebenen Studios und bestätigt den Standort vor jeder Abfrage oder Buchung. Eine manuelle ID-Eingabe bleibt möglich.

So läuft die Buchung ab

Zuerst das Studio bestätigen. Der Assistent ruft dessen Pflichtfelder und freie Zeiten ab, erfragt die benötigten Daten und lässt Termin sowie Datenweitergabe vom Anrufer bestätigen. Erst nach erfolgreicher Buchungsantwort bestätigt er den Termin. Eine Werbeeinwilligung wird nicht vorausgesetzt.

Trainer und Verfügbarkeit

Magicline verwaltet die Trainerverfügbarkeit über die Ressourcen Ihres Studios. Eine Buchung mit oder ohne Trainer ist nur nach den Vorgaben des Studios möglich. Ein bestimmter Trainer kann nicht ausgewählt werden. Freie Zeiten sind keine Reservierungen. Ist ein Termin inzwischen belegt, ruft der Assistent neue Zeiten ab und fragt erneut nach.

Bei unklarem Ergebnis

Ein Timeout bedeutet nicht, dass die Buchung fehlgeschlagen ist. Gleichartige parallele und wiederholte Anfragen werden gegen doppelte Übermittlung geschützt. Bei unklarem Ergebnis vor einem weiteren Versuch beim Studio nachprüfen.

Automationen

Verbinden Sie Magicline Connect API unter Automationen → Verbindungen oder importieren Sie die Agent-Tool-Verbindung. Nutzen Sie die Aktionen für Pflichtfelder, freie Zeiten und Buchung. Die Bestätigung des Anrufers muss vor der Buchungsaktion erfolgen. Kursdaten gehören zum separaten Open-API-Connector.

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.
Magicline Open API · Magicline Connect API