API und Webhooks

Umovi-Buchungen in deinem System

Biete die Auswahl von Leistungen und freien Terminen in deinem Portal, CRM oder deiner App an. Über die API speicherst du Buchungen in Umovi, Webhooks informieren dein System über spätere Änderungen.

So funktioniert esAPI-Dokumentation

Beispiel: dein Kundenportal

So gelangt eine Portalbuchung in Umovi

Am Beispiel eines Kundenportals siehst du, wie freie Termine abgefragt, Buchungen gespeichert und Zeitänderungen übernommen werden.

  1. 01

    Dein Portal zeigt freie Termine.

    Dein PortalVerfügbarkeit in Umovi

    Es liest Leistungen, Mitarbeiter und freie Zeiten aus Umovi. Der Kunde wählt einen Termin, der zu Arbeitszeiten, Leistungsdauer und Pausen im Kalender passt.

  2. 02

    Die Buchung erreicht dein Team.

    Auswahl des KundenTeamkalender

    Dein Portal sendet den gewählten Termin und die Kundendaten. Umovi prüft die Verfügbarkeit beim Speichern. Nach erfolgreicher Erstellung steht die Buchung im Kalender; dein Portal erhält ihre ID.

  3. 03

    Änderungen kommen im Portal an.

    Änderung in UmoviAktualisierung im Portal

    Ein Mitarbeiter verschiebt die Buchung in Umovi. Ein Webhook informiert dein System. Es kann die aktuellen Daten abrufen und dem Kunden den neuen Termin anzeigen.

Wann es sich lohnt

Wofür du die Umovi API nutzen kannst

Eigenes Portal oder eigene App

Kunden wählen dort einen Termin, wo sie bereits eine Leistung bestellen oder ihr Konto verwalten.

CRM und Kundenservice

Ein Berater prüft freie Zeiten und bucht einen Termin direkt im System, in dem er das Gespräch führt.

Automatisierung nach der Buchung

Eine neue, verschobene oder stornierte Buchung löst den nächsten Schritt in deinem System aus.

Du möchtest Kunden einfach online buchen lassen? Starte mit deinem Umovi-Profil und einem Buchungslink.

Unternehmenspanel entdecken

Umfang der Umsetzung

Was du für die Integration vorbereiten musst

Die Integration erfordert Entwicklungsarbeit in deinem System. Ein Entwickler erstellt das Formular, die Datenzuordnung und die Verarbeitung von Änderungen. In Umovi richtest du Angebot, Verfügbarkeit und Zugriffsrechte ein.

In Umovi

Du richtest Leistungen, Team, Arbeitszeiten und den Integrationszugang für dein Unternehmen ein.

In deinem System

Dein Entwickler verknüpft Kunden und Buchungen, behandelt belegte Termine und verarbeitet Aktualisierungen aus Umovi.

Für die Entwicklung

So richtest du die API-Verbindung ein

Server-to-Server-REST, OAuth2 Client Credentials und Zugriff für ein einzelnes Unternehmen. Das Integrationsgeheimnis bleibt auf deinem Server.

Operationen und Fälle für die Implementierung
  1. 01

    Token und Katalog abrufen.

    Lege im Unternehmenspanel einen Integrationsclient an, speichere das einmalig angezeigte Geheimnis und fordere ein Token an. Der Katalog liefert Leistungen und Mitarbeiter für die Terminauswahl.

  2. 02

    Verfügbarkeit vor dem Speichern prüfen.

    Behandle Terminkonflikte. Nutze Idempotency-Key für Wiederholungen und übergib deine eigene Datensatz-ID als externalReservationId.

  3. 03

    Änderungen über HTTPS empfangen.

    Prüfe die HMAC-Signatur anhand des unveränderten Bodys. Webhooks können mehrfach und in anderer Reihenfolge eintreffen: dedupliziere Zustellungen und rufe den aktuellen Buchungsstand ab.

REST · /integrations

POST /integrations/oauth/token

grant_type: client_credentials

/integrations/v1/providers/{providerId}
  GET  /catalog
  POST /reservations
  POST /webhooks

Idempotency-Key: <unique-request-key>

booking.created
booking.rescheduled
booking.cancelled_by_client
REST-Dokumentation öffnenAPI-Tester starten

Du möchtest einen Ablauf verbinden?

Sprechen wir über dein System

Erzähl uns, welches System du nutzt und was nach der Terminauswahl passieren soll. Gemeinsam klären wir den Umfang der Anbindung an Umovi.

Integration besprechenDokumentation für dein Entwicklerteam