Zum Hauptinhalt springen
Dein Assistent prüft Leistungen, Mitarbeiter und freie Zeiten in deinem SimplyBook.me-Konto und bucht Termine, nachdem der Anrufer zugestimmt hat.

Konto verbinden

  1. Öffne in SimplyBook.me Custom Features → API und kopiere den REST API Endpoint deiner Region, zum Beispiel https://user-api-v2.simplybook.it. Lege auf der Seite für API-User-Keys einen API User Key für einen Mitarbeiter-Benutzer an.
  2. Nutze einen eigenen Mitarbeiter-Benutzer mit nur den Rechten, die der Assistent braucht. Der Assistent darf alles, was dieser Benutzer darf.
  3. Öffne Agent Tools → Marketplace → SimplyBook.me. Wähle den Endpoint und gib dein Company Login (der Teil vor .simplybook.me), das Login des Mitarbeiter-Benutzers und den API User Key ein. Verwende einen API User Key, kein Passwort: Passwörter erfordern eine Zwei-Faktor-Anmeldung und funktionieren für Automatisierung nicht.
  4. Wähle Hinzufügen. Die Anmeldung wird geprüft, bevor die Verbindung gespeichert wird. Weise die Verbindung danach deinem Assistenten zu.
Mit dem ersten API User Key schaltet SimplyBook.me für Passwort-Logins von Mitarbeitern in deinem Konto die E-Mail-Bestätigung der IP-Adresse ein. Andere Integrationen, die sich mit Passwort anmelden, brauchen dann ebenfalls einen Key.
Um Endpoint, Mitarbeiter-Login oder Key später zu ändern, entferne das Tool und verbinde es erneut.

Das kann der Assistent

Standardmäßig aktiv:
  • Firmeninformationen, Leistungen und Mitarbeiter (Kontaktdaten von Mitarbeitern werden nie weitergegeben).
  • Freie Zeiten für eine Leistung, mit oder ohne gewählten Mitarbeiter, und den nächsten freien Termin.
  • Die Angaben, die eine Leistung vor der Buchung verlangt.
  • Einen Termin buchen.
Optional unter Bearbeiten:
  • Einen Kunden anhand der E-Mail-Adresse finden und seine kommenden Termine nennen. Wer die E-Mail-Adresse kennt, kann diese Zeiten hören. Aktiviere das nur, wenn das für dein Unternehmen akzeptabel ist.
  • Eine Buchung nachschlagen und Buchungen eines Zeitraums auflisten, inklusive Kontaktdaten der Kunden. Nutze das für Automationen und interne Assistenten, nicht für Assistenten, die mit Anrufern sprechen.
  • Einen Termin stornieren.

So läuft die Buchung ab

Der Assistent ruft zuerst ab, welche Angaben die Leistung verlangt, danach die freien Zeiten. Er nennt nur Zeiten, die SimplyBook.me zurückgegeben hat, in der Zeitzone deines Unternehmens. Er erfragt Name, E-Mail-Adresse und weitere Pflichtangaben, wiederholt Leistung, Mitarbeiter, Datum und Uhrzeit und bucht erst, wenn der Anrufer Ja sagt. Erst nachdem SimplyBook.me die Buchung bestätigt hat, meldet er Erfolg. Braucht die Leistung eine Freigabe, sagt der Assistent, dass das Unternehmen den Termin noch bestätigt. SimplyBook.me sendet deinen Kunden die üblichen Bestätigungen. Freie Zeiten sind keine Reservierung: Ist ein Termin inzwischen belegt, ruft der Assistent neue Zeiten ab und fragt erneut.

Bei unklarem Ergebnis

Ein Timeout bedeutet nicht, dass die Buchung fehlgeschlagen ist. Wiederholte oder parallele Anfragen sind gegen Doppelbuchungen geschützt. Meldet der Assistent ein unklares Ergebnis, prüfe in SimplyBook.me nach, bevor erneut gebucht wird.

Stornieren

Die Stornierung ist standardmäßig aus. Der Anrufer nennt den Buchungscode aus der Bestätigungs-E-Mail und die E-Mail-Adresse der Buchung; beides muss übereinstimmen. Um einen Termin zu verschieben, bucht der Assistent die neue Zeit und storniert danach den alten Termin, jeweils nach Bestätigung des Anrufers. Verschieben in einem Schritt gibt es noch nicht.

Sicher testen

Ein Test-Chat oder ein Sprachtest bucht wirklich und löst echte Benachrichtigungen aus. Teste mit einer Test-Leistung und storniere die Buchung danach. Textsimulationen rufen SimplyBook.me nicht auf.

Kanäle

Am Telefon und im Web-Chat sieht der Assistent die vollständige Buchungsanleitung. In WhatsApp, Messenger und E-Mail braucht er unter Umständen eine zusätzliche Nachricht, bis die Buchungsangaben stimmen.

Automationen

Verbinde SimplyBook.me unter Automationen → Verbindungen oder importiere die Agent-Tool-Verbindung. Jedes Tool steht als Aktion bereit. Eine Buchungsaktion braucht die Verfügbarkeitsreferenz aus einem vorherigen Schritt für freie Zeiten und die Bestätigung des Kunden, die erst gesetzt wird, wenn der Kunde wirklich zugestimmt hat. Auslöser für neue, geänderte oder stornierte Buchungen gibt es noch nicht.

API, MCP, CLI & SDK

POST /api/v1/tools/simplybook · MCP connect_simplybook · CLI famulor connect-simplybook. client.api.connectSimplybook braucht famulor-sdk 0.2.11 oder neuer. Aktualisiere die CLI mit npm install --global famulor, bevor du connect-simplybook verwendest.
SimplyBook.me REST API