Nach Abschluss dieses Vorgangs sendet jeder als "abgeschlossen" markierte Auftrag in ServiceTitan automatisch eine Bewertungsanfrage an den Kunden. Die eingehenden Bewertungen werden dem Techniker zugeordnet, der den Auftrag erledigt hat.

Das Setup erfolgt über drei Plattformen, in dieser Reihenfolge:

Am Ende haben Sie vier Zugangsdaten, von denen drei benötigt werden. Halten Sie also ein Notizbuch bereit, während Sie die Einrichtung durchlaufen.

Du benötigst zwei aktivierte ServiceTitan-Rechte für deinen Benutzer. Ein Administrator in deinem Team muss sie aktivieren:

Ohne diese beiden Berechtigungen lässt dich das Entwicklerportal nicht herein. Das ist eine Vorgabe von ServiceTitan, nicht von uns.

Zusätzlich benötigst du ein Reviewflowz-Konto mit einem Plan, der Integration sowie Technikerzuordnung ermöglicht. Falls du SMS anstelle von E-Mails senden möchtest, sind auch SMS-Credits erforderlich. Das Setup kann vollständig abgeschlossen werden, bevor du die Abrechnung hinzufügst. Nichts wird gesendet, bevor du die Kampagne aktivierst.

Die Tenant-ID identifiziert dein ServiceTitan-Konto. Wenn du mehr als ein Unternehmen bei ServiceTitan führst, hat jedes seine eigene ID und benötigt eine separate Einrichtung.

Lass diesen Tab geöffnet. Du wirst in Teil 3 zurückkehren und dort unter Erlaubter "Tenant"-Wert dieselbe Nummer sehen, was sicherstellt, dass du den richtigen Wert kopiert hast.

Dieser Abschnitt verwirrt manche Benutzer, daher lies alles sorgfältig, bevor du etwas klickst.

Gehe zu developer.servicetitan.io und logge dich ein. Auf der Anmeldeseite gibt es vier Schaltflächen in zwei Spalten. Du wählst die rechte Spalte, ServiceTitan-Kunden, und klickst auf die Schaltfläche Einloggen als Nutzer der Produktionsumgebung. Die Sandbox-Buttons der Integrationsumgebung können deine echten Jobs nicht sehen.

Melde dich mit deinen ServiceTitan-Zugangsdaten an. Enterprise Hub- und Partnerportal-Logins funktionieren nicht, du benötigst das Benutzerlogin von ServiceTitan.

Unter Meine Apps klickst du auf Neue App registrieren. Antworte auf die Frage, die ServiceTitan stellt, und du gelangst zum Anmeldeformular. Die Entwicklerdetails oben beschreiben die Software, mit der die App kommuniziert – das sind wir. Fülle die Felder wie folgt aus:

Das Website-Feld benötigt das vollständige https:// davor. www.reviewflowz.com alleine eingeben führt zur Ablehnung des Formulars.

App-Details unten beziehen sich auf die App selbst. Benenne sie so, dass du sie später wiedererkennst, z.B. Reviewflowz. Die Beschreibung, die Frage zur Erstellung und Wartung sowie die Kategorie verändern nicht die Funktion der App, also fülle sie einfach aus. Klicke auf Generieren beim External Data Application GUID.

Weiter unten im Formular befindet sich der Abschnitt Tenant-APIs. Füge die in Teil 1 kopierte Tenant-ID hinzu und klicke auf API-Bereiche hinzufügen.

Wähle diese fünf Bereiche:

Lesezugriff reicht aus. Reviewflowz schreibt nie Daten zurück zu ServiceTitan. Jeder der fünf hat eine bestimmte Rolle, und wenn einer fehlt, wird ein Feature leise entfernt:

Das erste angeschlossene Unternehmen wurde ohne den Standort-Bereich genehmigt, und es kostete sie jeden Kontakt am ersten Tag. Stelle sicher, alle fünf auszuwählen.

Speichere die App ab. Gehe zurück zu Meine Apps. Jede Zeile hat drei Symbole unter Aktionen. Der Bleistift bearbeitet die App, dort befindet sich der App-Schlüssel. Kopiere ihn. Das ist die zweite Anmeldung.

Der App-Schlüssel identifiziert die App, nicht dein Konto. Er ändert sich nicht, wenn du Mandanten hinzufügst, und bleibt in Integrations- und Produktionsumgebungen gleich.

Die Client-ID und das Client-Secret existieren noch nicht. Sie werden erst erstellt, nachdem dein ServiceTitan-Konto der App Zugriff gewährt hat, daher muss dieser Schritt nach Teil 2 durchgeführt werden.

In ServiceTitan gehe zu Einstellungen. Suche Integrationen und öffne API-Anwendungszugang. Hier hast du in Teil 1 deine Tenant-ID gefunden. Es listet auch jede App auf, die bereits Zugriff auf deine Daten hat.

Klicke auf Neue App verbinden. Deine App sollte in der Liste sichtbar sein. Wenn nicht, fehlt die Tenant-ID in der App – gehe zurück und füge sie hinzu.

Wähle die App aus und klicke auf Verbinden. ServiceTitan zeigt die angeforderten Bereiche an, die App erhält dann ihre eigene Detailseite. Diese Seite lohnt sich anzusehen. Der Erlaubte "Tenant"-Wert zeigt deine Tenant-ID und hat eine Kopiertaste rechts daneben – perfekt, um deine Eingabe aus Teil 1 zu verifizieren. Darunter listet Hat Zugriff auf auf, worauf die App zugreifen kann.

Gehe zurück zum Entwicklerportal und wähle Meine Apps. Klicke auf das mittlere Symbol in der App-Reihe, das wie ein Kettenglied aussieht. Diese sind die App-Verbindungen, und sie sind nicht beschriftet.

Die App-Verbindungen zeigen eine Zeile pro Tenant an, der mit deiner App verbunden ist. Die Zeile enthält die Tenant/Network-ID, die Client-ID und eine Generieren-Schaltfläche für das Client-Secret.

Kopiere die Client-ID. Klicke auf Generieren und kopiere das Geheimnis sofort, da es nur einmal angezeigt wird. Behandle es wie ein Passwort: Füge es in Reviewflowz ein und nirgends sonst. Wir speichern es verschlüsselt und zeigen es dir nie wieder an.

Wir überprüfen die Zugangsdaten, dann prüfen wir die Tenant-ID separat. So zeigt die Fehlermeldung an, welcher der beiden falsch ist:

Wenn es funktioniert, wird die Karte grün und zeigt an, wie viele Jobs du in den letzten 30 Tagen erledigt hast. Diese Anzahl beweist, dass wir tatsächlich deine Daten lesen können.

Wir importieren dann deine Historie der abgeschlossenen Jobs. Diese früheren Jobs füllen direkt dein Techniker-Leaderboard aus, und keiner von ihnen erhält eine Bewertungsanfrage. Nur Jobs, die nach der Verbindung abgeschlossen werden, werden kontaktiert.

Überspringe diesen Abschnitt, wenn du nur einen Standort verwaltest.

Im ServiceTitan-Bedienfeld unter Standorte wähle, wie wir entscheiden, welcher deiner Standorte den Auftrag erledigt hat:

Lege zudem Zurückgreifen fest. Das ist der Standort, den wir verwenden, wenn die Geschäftseinheit nicht verknüpft ist und die Adresse den Kunden nicht in die Nähe eines Standorts bringt.

Wenn die Geschäftseinheitenliste leer ist, schließe einen Job in ServiceTitan ab und klicke auf Liste aktualisieren.

Die Verbindung erstellt eine Entwurfskampagne namens ServiceTitan-Bewertungsanfragen. Sie sendet nicht, bis du sie aktivierst.

Ab dann läuft alles automatisch. Ein abgeschlossener Job wird zu einem Kontakt in Anfragen, und die Anfrage wird nach deiner Verzögerung gesendet.

Wir überprüfen alle 15 Minuten ServiceTitan auf abgeschlossene Jobs. ServiceTitan bietet keine Webhooks für neue Apps, daher gibt es nichts, was uns das Ereignis direkt übermittelt. Polling ist aktuell der von ServiceTitan empfohlene Ansatz. Erwarte eine Anfrage innerhalb von etwa 15 Minuten nach Jobabschluss zuzüglich der von dir festgelegten Verzögerung.

Nur der Status Abgeschlossen löst eine Anfrage aus. Geplant, Dispatched, In Bearbeitung, Wartend und Storniert nicht.

Die App fehlt beim "Neue App verbinden". Deine Tenant-ID fehlt in der App. Gehe zum Entwicklerportal, auf "Meine Apps", bearbeite die App im Abschnitt Mandanten.

Alles verbunden, aber keine Anfragen werden gesendet. Prüfe drei Dinge: Die Kampagne ist aktiv und nicht im Entwurf. Der Jobstatus in ServiceTitan ist "Abgeschlossen". Der Job wurde nach der Verbindung abgeschlossen. Nur Jobs, die nach der Verbindung abgeschlossen wurden, werden kontaktiert. Vorher abgeschlossene Jobs werden nur für Berichte importiert.

Niederlassungen werden als Nummern angezeigt. Der Bereich Geschäftseinheiten fehlt in deiner App. Füge ihn im Entwicklerportal hinzu, dann drücke auf der Standortkarte auf Liste aktualisieren.

Bewertungen werden nicht Technikern gutgeschrieben. Der Bereich Terminzuweisungen fehlt. Ein Job mit mehreren Technikern schreibt jedem von ihnen gut, aber falls es fehlt, liegt das Problem bei der Zuweisung in ServiceTitan, nicht bei den Bereichen.

Du hast das Client-Secret erneuert. Das erneuern macht das alte Secret ungültig. Kopiere das neue Geheimnis in Reviewflowz, sonst stoppt die Synchronisation.