> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # ServiceTitan 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](/docs/it/reception-ai/integrations/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. > **Warning** > > Il client secret consente di accedere ai tuoi dati ServiceTitan. Conservalo in sicurezza e non condividerlo. ## Configurazione ### Collega Zapier Se non l'hai ancora fatto, collega [Zapier](/docs/it/reception-ai/integrations/zapier) in Reception.ai. ### Aggiungi le azioni ServiceTitan Nel tuo server MCP Zapier su [mcp.zapier.com](https://mcp.zapier.com), aggiungi le [azioni seguenti](#actions) 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. ### Assegna gli strumenti In Reception.ai, apri la scheda **Tools** dell'integrazione Zapier, seleziona **Refresh tools** e assegna ogni azione al **Client** (receptionist). ### Provalo [Testa la tua receptionist](/docs/it/reception-ai/receptionist/testing) simulando un nuovo chiamante che necessita di una riparazione. La prenotazione comparirà in ServiceTitan affinché il tuo team la esamini. ## Azioni ### Trova il chiamante | Campo | Valore | | --------------------------- | ----------------------------------------------- | | **Azione Zapier** | **Search Customers** | | **Imposta in Zapier** | Nulla. | | **Lascia compilare all'IA** | **Phone** (il numero del chiamante) o **Name**. | | **Assegna a** | **Client** | ### 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. | Campo | Valore | | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Azione Zapier** | **Create Booking** | | **Imposta in Zapier** | **Booking Provider**, **Source** (ad esempio, `Reception`) e, facoltativamente, **Business Unit**, **Job Type** e **Campaign**. | | **Lascia compilare all'IA** | **Name**, **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 a** | **Client** | **External Id** deve essere univoco per ogni prenotazione. Aggiungi una [procedura](/docs/it/reception-ai/receptionist/rules-and-procedures) 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 | Campo | Valore | | --------------------------- | ----------------------------------------- | | **Azione Zapier** | **Search Appointments** | | **Imposta in Zapier** | Nulla. | | **Lascia compilare all'IA** | **Customer Id**, da **Search Customers**. | | **Assegna a** | **Client** | ## 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 | Problema | Cosa verificare | | -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | Un'azione ServiceTitan non compare in Reception.ai | Seleziona **Refresh tools** nell'integrazione Zapier dopo aver aggiunto azioni in Zapier. | | Un'azione mostra **Changed** e non viene usata | L'hai modificata in Zapier. Seleziona **Update** nella scheda **Tools**. | | Zapier non riesce a collegarsi a ServiceTitan | Verifica 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 prenotazione | **External Id** ripeteva una prenotazione precedente. Assicurati che includa data e ora. | | I clienti già noti non vengono trovati | Prova il nome del chiamante oltre al suo numero di telefono. |