Vai alla navigazione

ServiceTitan

Trova i clienti, invia nuove prenotazioni a ServiceTitan e comunica ai chiamanti quando è il loro appuntamento.

La tua receptionist può cercare i chiamanti in ServiceTitan, inviare nuovi lavori come prenotazioni affinché i tuoi addetti alle chiamate li esaminino e comunicare ai clienti esistenti quando è il loro prossimo appuntamento. L’API di ServiceTitan scambia un ID client e un segreto con token di breve durata e richiede anche una chiave dell’app, operazioni che gli strumenti webhook non possono eseguire, quindi Reception si collega tramite Zapier.

Prima di iniziare

L’integrazione Zapier di ServiceTitan è in beta aperta e ServiceTitan la fornisce così com’è. Per collegarla:

  1. Un amministratore ServiceTitan invia il modulo di registrazione Zapier di ServiceTitan. ServiceTitan ti contatterà con i passaggi successivi.
  2. In ServiceTitan, vai su Settings → Integrations → API Application Access, seleziona Connect New App e scegli Zapier 3.0.X.
  3. Esamina gli scope, scegli un’opzione Booking Provider e seleziona Allow Access.
  4. Genera un client secret e copialo insieme all’ID client e al tuo ID tenant.

Il client secret consente di accedere ai tuoi dati ServiceTitan. Conservalo in sicurezza e non condividerlo.

Configurazione

1

Collega Zapier

Se non l’hai ancora fatto, collega Zapier in Reception.ai.

2

Aggiungi le azioni ServiceTitan

Nel tuo server MCP Zapier su mcp.zapier.com, aggiungi le azioni seguenti dall’app ServiceTitan (3.0.X). Per collegarti, inserisci il tuo ID tenant, ID client e client secret, quindi scegli l’ambiente di produzione. Per ogni campo, imposta un valore fisso oppure lascia che lo compili l’IA, come indicato.

3

Assegna gli strumenti

In Reception.ai, apri la scheda Tools dell’integrazione Zapier, seleziona Refresh tools e assegna ogni azione al Client (receptionist).

4

Provalo

Testa la tua receptionist simulando un nuovo chiamante che necessita di una riparazione. La prenotazione comparirà in ServiceTitan affinché il tuo team la esamini.

Azioni

Trova il chiamante

CampoValore
Azione ZapierSearch Customers
Imposta in ZapierNulla.
Lascia compilare all’IAPhone (il numero del chiamante) o Name.
Assegna aClient

Invia una prenotazione

Una prenotazione è il modo più sicuro per inviare nuovi lavori. I tuoi addetti alle chiamate la esaminano in ServiceTitan e la trasformano in un lavoro, così la tua receptionist non effettua mai prenotazioni sovrapponendosi al tuo piano di assegnazione.

CampoValore
Azione ZapierCreate Booking
Imposta in ZapierBooking Provider, Source (ad esempio, Reception) e, facoltativamente, Business Unit, Job Type e Campaign.
Lascia compilare all’IAName, Summary (il problema, il numero di telefono del chiamante e quando è disponibile), Is First Time Client, l’indirizzo del servizio, Start (l’orario preferito dal chiamante) e External Id.
Assegna aClient

External Id deve essere univoco per ogni prenotazione. Aggiungi una procedura che indichi alla tua receptionist di usare il numero di telefono del chiamante seguito dalla data e dall’ora correnti.

Controlla gli appuntamenti di un cliente

CampoValore
Azione ZapierSearch Appointments
Imposta in ZapierNulla.
Lascia compilare all’IACustomer Id, da Search Customers.
Assegna aClient

Limitazioni

  • L’app ServiceTitan di Zapier non può verificare la capacità o la disponibilità dei tecnici, quindi l’orario di una prenotazione è la preferenza del chiamante, non uno slot confermato.
  • Create Job e Create Appointment richiedono ID per la sede, l’unità aziendale, il tipo di lavoro e la campagna, e prenotano direttamente nel tuo programma. Lasciali gestire ai tuoi addetti alle chiamate.
  • L’integrazione è in beta aperta e ServiceTitan non la supporta ufficialmente.
  • Ogni azione eseguita dalla tua receptionist usa task del tuo piano Zapier. Attualmente Zapier conta due task per ogni chiamata riuscita; le chiamate non riuscite non vengono conteggiate. Quando il piano si esaurisce, le azioni si fermano fino al ripristino.

Risoluzione dei problemi

ProblemaCosa verificare
Un’azione ServiceTitan non compare in Reception.aiSeleziona Refresh tools nell’integrazione Zapier dopo aver aggiunto azioni in Zapier.
Un’azione mostra Changed e non viene usataL’hai modificata in Zapier. Seleziona Update nella scheda Tools.
Zapier non riesce a collegarsi a ServiceTitanVerifica che la tua registrazione sia stata approvata e di aver usato un ID client e un secret 3.0.X, non una vecchia chiave API.
Errore UniqueConstraint su una prenotazioneExternal Id ripeteva una prenotazione precedente. Assicurati che includa data e ora.
I clienti già noti non vengono trovatiProva il nome del chiamante oltre al suo numero di telefono.