Dopo aver completato questo passaggio, ogni lavoro che contrassegni come Completato in ServiceTitan invia automaticamente una richiesta di recensione al cliente, e la recensione ricevuta viene attribuita al tecnico che ha svolto il lavoro.

La procedura di configurazione si svolge su tre piattaforme, seguendo quest'ordine:

Alla fine ottieni quattro credenziali, di cui tre sono indispensabili. Tieni aperto un blocco note mentre procedi.

Ti serviranno due permessi di ServiceTitan attivi sul tuo profilo. Un amministratore del tuo team deve abilitarli:

Senza questi permessi, non potrai accedere al portale sviluppatori. Questo è un requisito di ServiceTitan, non nostro.

Avrai anche bisogno di un account ReviewFlowz con un piano che comprenda l'integrazione e l'attribuzione tecnica, più dei crediti SMS extra se vuoi inviare messaggi anziché email. Puoi configurare tutto qui di seguito e aggiungere i dettagli di fatturazione alla fine. Nulla verrà inviato finché non attivi la campagna.

Il Tenant ID identifica il tuo account ServiceTitan. Se gestisci più aziende, ognuna avrà il proprio ID e richiederà una configurazione separata.

Tieni aperta questa scheda, tornerai qui nella Parte 3, e vedrai lo stesso numero sotto l'etichetta Valore "tenant" consentito, come conferma che hai copiato il numero giusto.

Questa è la parte che spesso crea confusione, quindi leggi bene tutta la sezione prima di procedere.

Vai su developer.servicetitan.io e accedi. La schermata di accesso offre quattro pulsanti in due colonne. Devi scegliere la colonna di destra, Clienti ServiceTitan, e cliccare su Accedi come utente dell'ambiente di produzione. Gli altri pulsanti portano ad un ambiente di test che non vede i tuoi lavori reali.

Accedi con le tue credenziali ServiceTitan. Gli accessi di Enterprise Hub e Partner Portal qui non funzionano, serve l’utente di ServiceTitan.

In Le mie App, clicca su Registra nuova app, rispondi alla domanda iniziale di ServiceTitan, e arriverai al modulo di registrazione. I Dettagli Sviluppatore nella parte superiore descrivono il software con cui comunichiamo, ossia noi, quindi compila come segue:

Il campo del sito web richiede il https:// completo. Se incolli solo www.reviewflowz.com, il modulo lo rifiuterà.

Dettagli App, invece, riguarda l'applicazione stessa. Dai un nome che riconoscerai, ad esempio ReviewFlowz. Descrizione, costruttore e mantenitore, e categoria non influenzano ciò che l'app può fare, quindi compila come meglio credi. Clicca su Genera per ottenere il GUID dell'applicazione Dati Esterni.

Scorrendo più in basso nello stesso modulo troverai API Tenant. Aggiungi il Tenant ID che hai copiato nella Parte 1, poi clicca su Aggiungi ambiti API.

Seleziona questi cinque ambiti:

L'accesso in lettura è sufficiente. ReviewFlowz non altera mai i dati su ServiceTitan. Ciascuno di questi ambiti permette una funzione specifica, e l'assenza di uno non interrompe la connessione ma semplifica le funzionalità:

La prima azienda che abbiamo collegato è stata approvata senza l'ambito Sedi, e ciò ha portato alla perdita di tutti i contatti il primo giorno. Seleziona tutti i cinque ambiti.

Salva l'applicazione. Tornato in Le mie App, ogni riga ha tre icone sotto Azioni. La matita apre l'app per la modifica, ed è lì che troverai la Chiave dell'applicazione. Copiala. È la seconda credenziale.

La Chiave dell'applicazione identifica l'app, non il tuo account. Non cambia quando aggiungi tenant, ed è identica negli ambienti di test e di produzione.

Il Client ID e il Client Secret ancora non esistono. Vengono creati solo quando il tuo account ServiceTitan concede l'accesso all'applicazione, quindi questo passaggio deve avvenire dopo la Parte 2 e non prima.

In ServiceTitan, vai su Impostazioni, cerca Integrazioni e apri Accesso Applicazione API. È la stessa pagina da cui hai preso il tuo Tenant ID nella Parte 1, e mostra ogni app con accesso ai tuoi dati.

Clicca su Collega Nuova App. La tua app apparirà nell'elenco. Se l'elenco è vuoto, l'app non ha il tuo Tenant ID, quindi torna indietro e aggiungilo.

Selezionala e clicca su Connetti. ServiceTitan ti mostrerà gli ambiti richiesti dall'app, e tu li devi approvare. L'app riceve quindi la sua pagina di dettaglio, che vale la pena visionare. Il Valore "tenant" consentito in essa è il tuo Tenant ID, con un pulsante Copia accanto, quindi possiamo verificarne la correttezza. Inoltre, Ha Accesso A elenca ciò a cui l'app può accedere.

Ritorna al portale sviluppatori su Le mie App. Nella riga dell'app, clicca sull'icona a catena. È Connessioni App, anche se non segnalato.

Connessioni App elenca una riga per ciascun tenant che si è collegato all'app. La riga contiene l'ID Tenant/Rete, l'ID client, e un pulsante Genera per il Client Secret.

Copia l'ID Client. Clicca su Genera per il Client Secret e copialo immediatamente, dato che viene mostrato una volta sola. Trattalo come una password: incollalo su ReviewFlowz e da nessun'altra parte. Lo memorizziamo in modo sicuro e non lo mostriamo mai indietro.

Verifichiamo le credenziali e, separatamente, il Tenant ID per identificare correttamente eventuali errori:

Quando tutto funziona correttamente, la scheda si colora di verde e mostra quanti lavori hai completato negli ultimi 30 giorni. Questo conteggio dimostra che possiamo accedere ai tuoi dati.

Importiamo quindi la cronologia dei tuoi lavori completati. Questi lavori passati popolano immediatamente la tua classifica per tecnici, e non ricevono una richiesta di recensione. Solo i lavori completati dopo il collegamento vengono contattati.

Salta questo passaggio se gestisci una sola sede.

Nel pannello impostazioni di ServiceTitan, sotto Sedi, scegli come stabilire a quale delle tue sedi appartengono i lavori:

Imposta Ricorri a. È la sede che usiamo quando l'unità operativa non è collegata e l'indirizzo non posiziona il cliente vicino a niente.

Se l'elenco delle unità operative è vuoto, completa un lavoro in ServiceTitan e premi Aggiorna elenco.

La connessione crea una bozza di campagna chiamata Richieste di recensioni ServiceTitan. Non invia nulla finché non la attivi.

Da quel momento funzionerà in modo autonomo. Un lavoro completato diventa un contatto in Richieste, e la richiesta viene inviata secondo il tuo ritardo impostato.

Controlliamo ServiceTitan per i lavori completati ogni 15 minuti. ServiceTitan non offre webhook per nuove app, quindi facciamo polling come raccomandato da loro. Aspettati la richiesta entro circa 15 minuti dalla chiusura del lavoro, più il ritardo che hai impostato.

Solo lo stato Completato innesca una richiesta. Stati come Pianificato, Inviato, In corso, In attesa o Annullato non lo fanno.

L'app non compare sotto Connetti Nuova App. Il tuo Tenant ID non è impostato nell'app. Vai su Portale sviluppatori, Le mie App, modifica l'applicazione, e verifica la sezione Tenant(i).

Tutto è connesso ma le richieste non vengono inviate. Verifica tre cose: che la campagna sia attiva e non in versione bozza, che lo stato del lavoro su ServiceTitan sia Completato, e che il lavoro sia stato completato dopo che hai collegato l'app. I lavori completati prima della connessione vengono importati solo per la reportistica e non ricevono mai messaggi.

Le filiali appaiono come numeri. L'ambito delle Unità operative manca nella tua app. Aggiungilo nel portale sviluppatori, poi premi Aggiorna elenco nella scheda Sedi.

Le recensioni non vengono attribuite ai tecnici. L'ambito Assegnazioni Appuntamenti manca. Se un lavoro con diversi tecnici non ne accredita uno, è l'assegnazione su ServiceTitan a essere incompleta, non l'ambito mancante.

Hai rigenerato il Client Secret. La rigenerazione invalida il vecchio. Incolla il nuovo secreto su ReviewFlowz per ripristinare la sincronizzazione.