Alles zum Thema: API & Integrationen

DMS Integration

Die Authentifizierung läuft mittels OAuth2.0 Beaer Token.

Schnittstellen Mapping

Die Suchschnittstelle bei Suche und Detailabfrage folgende Felder je Fahrzeug zurückgeben. Bei der Suche muss mindestens vehicleNo belegt sein, welches bei Belbo als interner Schlüssel zwischen dem DMS und belbo verwendet wird:

Attribut	Typ	Beschreibung
`letterSalutation`	String	Anrede für Briefe, z. B. „Sehr geehrte/r“.
`salutationCode`	String	Code für die Anrede, z. B. „MR“ oder „MRS“.
`customerNo`	String	Eindeutige Kundennummer.
`firstname`	String	Vorname des Kunden.
`lastname`	String	Nachname des Kunden.
`phoneNumber`	String	Telefonnummer des Kunden.
`email`	String	E-Mail-Adresse des Kunden.
`company`	String	Name der Firma, falls vorhanden.
`city`	String	Wohnort oder Stadt des Kunden.
`postalCode`	String	Postleitzahl des Kunden.
`street`	String	Straße und Hausnummer des Kunden.
`lastServiceText`	String	Beschreibung des letzten Serviceereignisses.
`licensePlate`	String	Kennzeichen des Fahrzeugs.
`category`	String	Fahrzeugkategorie, z. B. „PKW“ oder „LKW“.
`mileage`	Integer	Aktueller Kilometerstand des Fahrzeugs.
`nextEmissionCheck`	Date	Datum der nächsten Abgasuntersuchung.
`vehicleMake`	String	Fahrzeugmarke, z. B. „BMW“.
`vehicleModel`	String	Fahrzeugmodell, z. B. „3er“.
`vehicleNo`	String	Nummernschild des Fahrzeugs.
`vin`	String	Fahrzeug-Identifikationsnummer (VIN).
`serialNumber`	String	Seriennummer des Fahrzeugs oder eines zugehörigen Teils.

Tracking-Code

Wenn Sie nachvollziehen möchten, wieviele Ihrer Kunden von einer bestimmten Quelle aus Ihre Onlinebuchung nutzen und Termine buchen, können Sie einen Tracking-Code einbinden, welcher auf der Buchungsbestätigungsseite angezeigt wird.

In diesen Bereich gelangen Sie über Einstellungen > Tracking-Code
Sollte diese Funktion nicht aktiviert sein, kann sie über „Einstellungen > Funktion hinzufügen“ aktiviert werden.

Bitte beachten Sie, dass Sie bei Nutzung des Trackingcodes Ihre Datenschutzbestimmungen um den Zweck des Trackings sowie um Details des genutzten Dienstes erweitern sollten.

Sie erhalten Tracking-Codes beim jeweiligen Dienst, welchen Sie für das Tracking nutzen. Dies können Anbieter wie Facebook oder Google sein, welche Sie für Marketingaktivitäten nutzen.
Sie können mehr als einen Code hinterlegen, wenn Sie mehrere Dienste nutzen möchten.

Analyse des Codes

Beim eingefügten Code handelt es sich um das Produkt eines anderen Softwareherstellers. Bitte beachten Sie, dass wir Sie bei der Analyse des Trackingcodes nicht unterstützen können. Es gibt eine hohe Zahl sich regelmäßig ändernder Codes, die wir nicht für Sie auf Fehler analysieren können.

Sollte Ihr Code also nicht im gewünschten Auswertungstool ankommen, bitten wir Sie, den Support des Codeherstellers zu kontaktieren! Manchmal dauert es auch bis zu 24 Stunden, bis Ereignisse im Dashboard des jeweiligen Auswertungstools zu sehen sind.

Der Code wird zuverlässig auf denjenigen Seiten ausgegeben, welche Sie im Trackingcode-Modul festlegen. Dies können Sie durch die Analyse des Quellcodes selbst überprüfen:

Rufen Sie die gewünschte Seite Ihrer Onlinebuchung auf. Um zum Beispiel die Buchungsbestätigungsseite aufzurufen, buchen Sie also selbst einen Termin in Ihrem Unternehmen.
Auf der Seite könne Sie in den meisten gängigen Browsern rechts klicken und sich den Seitenquelltext anzeigen lassen.
Suchen Sie auf der sich öffnenden Seite nach im Code vorkommenden Begriffen.

API-Schnittstellen

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 hier zwischen öffentlich sichtbaren Daten, wie Öffnungszeiten, Leistungen, sowie Verfügbarkeiten von Leistungen und Mitarbeitern und sensiblen Daten wie Kalender- und Kundendaten. Öffentlich zugängliche Daten können Sie via REST-API bei Belbo abfragen. Eine Dokumentation der existierenden Schnittstellen finden Sie hier: Belbo REST-API bei Postman.

Um sensible Daten abzufragen benötigen Sie einen API Schlüssel.

In diesen Bereich gelangen Sie über Einstellungen > API-Zugriff
Sollte diese Funktion nicht aktiviert sein, kann sie über „Einstellungen > Funktion hinzufügen“ aktiviert werden.

Nachdem Sie in Ihrem Kalender unter den globalen Einstellungen 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:

https://<IhrGeschäft>.belbo.com/office/api/<Name>?token=<Token>

🔌 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 (Events) aus Belbo abonnieren und in über 6.000 andere Anwendungen integrieren, um Workflows zu automatisieren.

Dazu zählen beispielsweise:

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

Diese Events können als Trigger in Zapier verwendet werden, um automatisch Aktionen in anderen Tools auszulösen, z. B.:

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.

Hier kann die Zapier Event in Ihrem Zapier Account aktiviert werden: Zapier – Belbo App