belbo
  • Übersicht
    • Belbo kennenlernen
    • Standorteinstellungen
    • Wechsel zu Belbo
    • Kalenderansicht & Navigation
    • Serientermine & Kurse
    • Termineingabe & -verwaltung
    • Aufgaben
    • Übersicht
    • Mehrere Standorte & Headoffice
    • Mitarbeiter verwalten
    • Logins
    • Rechte
    • Übersicht
    • Abwesenheiten & Feiertage
    • Arbeitszeiten
    • Arbeitszeiterfassung
    • Übersicht
    • Datenschutz (DSGVO)
    • Kundenkommunikation (E-Mail, SMS)
    • Kundenverwaltung & Kartei
    • Übersicht
    • Bonus- & Treueprogramme
    • Kampagnen (Newsletter & SMS)
    • Marketingfreigaben (DSGVO)
    • Tracking & Auswertung
    • Übersicht
    • Leistungen & Preise
    • Leistungspakete & Abos
    • Gutscheine
    • Produkte
    • Einkauf & Lieferanten
    • Lagerbestand & Inventur
    • Scannen & Verkauf
    • Wareneinsatz & Kosten
    • Übersicht
    • Einrichtung & Einstellungen
    • Design
    • Texte
    • Integration (Website, Google, Instagram, Facebook)
    • Onlinezahlung
    • Übersicht
    • Buchhaltung & Exporte
    • Kasseneinstellungen
    • Kassiervorgang
    • Tagesabschluss & Berichte
    • TSE & Kassensicherungsverordnung
    • Übersicht
    • Exportübersicht
    • Mitarbeiterauslastung
    • Umsatz & Auswertungen
    • Belbo Satellite
    • Drucker
    • EC-Terminal & Kartenzahlung
    • Problembehandlung Hardware
    • Scanner & Kassengeräte
    • Allgemeine Einstellungen
    • API & Integrationen
    • Benachrichtigungen & E-Mails
    • Verträge & Rechtliches
Skip to content
Einstellungen & Administration›API & Integrationen

API-Schnittstellen

Funktion: Allgemein › API-Zugriff › Einstellungen

Sie können Belbo über verschiedene Weisen mit anderen Softwareprodukten koppeln. Neben fertigen Integrationen, die Sie einfach über die Funktionsliste aktivieren können, wie zum Beispiel die Kalendersynchronisierung mit Google, können Sie auch programmatisch Buchungen erzeugen und Daten abfragen.

Wir unterscheiden dabei zwischen zwei Arten von Daten:

Öffentliche Daten

Öffnungszeiten, Leistungen sowie Verfügbarkeiten von Leistungen und Mitarbeitern. Diese Daten können Sie ohne Schlüssel via REST-API abfragen.

Sensible Daten

Kalender- und Kundendaten. Um sie abzufragen, benötigen Sie einen API Schlüssel.

Diesen erstellen Sie in Ihrem Kalender unter den globalen Einstellungen als API Zugang.

REST-API Dokumentation Alle verfügbaren Endpunkte, Parameter und Beispielantworten – laufend gepflegt bei Postman.
Dokumentation öffnen

Nachdem Sie einen API Zugang erstellt haben, können Sie mithilfe des Tokens Abfragen durchführen. Grundsätzlich befinden sich alle Schnittstellen unter der URL mit folgendem Aufbau:

Aufbau der Schnittstellen-URL https://<IhrGeschäft>.belbo.com/office/api/<Name>?token=<Token>

Webhooks

Neben dem aktiven Abfragen von Daten können Sie in der API-Funktion auch Webhooks hinterlegen. Ein Webhook dreht die Richtung um: Ihr System muss nicht regelmäßig nachfragen, ob es etwas Neues gibt – Belbo meldet sich von selbst.

Ereignis tritt ein Zum Beispiel eine neue Buchung in Belbo.
Belbo sendet Ein HTTP-Request geht sofort an Ihre hinterlegte Ziel-URL.
Ihr System reagiert CRM, Warenwirtschaft oder eigene Anwendung verarbeitet die Daten weiter.

Einen Webhook legen Sie direkt in der API-Funktion an. Für die Definition sind drei Angaben nötig:

API Schlüssel

Eine Auswahlbox mit den in Ihrem Kalender angelegten API Zugängen. Der gewählte Schlüssel bestimmt, mit welchen Berechtigungen der Webhook ausgelöst wird.

Interner Name

Eine frei wählbare Bezeichnung, um mehrere Webhooks auseinanderzuhalten. Sie wird nur intern angezeigt.

Absolute URL

Die vollständige Zieladresse inklusive https://, an die Belbo die Ereignisse sendet. Relative Adressen sind nicht möglich.

Dialog zur Definition eines Webhooks mit Auswahlbox für den API Schlüssel, internem Namen und absoluter Ziel-URL
Definition eines Webhooks in der API-Funktion
Die Ziel-URL muss von außen öffentlich erreichbar sein und Anfragen per HTTPS annehmen. Sie können mehrere Webhooks parallel anlegen, etwa je einen pro angebundenem System.

Automatisierungen mit Zapier

Neben der direkten Nutzung der API bietet Belbo auch die Möglichkeit, über eine Zapier-App Events aus Belbo zu nutzen und automatisiert weiterzuverarbeiten. Über Zapier können Sie typische Ereignisse abonnieren und in über 6.000 andere Anwendungen integrieren, um Workflows zu automatisieren.

Diese Ereignisse stehen als Trigger bereit:

  • neue Terminbuchungen
  • Wartelisteneinträge
  • Terminänderungen oder -stornierungen
  • neue Kunden oder Updates an Kundendaten

Damit lassen sich Aktionen in anderen Tools auslösen:

  • Versand von E-Mails oder SMS
  • Eintrag in CRM-Systeme
  • Erstellung von Aufgaben in Projektmanagement-Tools
  • Synchronisation mit Marketing- oder Reporting-Tools

Zapier fungiert dabei als Brücke zwischen Belbo und anderen Systemen und ermöglicht Automatisierungen auch ohne eigene Entwicklung. Technisch basiert dies auf sogenannten Triggern und Aktionen, die über Integrationen oder Webhooks umgesetzt werden können.

Zapier-App für Belbo Einladung zur Belbo-App bei Zapier – dort aktivieren Sie die Events für Ihren eigenen Zapier-Account.
Zapier-App aktivieren
Kategorien: API & Integrationen
Tags: API, Schnittstellen

Hast du eine Frage? Stelle sie hier.

Dieses Handbuch ist ein Service von belbo. Impressum