Centro de ayuda

Iniciar sesión

Plecto

Plecto x ServiceTitan Guide

Guía de integración de ServiceTitan

Antes de poder integrar ServiceTitan con Plecto, es necesario habilitar la aplicación. Para ello se necesita un ServiceTitan Tenant ID.

Así encontrará su Tenant ID en ServiceTitan:

  1. Haga clic en el icono de engranaje ⚙️ en la esquina superior derecha.

  2. En el menú de la izquierda, vaya a Integrations > API Application Access. Verá su Tenant ID a la derecha.

  3. Copie el número y envíelo a su Partner Manager/Plecto Experts.

Para asegurarse de obtener los datos correctos en Plecto, es obligatorio crear nuevos informes en ServiceTitan.

Empiece a crear informes desde ServiceTitan haciendo clic en el siguiente paso.

Crear informes en ServiceTitan

Para garantizar que sus datos sean precisos al importarlos a Plecto, deberá crear un nuevo informe en ServiceTitan. Esto ayudará a asegurar que toda la información sea correcta y esté actualizada.

Debe crear el siguiente informe en ServiceTitan:

  • ServiceTitan - Plecto - Jobs Report

Vaya a "Step 1" para crear nuevos informes de ServiceTitan.

Paso 1: Crear un nuevo informe en ServiceTitan

  1. En ServiceTitan, vaya a Reports > All Reports > Create Report o acceda a la página a través de este enlace: go.servicetitan.com/#/new/reports/new

  2. Para crear un informe de Jobs, elija Jobs (Report type) > Jobs (template).

Paso 1.1: Selección de columnas

Seleccione las columnas recomendadas para incluir en el informe y haga clic en Siguiente.

Encuentre todas las columnas recomendadas a continuación:

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 %

Paso 1.2: Detalles del informe

Configure los detalles del informe:

  1. Dé un nombre al informe, por ejemplo:

    • ServiceTitan - Plecto - Jobs Report

  2. Seleccione una categoría: Other.

  3. "Share this report for view/edit with other users whose permissions allows them to view/edit this type of report." Recomendamos mantener la casilla desactivada.

  4. Haga clic en Save para finalizar.

(Opcional) Añada una descripción. Aquí puede mencionar que el informe está destinado a la integración con Plecto.

Paso 2: Conectar Plecto con ServiceTitan

Una vez que reciba la confirmación de su Partner Manager/Plecto Expert, puede empezar a conectar Plecto con ServiceTitan:

  1. En ServiceTitan, haga clic en el icono de engranaje ⚙️ en la esquina superior derecha.

  2. Vaya a Integrations > API Application Access > Connect New App > Plecto > Connect.

  3. Haga clic en Allow Access para permitir que Plecto lea sus datos.

    Asegúrese de configurar "no restrictions" en report_category para poder importar sus informes de ServiceTitan a Plecto.

  4. Ahora verá su

    1. Tenant ID

    2. Client ID y

    3. Client Secret en Application Details.

    Necesitará usar todas estas credenciales en el siguiente paso.

  5. Haga clic en Generate para crear una clave Client Secret.

  6. Copie la clave.

Lea más sobre el Client ID y Secret en el artículo de ServiceTitan: Manage Client ID & Secret.

Paso 3: Integrar ServiceTitan con Plecto

  1. Abra Plecto.

  2. Vaya a Data sources > New data source > ServiceTitan.

  3. Inserte su Client ID, Client Secret y Tenant ID.

  4. Haga clic en Next.

  5. Encuentre los informes creados: Reports > Other

  6. Haga clic en Next.

Paso 3.1: Seleccione el tipo de informe

Seleccione los datos que desea importar:

  • Raw data: Cada fila en Plecto representará un registro individual, creado o modificado durante un período de tiempo especificado. Cada registro es único y tiene un campo External ID (por ejemplo, Job ID, Invoice ID).

  • Aggregated data: Cada fila en Plecto proporcionará una vista resumida de sus métricas durante un período de tiempo específico (puede agregarse diaria o mensualmente). Cada registro representa una métrica específica (por ejemplo, Completed Jobs).

Para el informe de Jobs creado anteriormente, seleccione Raw data.

Paso 3.2: Configure los ajustes de su fuente de datos

Configure los ajustes de su fuente de datos:

  • Title: Asigne un nombre a su informe, por ejemplo:

    • ServiceTitan - Plecto - Jobs Report - Job Start Date

    • ServiceTitan - Plecto - Jobs Report - Job Completion Date

  • Unique identifier: Campo que contiene un ID único, por ejemplo:

    • Job #

  • Member Field: Añada al menos un campo relacionado con un empleado, por ejemplo:

    • Primary Technician

  • Default date field: Elija un campo de fecha predeterminado para las fórmulas, por ejemplo:

    • Scheduled Date

    • Completed Date

  • Filter by: Elija el campo de fecha que coincida con los datos específicos que desea seguir.

    • Job Start Date (Si desea seguir los trabajos programados)

    • Job Completion Date (Si desea seguir los trabajos completados)

Si desea seguir tanto los trabajos programados como los completados, deberá importar el mismo informe una segunda vez. Para esta segunda importación, elija una nueva opción de "Filter by" basada en los datos específicos que desea seguir.

Paso 3.3: Rango de importación y retención

Elija el rango de importación y el período de retención:

  • Import range: Seleccione cuántos datos desea importar.

  • Retention period: Cuánto tiempo desea conservar los datos en Plecto.

Recomendamos "For as long as I use Plecto".

Por último, haga clic en Import.

Datos disponibles

Actualmente, puede importar los siguientes datos desde su cuenta de ServiceTitan a Plecto:

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

Este tipo de datos agrega todas las asignaciones de todos los trabajos.

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

Instale los dashboards de ServiceTitan ya preparados por Plecto a través del siguiente enlace.

Plecto x Service Dashboard Package