Plecto x ServiceTitan Guide

ServiceTitan integrationsguide

Innan du kan integrera ServiceTitan med Plecto måste applikationen aktiveras. För att göra det behövs ett ServiceTitan Tenant ID.

Så här hittar du ditt Tenant ID i ServiceTitan:

1. Klicka på kugghjulsikonen ⚙️ i det övre högra hörnet.

2. I menyn till vänster, gå till Integrations > API Application Access. Du kommer att se ditt Tenant ID till höger.

3. Kopiera numret och skicka det till Partner Manager/Plecto Experts.

För att säkerställa att du får rätt data i Plecto är det obligatoriskt att skapa nya rapporter i ServiceTitan.

Börja skapa rapporter från ServiceTitan genom att klicka på nästa steg.

Skapa rapporter i ServiceTitan

För att säkerställa att dina data är korrekta när de importeras till Plecto, måste du skapa en ny rapport i ServiceTitan. Detta kommer att hjälpa till att säkerställa att all information är korrekt och uppdaterad.

Du behöver skapa följande rapport i ServiceTitan:

• ServiceTitan - Plecto - Jobs Report

Vänligen gå till "Steg 1" för att skapa nya ServiceTitan-rapporter.

Steg 1: Skapa ny rapport inom ServiceTitan

1. I ServiceTitan, gå till Reports > All Reports > Create Report eller få tillgång till sidan genom denna länk: go.servicetitan.com/#/new/reports/new

2. För att skapa en Jobs-rapport, välj Jobs (Report type) > Jobs (template).

Steg 1.1: Kolumnval

Välj de rekommenderade kolumnerna att inkludera i rapporten och klicka Nästa.

Hitta alla rekommenderade kolumner nedan:

Job Basic:

Job Totals:

Job Dates:

Appointments:

Customer Information:

Technician Performance:

Tags:

Summary:

Steg 1.2: Rapportdetaljer

Ställ in rapportdetaljerna:

1. Ge rapporten ett namn, t.ex:

   • ServiceTitan - Plecto - Jobs Report

2. Välj en kategori: Other.

3. "Dela denna rapport för visning/redigering med andra användare vars behörigheter tillåter dem att visa/redigera denna typ av rapport." Vi rekommenderar att hålla kryssrutan avstängd.

4. Klicka på Spara för att avsluta.

(Valfritt) Lägg till en beskrivning. Här kan du nämna att rapporten är avsedd för integration med Plecto.

Steg 2: Anslut Plecto till ServiceTitan

När du får bekräftelse från din Partner Manager/Plecto Expert kan du börja ansluta Plecto till ServiceTitan:

1. I ServiceTitan, klicka på kugghjulsikonen ⚙️ i det övre högra hörnet.

2. Gå till Integrations > API Application Access > Connect New App > Plecto > Connect.

3. Klicka på Allow Access för att aktivera Plecto att läsa dina data.

   Se till att konfigurera "inga begränsningar" i report_category för att säkerställa att du kan importera dina ServiceTitan-rapporter till Plecto.

4. Du kommer nu att se ditt

   1. Tenant ID

   2. Client ID och

   3. Client Secret under Application Details.

   Du kommer att behöva använda alla dessa uppgifter i nästa steg.

5. Klicka på Generate för att skapa en Client Secret-nyckel.

6. Kopiera nyckeln.

Läs mer om Client ID och Secret i ServiceTitans artikel: Manage Client ID & Secret.

Steg 3: Integrera ServiceTitan med Plecto

1. Öppna Plecto.

2. Gå till Data sources > New data source > ServiceTitan.

3. Sätt in ditt Client ID, Client Secret och Tenant ID.

4. Klicka på Nästa.

5. Hitta de skapade rapporterna: Reports > Other

6. Klicka på Nästa.

Steg 3.1: Välj typ av din rapport

Välj de data du vill importera:

• Raw data: Varje rad i Plecto kommer att representera en individuell post, skapad eller ändrad under en angiven tidsperiod. Varje registrering är unik och har ett Externt ID-fält (t.ex. Job ID, Invoice ID).

• Aggregated data: Varje rad i Plecto kommer att ge en sammanfattad vy av dina mått över en angiven tidsperiod (kan aggregeras dagligen eller månadsvis). Varje registrering representerar ett specifikt mått (t.ex. Completed Jobs).

För Jobs-rapporten som skapades tidigare - välj Raw data.

Steg 3.2: Konfigurera dina datakällinställningar

Konfigurera dina datakällinställningar:

• Titel: Namnge din rapport, t.ex:

  • ServiceTitan - Plecto - Jobs Report - Job Start Date

  • ServiceTitan - Plecto - Jobs Report - Job Completion Date

• Unik identifierare: Fält som innehåller ett unikt ID, t.ex:

  • Job #

• Medlemsfält: Lägg till minst ett fält som relaterar till en anställd, t.ex:

  • Primary Technician

• Standard datumfält: Välj ett standard datumfält för formlerna, t.ex:

  • Scheduled Date

  • Completed Date

• Filtrera efter: Välj datumfältet som matchar de specifika data du vill spåra.

  • Job Start Date (Om du vill spåra schemalagda jobb)

  • Job Completion Date (Om du vill spåra avslutade jobb)

Om du vill spåra både schemalagda och avslutade jobb, måste du importera samma rapport en andra gång. För denna andra import, välj ett nytt “Filtrera efter”-alternativ baserat på de specifika data du vill spåra.

Steg 3.3: Importintervall och retention

Välj importintervall och retention:

• Importintervall: Välj hur mycket data du vill importera.

• Retention period: Hur länge du vill behålla data i Plecto.

Vi rekommenderar "Så länge jag använder Plecto".

Till sist, klicka på Importera.

Tillgängliga data

För närvarande kan du importera följande data från ditt ServiceTitan-konto till Plecto:

Plecto x ServiceTitan Dashboard-paket

Installera Plectos färdiga ServiceTitan-dashboards i länken nedan.

Plecto x Service Dashboard Package