Hilfe-Center

Anmelden

Plecto

Plecto x ServiceTitan Guide

ServiceTitan-Integrationsleitfaden

Bevor Sie ServiceTitan mit Plecto integrieren können, muss die Anwendung freigeschaltet werden. Dafür wird eine ServiceTitan Tenant ID benötigt.

So finden Sie Ihre Tenant ID in ServiceTitan:

  1. Klicken Sie oben rechts auf das Zahnradsymbol ⚙️.

  2. Gehen Sie im linken Menü zu Integrations > API Application Access. Ihre Tenant ID wird auf der rechten Seite angezeigt.

  3. Kopieren Sie die Nummer und senden Sie sie an Ihren Partner Manager/Plecto Experts.

Damit Sie korrekte Daten in Plecto erhalten, ist es erforderlich, neue Berichte in ServiceTitan zu erstellen.

Beginnen Sie mit der Erstellung von Berichten in ServiceTitan, indem Sie auf den nächsten Schritt klicken.

Berichte in ServiceTitan erstellen

Damit Ihre Daten beim Import nach Plecto korrekt sind, müssen Sie einen neuen Bericht in ServiceTitan erstellen. Das stellt sicher, dass alle Informationen korrekt und aktuell sind.

Sie müssen den folgenden Bericht in ServiceTitan erstellen:

  • ServiceTitan - Plecto - Jobs Report

Gehen Sie bitte zu "Step 1", um neue ServiceTitan-Berichte zu erstellen.

Schritt 1: Neuen Bericht in ServiceTitan erstellen

  1. Gehen Sie in ServiceTitan zu Reports > All Reports > Create Report oder rufen Sie die Seite über diesen Link auf: go.servicetitan.com/#/new/reports/new

  2. Um einen Jobs-Bericht zu erstellen, wählen Sie Jobs (Report type) > Jobs (template).

Schritt 1.1: Auswahl der Spalten

Wählen Sie die empfohlenen Spalten für den Bericht aus und klicken Sie auf Weiter.

Alle empfohlenen Spalten finden Sie unten:

Job Basic:

Job IDJob typeJob CampaignLead Generated By
Job #Job ClassCall CampaignBusiness Unit ID
StatusIs LeadLead Created By
Invoice #Invoice IDJob Campaign ID
ConvertedBooked byCall Campaign ID
Business UnitOpportunityCampaign Category

Job Totals:

Jobs SubtotalJobs Total

Job Dates:

Created DateScheduled DateFirst DispatchStart Of Working TimeSold OnInvoice DateCompletion Date

Appointments:

Total AppointmentNext Appt Start dateLast Appt DateUpcoming Appt Start Date

Customer Information:

Customer IDCustomer NameMember Status

Technician Performance:

Assigned TechnicianSold ByPrimary TechnicianSold By Business Unit

Tags:

TagsCustomer Tags

Summary:

Jobs Total RevenueJobs Gross MarginJobs Gross Margin %

Schritt 1.2: Berichtsdetails

Legen Sie die Berichtsdetails fest:

  1. Geben Sie dem Bericht einen Namen, z. B.:

    • ServiceTitan - Plecto - Jobs Report

  2. Wählen Sie eine Kategorie: Other.

  3. "Share this report for view/edit with other users whose permissions allows them to view/edit this type of report." Wir empfehlen, das Kontrollkästchen deaktiviert zu lassen.

  4. Klicken Sie auf Save, um abzuschließen.

(Optional) Fügen Sie eine Beschreibung hinzu. Hier können Sie erwähnen, dass der Bericht für die Integration mit Plecto gedacht ist.

Schritt 2: Plecto mit ServiceTitan verbinden

Sobald Sie die Bestätigung Ihres Partner Managers/Plecto Experts erhalten haben, können Sie Plecto mit ServiceTitan verbinden:

  1. Klicken Sie in ServiceTitan oben rechts auf das Zahnradsymbol ⚙️.

  2. Gehen Sie zu Integrations > API Application Access > Connect New App > Plecto > Connect.

  3. Klicken Sie auf Allow Access, um Plecto Lesezugriff auf Ihre Daten zu gewähren.

    Stellen Sie sicher, dass in der report_category "no restrictions" konfiguriert ist, damit Sie Ihre ServiceTitan-Berichte nach Plecto importieren können.

  4. Sie sehen nun Ihre

    1. Tenant ID

    2. Client ID und

    3. Client Secret unter Application Details.

    Sie benötigen alle diese Angaben im nächsten Schritt.

  5. Klicken Sie auf Generate, um einen Client Secret-Schlüssel zu erstellen.

  6. Kopieren Sie den Schlüssel.

Mehr über Client ID und Secret erfahren Sie in ServiceTitans Artikel: Manage Client ID & Secret.

Schritt 3: ServiceTitan mit Plecto integrieren

  1. Öffnen Sie Plecto.

  2. Gehen Sie zu Data sources > New data source > ServiceTitan.

  3. Geben Sie Ihre Client ID, Ihr Client Secret und Ihre Tenant ID ein.

  4. Klicken Sie auf Next.

  5. Finden Sie die erstellten Berichte: Reports > Other

  6. Klicken Sie auf Next.

Schritt 3.1: Wählen Sie den Berichtstyp aus

Wählen Sie die Daten aus, die Sie importieren möchten:

  • Raw data: Jede Zeile in Plecto stellt einen einzelnen Datensatz dar, der in einem bestimmten Zeitraum erstellt oder geändert wurde. Jeder Datensatz ist eindeutig und hat ein External ID-Feld (z. B. Job ID, Invoice ID).

  • Aggregated data: Jede Zeile in Plecto liefert eine zusammengefasste Übersicht Ihrer Kennzahlen über einen bestimmten Zeitraum (täglich oder monatlich aggregierbar). Jeder Datensatz repräsentiert eine bestimmte Kennzahl (z. B. Completed Jobs).

Wählen Sie für den zuvor erstellten Jobs-Bericht Raw data aus.

Schritt 3.2: Konfigurieren Sie Ihre Datenquelleneinstellungen

Konfigurieren Sie Ihre Datenquelleneinstellungen:

  • Title: Benennen Sie Ihren Bericht, z. B.:

    • ServiceTitan - Plecto - Jobs Report - Job Start Date

    • ServiceTitan - Plecto - Jobs Report - Job Completion Date

  • Unique identifier: Feld mit einer eindeutigen ID, z. B.:

    • Job #

  • Member Field: Fügen Sie mindestens ein Feld hinzu, das sich auf einen Mitarbeiter bezieht, z. B.:

    • Primary Technician

  • Default date field: Wählen Sie ein Standarddatumsfeld für die Formeln, z. B.:

    • Scheduled Date

    • Completed Date

  • Filter by: Wählen Sie das Datumsfeld, das den spezifischen Daten entspricht, die Sie verfolgen möchten.

    • Job Start Date (Wenn Sie geplante Jobs verfolgen möchten)

    • Job Completion Date (Wenn Sie abgeschlossene Jobs verfolgen möchten)

Wenn Sie sowohl geplante als auch abgeschlossene Jobs verfolgen möchten, müssen Sie denselben Bericht ein zweites Mal importieren. Wählen Sie für diesen zweiten Import eine neue "Filter by"-Option basierend auf den spezifischen Daten, die Sie verfolgen möchten.

Schritt 3.3: Importbereich und Aufbewahrung

Wählen Sie den Importbereich und den Aufbewahrungszeitraum:

  • Import range: Wählen Sie aus, wie viele Daten Sie importieren möchten.

  • Retention period: Wie lange Sie die Daten in Plecto behalten möchten.

Wir empfehlen "For as long as I use Plecto".

Klicken Sie abschließend auf Import.

Verfügbare Daten

Derzeit können Sie folgende Daten aus Ihrem ServiceTitan-Konto in Plecto importieren:

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 24h

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Dieser Datentyp aggregiert alle Zuweisungen für alle Jobs.

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 1h

Supports custom fields? Yes

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No

Supports automatic registration deletion? No

Supports relations? No

Plecto x ServiceTitan Dashboard Package

Installieren Sie die fertigen ServiceTitan-Dashboards von Plecto über den untenstehenden Link.

Plecto x Service Dashboard Package