Plecto x ServiceTitan Guide

ServiceTitan integrationsguide

Før du kan integrere ServiceTitan med Plecto, skal applikationen aktiveres. Det kræver et ServiceTitan Tenant ID.

Sådan finder du dit Tenant ID i ServiceTitan:

Klik på tandhjulsikonet ⚙️ i øverste højre hjørne.
I venstre menu, gå til Integrations > API Application Access. Du vil se dit Tenant ID til højre.
Kopiér nummeret og send det til din Partner Manager/Plecto Experts.

For at sikre at du får de korrekte data i Plecto, er det obligatorisk at oprette nye rapporter i ServiceTitan.

Begynd at oprette rapporter fra ServiceTitan ved at klikke på næste trin.

Opret rapporter i ServiceTitan

For at sikre at dine data er korrekte, når de importeres til Plecto, skal du oprette en ny rapport i ServiceTitan. Dette hjælper med at sikre, at alle oplysninger er korrekte og opdaterede.

Du skal oprette følgende rapport i ServiceTitan:

ServiceTitan - Plecto - Jobs Report

Gå venligst til "Step 1" for at oprette nye ServiceTitan-rapporter.

Trin 1: Opret ny rapport i ServiceTitan

I ServiceTitan, gå til Reports > All Reports > Create Report eller tilgå siden via dette link: go.servicetitan.com/#/new/reports/new
For at oprette en Jobs-rapport, vælg Jobs (Report type) > Jobs (template).

Trin 1.1: Valg af kolonner

Vælg de anbefalede kolonner, der skal medtages i rapporten, og klik på Næste.

Find alle de anbefalede kolonner nedenfor:

Job Basic:

Job ID	Job type	Job Campaign	Lead Generated By
Job #	Job Class	Call Campaign	Business Unit ID
Status	Is Lead	Lead Created By
Invoice #	Invoice ID	Job Campaign ID
Converted	Booked by	Call Campaign ID
Business Unit	Opportunity	Campaign Category

Job Totals:

Jobs Subtotal	Jobs Total

Job Dates:

Created Date	Scheduled Date	First Dispatch	Start Of Working Time	Sold On	Invoice Date	Completion Date

Appointments:

Total Appointment	Next Appt Start date	Last Appt Date	Upcoming Appt Start Date

Customer Information:

Customer ID	Customer Name	Member Status

Technician Performance:

Assigned Technician	Sold By	Primary Technician	Sold By Business Unit

Tags:

Tags	Customer Tags

Summary:

Jobs Total Revenue	Jobs Gross Margin	Jobs Gross Margin %

Trin 1.2: Rapportdetaljer

Angiv rapportdetaljer:

Giv rapporten et navn, fx:
- ServiceTitan - Plecto - Jobs Report
Vælg en kategori: Other.
"Share this report for view/edit with other users whose permissions allows them to view/edit this type of report." Vi anbefaler at lade afkrydsningsfeltet være deaktiveret.
Klik Save for at afslutte.

(Valgfrit) Tilføj en beskrivelse. Her kan du nævne, at rapporten er beregnet til integration med Plecto.

Trin 2: Forbind Plecto til ServiceTitan

Når du har fået bekræftelse fra din Partner Manager/Plecto Expert, kan du begynde at forbinde Plecto til ServiceTitan:

I ServiceTitan, klik på tandhjulsikonet ⚙️ i øverste højre hjørne.
Gå til Integrations > API Application Access > Connect New App > Plecto > Connect.
Klik Allow Access for at give Plecto adgang til at læse dine data.

Sørg for at konfigurere "no restrictions" i report_category for at sikre, at du kan importere dine ServiceTitan-rapporter til Plecto.
Du vil nu se dine
1. Tenant ID
2. Client ID og
3. Client Secret under Application Details.
Du skal bruge alle disse oplysninger i næste trin.
Klik Generate for at oprette en Client Secret-nøgle.
Kopiér nøglen.

Læs mere om Client ID og Secret i ServiceTitans artikel: Manage Client ID & Secret.

Trin 3: Integrer ServiceTitan med Plecto

Åbn Plecto.
Gå til Data sources > New data source > ServiceTitan.
Indsæt dit Client ID, Client Secret og Tenant ID.
Klik Next.
Find de oprettede rapporter: Reports > Other
Klik Next.

Trin 3.1: Vælg typen af din rapport

Vælg de data, du vil importere:

Raw data: Hver række i Plecto vil repræsentere en individuel registrering, oprettet eller ændret i en angivet periode. Hver registrering er unik og har et External ID-felt (fx Job ID, Invoice ID).
Aggregated data: Hver række i Plecto vil give et opsummeret overblik over dine målinger i en angivet periode (kan aggregeres dagligt eller månedligt). Hver registrering repræsenterer en specifik metrik (fx Completed Jobs).

For den Jobs-rapport, der blev lavet tidligere - vælg Raw data.

Trin 3.2: Konfigurer indstillinger for din datakilde

Konfigurer indstillingerne for din datakilde:

Title: Navngiv din rapport, fx:
- ServiceTitan - Plecto - Jobs Report - Job Start Date
- ServiceTitan - Plecto - Jobs Report - Job Completion Date
Unique identifier: Felt, der indeholder et unikt ID, fx:
- Job #
Member Field: Tilføj mindst ét felt, der relaterer til en medarbejder, fx:
- Primary Technician
Default date field: Vælg et standard datofelt til formlerne, fx:
- Scheduled Date
- Completed Date
Filter by: Vælg det datofelt, der matcher de specifikke data, du vil følge.
- Job Start Date (Hvis du vil følge planlagte jobs)
- Job Completion Date (Hvis du vil følge fuldførte jobs)

Hvis du vil følge både planlagte og fuldførte jobs, skal du importere den samme rapport en anden gang. For denne anden import, vælg en ny "Filter by"-indstilling baseret på de specifikke data, du vil følge.

Trin 3.3: Importinterval og opbevaring

Vælg importinterval og opbevaringsperiode:

Import range: Vælg hvor meget data du vil importere.
Retention period: Hvor længe du vil beholde dataene i Plecto.

Vi anbefaler "For as long as I use Plecto".

Til sidst, klik Import.

Tilgængelige data

Du kan i øjeblikket importere følgende data fra din ServiceTitan-konto til Plecto:

Update frequency: 2m

Supports custom fields? No

Supports webhooks? No