> Miglioramento continuo dei processi > Assistenza clienti > Salesforce Service Cloud > Template dei dati

Il Suo template di dati per l’assistenza clienti

Salesforce Service Cloud

Attributi dell’assistenza clienti(20) Attività dell’assistenza clienti(15) Guide all’estrazione(2)

Il Suo template di dati per l’assistenza clienti

Questo template fornisce indicazioni complete per preparare i dati dell’assistenza clienti al Process Mining. Descrive gli attributi essenziali da raccogliere, le attività principali da monitorare e offre indicazioni pratiche su come estrarre queste informazioni dal sistema di origine. Utilizzi questa risorsa per preparare i dati a un’analisi approfondita e all’ottimizzazione.

Attributi consigliati da raccogliere
Attività principali da monitorare
Indicazioni per l’estrazione

Non conosce ancora gli Event Log? Scopra come creare un Event Log per il Process Mining.

Scarica il template

Attributi dell’assistenza clienti

Questi sono i campi dati consigliati da includere nell’event log per analizzare in modo completo il processo di assistenza clienti.

5 Obbligatorio 9 Consigliato 6 Facoltativo

	Nome	Descrizione
	Richiesta di assistenza ServiceRequest	Identificativo univoco di un caso o ticket di assistenza clienti, che collega tutte le attività correlate.
Descrizione La richiesta di assistenza, spesso chiamata ticket o caso, funge da identificativo principale e collega tutte le attività relative a una singola richiesta o a un singolo problema del cliente. In Salesforce Service Cloud corrisponde al numero del caso. Questo attributo è essenziale per ricostruire l’intero percorso di ogni interazione con il cliente. Consente allo strumento di Process Mining di raggruppare tutti gli eventi correlati, come «Caso creato», «L’operatore analizza il problema» e «Caso risolto», in una singola istanza di processo, permettendo un’analisi completa dall’inizio alla fine. Perché è importante È un elemento fondamentale del Process Mining, perché collega tutti gli eventi relativi allo stesso problema del cliente in un’unica istanza di processo coerente. Dove reperirli Oggetto Salesforce Case, campo: CaseNumber Esempi 000010240000105800001193
	Nome dell’attività ActivityName	Nome di uno specifico evento o passaggio aziendale avvenuto nell’ambito del processo di assistenza clienti.
Descrizione Questo attributo descrive un singolo passaggio o una milestone nel ciclo di vita di una richiesta di assistenza. Le attività sono i nodi della mappa del processo e rappresentano le azioni svolte dagli operatori, dai sistemi automatizzati o dai clienti. Analizzare la sequenza e la frequenza di attività come «Caso creato», «Attivazione dell’escalation interna» e «Caso chiuso» è fondamentale nel Process Mining. Aiuta a ricostruire il flusso effettivo del processo, individuare i colli di bottiglia e rilevare le deviazioni dalle procedure operative standard. Perché è importante Le attività definiscono i passaggi del processo e la loro sequenza costituisce la base della mappa del processo e di tutte le analisi successive. Dove reperirli In genere si ricava da una combinazione di campi, come le modifiche di stato nell’oggetto Case (campo Status) o i record negli oggetti CaseHistory o EmailMessage. Esempi Caso creatoCaso assegnato a un operatoreSoluzione proposta al clienteCaso chiuso
	Ora dell’evento EventTime	Indicazione temporale precisa del momento in cui si è verificata un’attività.
Descrizione L’ora dell’evento registra la data e l’ora in cui una specifica attività è stata inserita nel sistema. Fornisce il contesto temporale dell’intero processo e consente di calcolare durate, tempi di attesa e tempi di ciclo. Nell’analisi, questa indicazione temporale serve a ordinare cronologicamente gli eventi di ogni richiesta di assistenza e costituisce la base per l’individuazione dei processi. È fondamentale per i KPI relativi ai risultati, ad esempio per misurare il tempo tra «Caso creato» e «Invio della conferma iniziale» o calcolare il tempo totale di risoluzione. Perché è importante Questa indicazione temporale è fondamentale per comprendere la cronologia del processo, calcolare le metriche dei risultati e individuare i ritardi tra le attività. Dove reperirli Ricavata da diversi campi data corrispondenti a eventi specifici, come CreatedDate nell’oggetto Case o CreatedDate nei record CaseHistory. Esempi 2023-04-15T10:00:00Z2023-04-15T11:23:14Z2023-04-16T09:05:30Z
	Sistema di origine SourceSystemName	Sistema da cui provengono i dati del processo.
Descrizione Questo attributo identifica l’applicazione di origine in cui sono stati generati i dati, che in questo caso è Salesforce Service Cloud. È particolarmente utile negli ambienti in cui si combinano dati provenienti da più sistemi per ottenere una visione completa del processo. Anche quando si analizza un solo sistema, questo attributo fornisce un contesto essenziale sull’origine dei dati. È utile per la governance dei dati, la risoluzione dei problemi e la verifica che le analisi si basino sul set di dati corretto. Perché è importante Fornisce un contesto essenziale sull’origine dei dati, necessario per la governance dei dati e per le analisi che possono combinare dati provenienti da più sistemi. Dove reperirli In genere si tratta di un valore statico aggiunto durante l’estrazione e la trasformazione dei dati per indicare l’origine del set di dati. Esempi Salesforce Service CloudSFSC
	Ultimo aggiornamento dei dati LastDataUpdateTime	Indicazione temporale dell’ultimo aggiornamento dei dati relativi a questo processo.
Descrizione Questo attributo registra l’indicazione temporale dell’ultima estrazione o dell’ultimo aggiornamento dei dati dal sistema di origine. È un campo di metadati che riguarda l’intero set di dati, non i singoli eventi. Serve principalmente a informare gli utenti sull’aggiornamento dei dati che stanno analizzando. È fondamentale per assicurarsi che le analisi e le decisioni si basino su informazioni attuali e pertinenti e aiuta a chiarire quanto siano recenti i dati. Perché è importante Garantisce trasparenza sull’aggiornamento dei dati e consente agli utenti di capire quanto sia attuale la propria analisi. Dove reperirli Questo valore viene in genere generato e memorizzato durante il processo di estrazione, trasformazione e caricamento dei dati (ETL). Esempi 2023-10-27T04:00:00Z
	Canale di comunicazione CommunicationChannel	Canale tramite cui è stata avviata la richiesta di assistenza, ad esempio e-mail, telefono o web.
Descrizione Questo attributo specifica il canale di comunicazione utilizzato dal cliente per inviare la richiesta di assistenza. In Salesforce, spesso è registrato nel campo Case Origin. Comprendere il canale di comunicazione è fondamentale per ottimizzare l’allocazione delle risorse e migliorare l’efficienza del servizio. Analizzando i tempi di risoluzione e i flussi di processo per canale, le organizzazioni possono individuare quelli più efficaci per le diverse tipologie di problemi, a supporto della Dashboard sull’efficienza dei canali di comunicazione. Perché è importante Consente di confrontare i risultati dei diversi canali di contatto con i clienti, aiutando a ottimizzare la strategia di canale e l’allocazione delle risorse. Dove reperirli Oggetto Salesforce Case, campo: Origin Esempi E-mailTelefonoWebChat
	Operatore assegnato AssignedAgent	Utente o coda a cui è attualmente assegnata la richiesta di assistenza.
Descrizione Questo attributo identifica l’operatore o il team responsabile della gestione della richiesta di assistenza in un determinato momento. In Salesforce, in genere corrisponde al proprietario del caso. Monitorare le modifiche a questo attributo è fondamentale per analizzare i risultati degli operatori, la distribuzione del carico di lavoro e i passaggi tra operatori. Aiuta a rispondere a domande come quante volte viene riassegnato un caso, quali operatori gestiscono i casi più complessi e se il carico di lavoro è distribuito in modo equilibrato nel team. È un attributo chiave per le Dashboard sui passaggi tra operatori e sulla distribuzione del carico di lavoro. Perché è importante È essenziale per analizzare il carico di lavoro degli operatori, i loro risultati e la frequenza dei passaggi tra operatori, che incidono direttamente sull’efficienza e sui tempi di risoluzione. Dove reperirli Oggetto Salesforce Case, campo: OwnerId. Questo campo contiene l’ID di un utente o di una coda. Esempi Sarah JonesDavid ChenCoda di assistenza di secondo livello
	Ora di fine EndTime	Indicazione temporale del completamento di un’attività.
Descrizione L’ora di fine indica il momento in cui un’attività viene completata. Insieme all’ora di inizio, consente di calcolare con precisione i tempi di elaborazione delle attività. Per molti eventi in Salesforce, l’evento è istantaneo, quindi l’ora di inizio e l’ora di fine coincidono. Per le attività di lunga durata, invece, disporre di un’ora di fine distinta è fondamentale per misurare con precisione il tempo impiegato. Supporta direttamente l’analisi dei risultati, distinguendo il tempo di elaborazione effettivo dal tempo di attesa tra un passaggio e l’altro. Perché è importante Consente di calcolare la durata effettiva di un’attività, essenziale per analizzare i risultati degli operatori e individuare i passaggi che richiedono più tempo. Dove reperirli Per gli eventi istantanei coincide spesso con StartTime. Per le attività che hanno una durata, deve essere ricavata da un campo specifico che indica il completamento, il che può richiedere una configurazione personalizzata. Esempi 2023-04-15T10:00:00Z2023-04-15T11:55:00Z2023-04-16T14:20:00Z
	Priorità del caso CasePriority	Livello di priorità assegnato alla richiesta di assistenza, ad esempio alta, media o bassa.
Descrizione La priorità del caso è una classificazione standard utilizzata per determinare l’urgenza di una richiesta di assistenza. Questa classificazione spesso determina i tempi obiettivo di risposta e risoluzione previsti dagli accordi sul livello di servizio (SLA). Analizzare i risultati del processo in base alla priorità è fondamentale per valutare l’efficacia della strategia di assegnazione delle priorità. Aiuta a verificare se i casi ad alta priorità vengono effettivamente risolti più rapidamente e rispettano gli obiettivi SLA più stringenti, fornendo un supporto diretto alla Dashboard sulla definizione delle priorità e sull’impatto dei casi. Perché è importante Consente di analizzare se il processo assegna efficacemente la priorità ai casi urgenti e rispetta i diversi livelli di servizio in base all’importanza del caso. Dove reperirli Oggetto Salesforce Case, campo: Priority Esempi AltaMediaBassa
	Risolto al primo contatto IsFirstContactResolution	Indicatore che segnala se il caso è stato risolto durante la prima interazione con il cliente.
Descrizione Questo attributo booleano identifica le richieste di assistenza risolte senza necessità di ulteriori contatti dopo la prima interazione con il cliente. Per determinarlo, spesso è necessario analizzare la sequenza e la tempistica delle attività. Un tasso elevato di risoluzione al primo contatto (FCR) è un chiaro indicatore di un processo di assistenza clienti efficiente ed efficace. Questo attributo calcolato costituisce la base del KPI del tasso di risoluzione al primo contatto. Analizzare i casi che non vengono risolti al primo contatto può rivelare opportunità per migliorare la formazione degli agenti, i contenuti della base di conoscenze e la progettazione del processo. Perché è importante Misura direttamente un aspetto fondamentale dell’efficienza dell’assistenza e della soddisfazione dei clienti, aiutando a individuare i fattori che favoriscono una risoluzione efficace dei problemi. Dove reperirli Calcolato durante la trasformazione dei dati analizzando l’event log di un determinato caso. Una regola comune consiste nel verificare se «Caso risolto» si verifica prima di «Informazioni richieste al cliente» o di successive attività di contatto con il cliente. Esempi truefalse
	Stato del caso CaseStatus	Stato attuale della richiesta di assistenza nel suo ciclo di vita, ad esempio nuovo, in corso o chiuso.
Descrizione Lo stato del caso indica la condizione attuale di una richiesta di assistenza. Le modifiche di stato sono spesso la fonte principale per individuare le attività del processo. Per esempio, una modifica da «New» a «Working» può essere associata all’attività «L’operatore analizza il problema». Analizzare lo stato finale dei casi aiuta a comprendere gli esiti delle risoluzioni. Lo stato serve anche a filtrare i casi aperti o chiusi e a individuare quelli che potrebbero rimanere troppo a lungo in una determinata condizione. Perché è importante Consente di conoscere lo stato attuale e l’esito del caso; le variazioni di stato vengono spesso utilizzate per ricostruire la sequenza delle attività. Dove reperirli Oggetto Case di Salesforce, campo: Status Esempi NuovoIn lavorazioneIn attesa del clienteChiuso
	Stato SLA SlaStatus	Indica se il caso è stato risolto entro il termine previsto dallo SLA.
Descrizione Questo attributo classifica ogni caso risolto in base al rispetto dell’accordo sul livello di servizio definito. Viene calcolato confrontando la data e ora effettive di risoluzione con il «Tempo obiettivo di risoluzione SLA». Essendo un dato utilizzato direttamente per il KPI del tasso di rispetto degli SLA, semplifica il monitoraggio dei risultati. Consente di filtrare e analizzare rapidamente tutti i casi non conformi per individuare le cause profonde delle violazioni, ad esempio specifici tipi di caso, prodotti o colli di bottiglia nel processo. Perché è importante Fornisce un esito chiaro, positivo o negativo, sul rispetto dello SLA per ogni caso, un dato fondamentale per monitorare i risultati e analizzare le cause profonde dei ritardi. Dove reperirli Calcolato nel livello di trasformazione dei dati confrontando la data e ora dell’attività «Caso risolto» con l’attributo «SlaTargetResolutionTime». Esempi RispettatoViolato
	Tempo obiettivo di risoluzione SLA SlaTargetResolutionTime	Data e ora entro cui la richiesta di assistenza dovrebbe essere risolta, secondo quanto previsto dallo SLA.
Descrizione Questo attributo definisce la scadenza prevista dall’accordo sul livello di servizio (SLA) per la risoluzione di un caso. In genere viene determinata in base a fattori quali la priorità e il tipo di caso, oltre alla categoria del cliente. Salesforce può calcolarla automaticamente tramite le funzionalità di gestione dei diritti e delle milestone. Questa data e ora sono essenziali per misurare il rispetto degli SLA. Confrontando il tempo effettivo di risoluzione con l’obiettivo, l’organizzazione può calcolare il KPI del tasso di rispetto degli SLA e individuare i casi a rischio di violazione, fornendo un supporto diretto alla Dashboard sul rispetto degli SLA dei casi. Perché è importante Fornisce il valore di riferimento con cui confrontare i risultati effettivi ed è quindi fondamentale per calcolare il rispetto degli SLA e individuare i casi a rischio. Dove reperirli Spesso è memorizzato nel campo SlaExitDate dell’oggetto Case Milestone, che fa parte della funzionalità Entitlement Management di Salesforce. Esempi 2023-04-16T17:00:00Z2023-04-18T09:00:00Z2023-05-01T12:00:00Z
	Tipo di caso CaseType	Classificazione della richiesta di assistenza, ad esempio domanda, problema o richiesta di una funzionalità.
Descrizione Il tipo di caso è un attributo categoriale che aiuta a classificare la natura della richiesta o del problema segnalato dal cliente. Consente di suddividere le richieste di assistenza per capire come vengono gestite le diverse tipologie di problemi. L’analisi del processo in base al tipo di caso può rivelare che alcune richieste seguono percorsi diversi, richiedono più tempo per essere risolte o comportano più passaggi di consegne. Queste informazioni sono utili per adattare e migliorare il processo in base alle specifiche categorie di lavoro. Perché è importante Consente di segmentare il processo per capire se le diverse tipologie di richieste vengono gestite in modo diverso e individuare gli ambiti in cui è possibile apportare miglioramenti mirati. Dove reperirli Oggetto Case di Salesforce, campo: Type Esempi ProblemaRichiesta di una funzionalitàDomanda
	È stato inoltrato IsEscalated	Indicatore che segnala se il caso è stato inoltrato a un livello superiore.
Descrizione Questo attributo booleano indica se una richiesta di assistenza è stata oggetto di un’escalation. In Salesforce, è possibile monitorarla tramite il campo standard IsEscalated, impostato automaticamente in base alle regole di escalation. L’indicatore alimenta direttamente la Dashboard di analisi delle escalation interne e il KPI del tasso di escalation interna. Consente di filtrare e aggregare facilmente tutti i casi inoltrati, aiutando a quantificarne la frequenza e ad analizzarne l’impatto sui tempi complessivi di risoluzione e sulla complessità del processo. Perché è importante Misura direttamente le escalation dei casi, un indicatore importante di attriti nel processo, complessità o lacune nelle conoscenze degli agenti. Dove reperirli Oggetto Case di Salesforce, campo: IsEscalated Esempi truefalse
	È una rilavorazione IsRework	Indicatore che segnala se un caso ha comportato una rilavorazione o un ritorno a una fase precedente.
Descrizione Questo attributo booleano segnala i casi che presentano schemi di rilavorazione, ad esempio quando vengono riaperti dopo la chiusura o passano ripetutamente tra «Agente analizza il caso» e «Soluzione proposta». Per individuare le rilavorazioni, è necessario analizzare la sequenza delle attività e rilevare i cicli indesiderati. Questo attributo alimenta direttamente il KPI del tasso di rilavorazione e la Dashboard sui passaggi tra agenti e sui cicli di rilavorazione. Individuare i casi con rilavorazioni consente agli analisti di indagarne le cause profonde, che possono andare da soluzioni inadeguate alla raccolta incompleta delle informazioni, e di intervenire per correggere il problema. Perché è importante Mette in evidenza le inefficienze del processo e gli sforzi sprecati, consentendo di analizzare in modo mirato le attività che vengono ripetute spesso. Dove reperirli Calcolato durante la trasformazione dei dati analizzando le sequenze di attività. Ad esempio, una sequenza come «Caso chiuso» -> «Caso riaperto» o «Soluzione proposta» -> «Agente analizza il problema» nello stesso caso verrebbe identificata come rilavorazione. Esempi truefalse
	Nome del cliente CustomerName	Nome del cliente o dell’account associato alla richiesta di assistenza.
Descrizione Questo attributo identifica il cliente che ha avviato la richiesta di assistenza. In Salesforce può trattarsi di un Contact (una persona) o di un Account (un’azienda). Analizzare il processo dal punto di vista del cliente può fornire informazioni utili. Ad esempio, può aiutare a individuare i clienti che riscontrano più problemi o tempi di risoluzione più lunghi. Queste informazioni possono orientare le strategie di gestione delle relazioni con i clienti e mettere in luce le opportunità per offrire supporto in modo proattivo. Perché è importante Consente di analizzare il processo mettendo al centro il cliente e di individuare schemi ricorrenti e differenze nei risultati per singoli clienti o segmenti di clientela. Dove reperirli Oggetto Case di Salesforce, campi: ContactId o AccountId, collegati rispettivamente agli oggetti Contact e Account. Esempi Global Tech Inc.Emily WhiteInnovate Solutions
	Numero di passaggi tra agenti AgentHandoffCount	Numero di volte in cui un caso è stato riassegnato da un agente o da una coda a un altro agente o a un’altra coda.
Descrizione Questa metrica quantifica il numero di riassegnazioni a cui è soggetta una richiesta di assistenza prima di essere risolta. Si calcola contando le variazioni distinte dell’attributo «AssignedAgent» durante il ciclo di vita di un singolo caso. Questo attributo costituisce la base del KPI del numero medio di passaggi tra agenti per caso ed è visualizzato nella Dashboard sui passaggi tra agenti e sui cicli di rilavorazione. Un numero elevato di passaggi segnala spesso inefficienze nel processo, responsabilità poco chiare o lacune nelle conoscenze, fattori che possono allungare i tempi di risoluzione e causare insoddisfazione nei clienti. Perché è importante Quantifica gli attriti interni al processo, poiché i passaggi di consegne eccessivi sono una causa frequente di ritardi e insoddisfazione dei clienti. Dove reperirli Calcolato a livello di caso durante la trasformazione dei dati, contando i valori distinti del campo «AssignedAgent» per ogni «ServiceRequest» e sottraendo uno. Esempi 0135
	Oggetto del caso CaseSubject	Breve riepilogo o titolo del problema o della richiesta del cliente.
Descrizione L’oggetto del caso offre un riepilogo conciso in testo libero della richiesta di assistenza. Spesso corrisponde all’oggetto dell’e-mail o a un titolo inserito dall’agente o dal cliente. Pur non essendo un campo strutturato per l’analisi diretta del processo, l’oggetto contiene molte informazioni di contesto. Le tecniche di analisi testuale possono essere utilizzate per classificare i casi, individuare problemi emergenti o aggiungere un contesto qualitativo all’analisi quantitativa del processo. Perché è importante Fornisce rapidamente un contesto generale sul caso, utile per le analisi di dettaglio e sfruttabile con le tecniche di analisi testuale. Dove reperirli Oggetto Case di Salesforce, campo: Subject Esempi Impossibile accedere al portaleDomanda sulla fatturaRichiesta di una funzionalità per la Dashboard dei report
	Prodotto interessato ProductInvolved	Il prodotto o servizio specifico a cui si riferisce la richiesta del cliente.
Descrizione Questo attributo collega una richiesta di assistenza a un prodotto o servizio specifico. In Salesforce, il collegamento viene spesso gestito tramite un campo di ricerca all’oggetto Product. Suddividere i dati di processo per prodotto è fondamentale per analizzare la qualità dei prodotti. Aiuta a individuare quali prodotti generano più richieste di assistenza, quali problemi si presentano e se il processo di risoluzione varia tra le diverse linee di prodotto. Queste informazioni sono un riscontro prezioso per i team di sviluppo dei prodotti. Perché è importante Consente di analizzare il processo in base al prodotto e di individuare problemi di qualità o lacune nell’assistenza per prodotti specifici. Dove reperirli Oggetto Case di Salesforce, campo: ProductId. È un campo di ricerca standard ma facoltativo. Esempi Suite CRM AlphaStrumento di analisi BetaConnettore dati Gamma

Obbligatorio Consigliato Facoltativo

Attività dell’assistenza clienti

Queste sono le fasi e le milestone principali da registrare nell’event log per individuare e analizzare con precisione i flussi di lavoro dell’assistenza clienti.

6 Consigliato 9 Facoltativo

	Attività	Descrizione
	Attivazione dell’escalation interna	Questa attività si verifica quando un caso richiede un livello di assistenza o competenza superiore e viene formalmente inoltrato in escalation. L’evento può essere registrato esplicitamente dalle regole di escalation di Salesforce oppure dedotto da una modifica di un campo.
Perché è importante L’analisi delle escalation aiuta a individuare le tipologie di casi complessi, le esigenze formative degli operatori di primo livello e i problemi sistemici. È un indicatore importante degli ostacoli nel processo e del loro impatto sui tempi di risoluzione. Dove reperirli Può trattarsi di un evento esplicito ricavato dai record CaseEscalation. Più spesso, viene dedotto da CaseHistory quando un campo di tipo casella di controllo, come «IsEscalated», viene impostato su true. Acquisizione Indicazione temporale della modifica del campo «IsEscalated» a true. Tipo di evento inferred
	Caso assegnato a un operatore	Indica il momento in cui una richiesta di assistenza viene assegnata a un operatore specifico o a una coda. È un passaggio fondamentale del processo, registrato tramite una modifica del campo che identifica il proprietario del caso.
Perché è importante Questa attività è essenziale per monitorare il carico di lavoro degli operatori, i ritardi nelle assegnazioni e la frequenza dei passaggi tra operatori. Costituisce la base per analizzare i risultati degli operatori e individuare i colli di bottiglia nel processo di assegnazione. Dove reperirli Deducibile da una modifica del campo OwnerId nell’oggetto Case. L’indicazione temporale della modifica è registrata nell’oggetto CaseHistory. Acquisizione Individuare l’indicazione temporale del primo aggiornamento del campo OwnerId. Tipo di evento inferred
	Caso chiuso	Questa attività rappresenta la conclusione definitiva del ciclo di vita della richiesta di assistenza. Una volta chiuso il caso, non sono previsti ulteriori interventi, a meno che non venga riaperto.
Perché è importante In quanto evento terminale, questa attività fornisce il punto finale per calcolare la durata complessiva del caso. Anche il tempo che intercorre tra «Resolved» e «Closed» può rivelare inefficienze nel processo di chiusura. Dove reperirli Deducibile dall’indicazione temporale in cui il campo IsClosed dell’oggetto Case viene impostato su true. In quel momento viene compilato anche il campo ClosedDate. Acquisizione Indicazione temporale in cui il campo IsClosed diventa true, registrata in CaseHistory. Tipo di evento inferred
	Caso creato	Questa attività segna l’inizio ufficiale del processo di assistenza clienti, quando una nuova richiesta di assistenza, o caso, viene registrata in Salesforce. L’evento viene acquisito esplicitamente alla creazione di un nuovo record nell’oggetto Case, con un’indicazione temporale precisa.
Perché è importante In quanto evento di inizio principale, questa attività è essenziale per calcolare la durata complessiva del ciclo di vita del caso e i tempi di risoluzione. Fornisce la base di riferimento per misurare i risultati rispetto agli SLA e comprendere il volume dei casi. Dove reperirli Questo evento corrisponde alla creazione del record nell’oggetto Case. L’indicazione temporale è registrata nel campo standard CreatedDate. Acquisizione Direttamente dall’indicazione temporale di creazione del record Case. Tipo di evento explicit
	Caso risolto	Questa milestone fondamentale indica che l’operatore ha completato il lavoro necessario per risolvere il problema del cliente. Il caso è in attesa della chiusura definitiva, che può avvenire automaticamente dopo un determinato periodo.
Perché è importante È un punto finale di riferimento per misurare i tempi di risoluzione ed è fondamentale per calcolare il rispetto degli SLA. Segna la fine del lavoro attivo sul caso. Dove reperirli Deducibile dall’oggetto CaseHistory quando il campo Status viene modificato in «Resolved». A questo punto, il campo IsClosed può essere ancora false. Acquisizione Indicazione temporale della modifica dello stato del caso a «Resolved». Tipo di evento inferred
	Violazione di una milestone SLA	Questo evento si attiva quando non viene rispettato un impegno di servizio, come il tempo di prima risposta o di risoluzione. Salesforce lo monitora tramite processi di entitlement e record delle milestone.
Perché è importante Questa attività è fondamentale per analizzare il rispetto degli SLA e monitorare la conformità. Evidenzia direttamente i casi in cui le aspettative dei clienti non sono state soddisfatte, consentendo di intervenire in modo mirato per migliorare il processo. Dove reperirli Acquisito dall’oggetto CaseMilestone. Viene generato un evento quando il campo IsViolated di un record milestone viene impostato su true. Acquisizione L’evento corrisponde all’indicazione temporale in cui il flag IsViolated diventa true in un record CaseMilestone. Tipo di evento explicit
	Caso classificato e definizione della priorità	Questa attività si verifica quando a un caso vengono assegnati un tipo, una categoria e un livello di priorità. Spesso se ne occupa un team di valutazione iniziale oppure intervengono regole di automazione; l’attività viene dedotta dalle modifiche ai campi pertinenti del caso.
Perché è importante La classificazione è fondamentale per comprendere la distribuzione dei casi e l’efficacia dell’instradamento. Analizzare questo passaggio aiuta a ottimizzare la distribuzione del carico di lavoro e ad assicurare che i casi ad alta priorità vengano gestiti tempestivamente. Dove reperirli Deducibile dall’oggetto CaseHistory, individuando la prima volta in cui i campi Priority, Type o altri campi di classificazione vengono compilati o modificati rispetto ai valori predefiniti. Acquisizione Monitorare gli aggiornamenti di campi come Priority o Type in CaseHistory. Tipo di evento inferred
	Caso riaperto	Si verifica quando un caso precedentemente risolto o chiuso viene riattivato perché il problema si ripresenta o la soluzione si rivela inefficace. È un indicatore importante di rilavorazione.
Perché è importante La riapertura dei casi è un forte segnale di risoluzioni di scarsa qualità o di mancato raggiungimento dell’FCR. Analizzarne la frequenza e le cause profonde è essenziale per migliorare la qualità del servizio. Dove reperirli Deducibile dall’oggetto CaseHistory quando il campo IsClosed passa da true a false oppure quando lo stato passa da chiuso o risolto ad aperto. Acquisizione Indicazione temporale della modifica del campo Status o IsClosed da uno stato terminale a uno stato attivo. Tipo di evento inferred
	Caso riassegnato	Indica il passaggio di un caso da un operatore o da una coda a un altro, dopo l’assegnazione iniziale. L’evento viene dedotto dalle successive modifiche del campo che identifica il proprietario del caso.
Perché è importante Riassegnazioni frequenti possono indicare un instradamento iniziale errato, inefficienze del processo o lacune nelle conoscenze, con conseguenti ritardi e un’esperienza negativa per il cliente. Questa attività consente di quantificare i passaggi tra operatori. Dove reperirli Deducibile da qualsiasi modifica del campo OwnerId nell’oggetto CaseHistory successiva all’assegnazione iniziale. Acquisizione Individuare tutti gli aggiornamenti del campo OwnerId successivi al primo. Tipo di evento inferred
	Invio del sondaggio di soddisfazione	Indica l’invio di un sondaggio sulla soddisfazione del cliente (CSAT) o sul Net Promoter Score (NPS). In genere si tratta di un’azione automatica successiva alla risoluzione o alla chiusura del caso.
Perché è importante Pur non facendo parte del processo di risoluzione principale, questa attività è importante per comprendere il ciclo di raccolta dei riscontri. Analizzarne tempi e frequenza aiuta ad assicurarsi che la voce del cliente venga raccolta con regolarità. Dove reperirli Deducibile da un record EmailMessage in uscita associato al caso e corrispondente a un template di sondaggio. In alternativa, può essere acquisito dalla creazione di un record SurveyInvitation. Acquisizione Individuare l’e-mail del sondaggio in uscita o la creazione del record SurveyInvitation. Tipo di evento inferred
	Invio della conferma iniziale	Indica la prima comunicazione inviata al cliente per confermare la ricezione della richiesta di assistenza. In genere si tratta di un’e-mail automatica attivata dalle regole di creazione dei casi; l’evento viene dedotto individuando la prima comunicazione in uscita.
Perché è importante Monitorare questa attività è fondamentale per misurare i tempi di prima risposta e assicurarsi che i clienti ricevano tempestivamente le informazioni. Consente di analizzare il KPI «Latenza della conferma iniziale» e migliorare la comunicazione con i clienti. Dove reperirli Deducibile dall’indicazione temporale del primo record EmailMessage in uscita associato al caso. Può anche essere dedotto dall’aggiornamento di un campo personalizzato attivato da una regola di automazione. Acquisizione Individuare l’indicazione temporale del primo EmailMessage in uscita collegato al caso. Tipo di evento inferred
	L’operatore analizza il problema	Indica la fase in cui un operatore lavora attivamente per diagnosticare e comprendere il problema del cliente. Non è un evento esplicito, ma viene dedotto quando lo stato del caso passa da nuovo o aperto a in corso.
Perché è importante Conoscere la durata della fase di analisi aiuta a individuare la complessità delle richieste di assistenza e gli ambiti in cui gli operatori potrebbero aver bisogno di ulteriore formazione o risorse. Consente di distinguere il tempo di lavoro effettivo dal tempo di attesa. Dove reperirli Deducibile dall’oggetto CaseHistory quando il campo Status viene aggiornato con un valore che indica un’attività in corso, come «In Progress» o «Working». Acquisizione Indicazione temporale della modifica dello stato del caso a un valore «in corso». Tipo di evento inferred
	Ricezione delle informazioni dal cliente	Questa attività segna la fine del tempo di attesa del cliente, che fornisce le informazioni richieste. Spesso viene dedotta quando, dopo una comunicazione in entrata, lo stato del caso torna a indicare un’attività in corso.
Perché è importante Monitorare questo evento è fondamentale per comprendere i tempi di risposta dei clienti e il loro impatto sul ciclo di vita complessivo del caso. Segnala la ripresa del lavoro attivo da parte dell’operatore. Dove reperirli Deducibile dall’indicazione temporale di un EmailMessage in entrata associato al caso oppure da una modifica dello stato da «Waiting on Customer» a «In Progress» nell’oggetto CaseHistory. Acquisizione Indicazione temporale dell’e-mail in entrata o della modifica dello stato da «in attesa». Tipo di evento inferred
	Richiesta di informazioni al cliente	Questa attività si verifica quando un operatore ha bisogno di ulteriori informazioni dal cliente per procedere con il caso. In genere viene dedotta quando lo stato del caso passa a «in attesa del cliente».
Perché è importante Questa attività segna l’inizio di un tempo di attesa che non dipende dall’operatore. Isolare questo intervallo è fondamentale per misurare con precisione l’efficienza del processo interno e i risultati degli operatori. Dove reperirli Deducibile dall’oggetto CaseHistory quando il campo Status viene aggiornato con un valore come «Waiting on Customer Response» o «Pending». Acquisizione Indicazione temporale della modifica dello stato del caso a un valore «in attesa». Tipo di evento inferred
	Soluzione proposta al cliente	Indica il momento in cui un operatore propone al cliente una possibile soluzione. È un passaggio concettuale, in genere dedotto da una comunicazione in uscita o da una specifica modifica di stato.
Perché è importante Monitorare questa milestone aiuta a misurare il tempo che intercorre tra l’analisi e la proposta di una soluzione. Può anche segnare l’inizio di un ciclo di conferma, se il cliente non accetta la soluzione. Dove reperirli Deducibile da un EmailMessage in uscita contenente parole chiave specifiche oppure da una modifica dello stato a «Solution Provided» nell’oggetto CaseHistory. Acquisizione Indicazione temporale della modifica di stato o dell’evento di comunicazione in uscita. Tipo di evento inferred

Consigliato Facoltativo

Guide all’estrazione

Come estrarre i dati da Salesforce Service Cloud

Passaggi

Acceda a Salesforce: acceda alla Sua istanza Salesforce con un account utente che disponga dell’accesso API e delle autorizzazioni di lettura per gli oggetti e i campi necessari.
Apra Developer Console: faccia clic sull’icona a forma di ingranaggio nell’angolo in alto a destra e selezioni 'Developer Console'.
Acceda all’editor delle query: in Developer Console, faccia clic sulla scheda 'Query Editor' nella parte inferiore della finestra.
Prepari la query SOQL: copi la query SOQL completa fornita nella sezione 'query' di questo documento.
Imposti i parametri delle date: prima di eseguire la query, sostituisca i valori segnaposto :startDate e :endDate con l’intervallo di date desiderato, nel formato ISO 8601 (ad esempio, 2023-01-01T00:00:00Z).
Esegua la query: incolli la query modificata nel riquadro Query Editor e faccia clic sul pulsante 'Execute'. Se la query è troppo ampia o complessa, potrebbe essere necessario utilizzare uno strumento come Workbench o Salesforce CLI, che prevedono limiti più elevati.
Gestisca i grandi set di dati: per set di dati con oltre 50.000 record, Developer Console potrebbe non essere sufficiente. Utilizzi Salesforce Data Loader o Bulk API 2.0. Può inviare la stessa query tramite questi strumenti per elaborare l’estrazione in batch asincroni.
Riveda i risultati: i risultati della query appariranno nella sezione 'Query Results'. Può consultare i dati in questa sezione per verificarne la correttezza.
Esporti i dati: faccia clic sul pulsante 'Save Rows' per esportare l’intero set di risultati in un file CSV.
Prepari i dati per ProcessMind: si assicuri che le intestazioni del file CSV corrispondano ai nomi degli attributi richiesti da ProcessMind. EventTime e gli altri campi data e ora devono avere un formato coerente, ad esempio YYYY-MM-DDTHH:MI:SS.mmmZ. La query è progettata per generare direttamente i nomi e i formati corretti delle colonne.
Salvi e carichi il file: salvi il file CSV finale e lo carichi nel Suo progetto ProcessMind.

Configurazione

Autorizzazioni utente: l’utente che esegue la query deve disporre dell’autorizzazione 'API Enabled' e dell’accesso in lettura agli oggetti Caso, CaseHistory, EmailMessage e CaseMilestone, nonché a tutti i campi inclusi nella query.
Strumenti per le query: Developer Console è adatto alle query più piccole e alle verifiche; per le estrazioni in produzione si consiglia Workbench, Salesforce CLI (sfdx) o Data Loader, che gestiscono volumi di dati maggiori e riducono il rischio di timeout del browser.
Intervallo di date: applichi un filtro alla query sul campo Case.CreatedDate per limitare l’ambito dell’estrazione. Per il Process Mining, l’intervallo tipico è compreso tra 3 e 12 mesi di dati. Un periodo molto esteso può causare problemi di prestazioni.
Valori segnaposto dello stato: la query contiene diversi segnaposto, come [Your In Progress Status] o [Your Resolved Status]. Li sostituisca con i valori effettivi dell’elenco di selezione del campo 'Stato' utilizzato nella Sua configurazione Salesforce.
Monitoraggio della cronologia dei campi: questa estrazione dipende in larga misura dal monitoraggio della cronologia dei campi per l’oggetto Caso. Si assicuri che sia attivato per i campi chiave, come Status, OwnerId, Priority e IsEscalated, così da acquisire correttamente questi eventi.
Limiti di utilizzo: le query SOQL di Salesforce sono soggette a limiti, ad esempio alla durata massima di esecuzione. Se la query va in timeout, potrebbe essere necessario ridurre l’intervallo di date o semplificarla suddividendola in query più piccole.

Query di esempio sql

/* Case Created */
SELECT
  c.CaseNumber AS ServiceRequest,
  'Case Created' AS ActivityName,
  c.CreatedDate AS EventTime,
  'Salesforce Service Cloud' AS SourceSystemName,
  NOW() AS LastDataUpdateTime,
  NULL AS EndTime,
  c.Owner.Name AS AssignedAgent,
  c.Priority AS CasePriority,
  c.Origin AS CommunicationChannel,
  c.Status AS CaseStatus,
  c.Type AS CaseType,
  c.SlaExitDate AS SlaTargetResolutionTime,
  (c.ClosedDate - c.CreatedDate) * 24 * 60 AS CaseResolutionTime,
  NULL AS SlaStatus,
  c.IsFirstContactResolution__c AS IsFirstContactResolution
FROM Case c
WHERE c.CreatedDate >= :startDate AND c.CreatedDate <= :endDate

UNION ALL

/* Initial Acknowledgment Sent - Approximated by first outbound email */
SELECT
  e.Case.CaseNumber AS ServiceRequest,
  'Initial Acknowledgment Sent' AS ActivityName,
  e.MessageDate AS EventTime,
  'Salesforce Service Cloud' AS SourceSystemName,
  NOW() AS LastDataUpdateTime,
  NULL AS EndTime,
  e.Case.Owner.Name AS AssignedAgent,
  e.Case.Priority AS CasePriority,
  e.Case.Origin AS CommunicationChannel,
  e.Case.Status AS CaseStatus,
  e.Case.Type AS CaseType,
  e.Case.SlaExitDate AS SlaTargetResolutionTime,
  (e.Case.ClosedDate - e.Case.CreatedDate) * 24 * 60 AS CaseResolutionTime,
  NULL AS SlaStatus,
  e.Case.IsFirstContactResolution__c AS IsFirstContactResolution
FROM EmailMessage e
WHERE e.Case.CreatedDate >= :startDate AND e.Case.CreatedDate <= :endDate
  AND e.IsOutgoing = true
  AND e.Id IN (SELECT MIN(Id) FROM EmailMessage WHERE IsOutgoing = true GROUP BY CaseId)

UNION ALL

/* Case Categorized And Prioritized - Approximated by first change to Priority */
SELECT 
  h.Case.CaseNumber AS ServiceRequest,
  'Case Categorized And Prioritized' AS ActivityName,
  h.CreatedDate AS EventTime,
  'Salesforce Service Cloud' AS SourceSystemName,
  NOW() AS LastDataUpdateTime,
  NULL AS EndTime,
  h.Case.Owner.Name AS AssignedAgent,
  h.NewValue AS CasePriority,
  h.Case.Origin AS CommunicationChannel,
  h.Case.Status AS CaseStatus,
  h.Case.Type AS CaseType,
  h.Case.SlaExitDate AS SlaTargetResolutionTime,
  (h.Case.ClosedDate - h.Case.CreatedDate) * 24 * 60 AS CaseResolutionTime,
  NULL AS SlaStatus,
  h.Case.IsFirstContactResolution__c AS IsFirstContactResolution
FROM CaseHistory h 
WHERE h.Case.CreatedDate >= :startDate AND h.Case.CreatedDate <= :endDate
  AND h.Field = 'Priority'
  AND h.OldValue = NULL

UNION ALL

/* Case Assigned To Agent - First Owner Change after Creation */
SELECT
  h.Case.CaseNumber AS ServiceRequest,
  'Case Assigned To Agent' AS ActivityName,
  h.CreatedDate AS EventTime,
  'Salesforce Service Cloud' AS SourceSystemName,
  NOW() AS LastDataUpdateTime,
  NULL AS EndTime,
  u.Name AS AssignedAgent, 
  h.Case.Priority AS CasePriority,
  h.Case.Origin AS CommunicationChannel,
  h.Case.Status AS CaseStatus,
  h.Case.Type AS CaseType,
  h.Case.SlaExitDate AS SlaTargetResolutionTime,
  (h.Case.ClosedDate - h.Case.CreatedDate) * 24 * 60 AS CaseResolutionTime,
  NULL AS SlaStatus,
  h.Case.IsFirstContactResolution__c AS IsFirstContactResolution
FROM CaseHistory h
LEFT JOIN User u ON (h.NewValue = u.Id)
WHERE h.Case.CreatedDate >= :startDate AND h.Case.CreatedDate <= :endDate
  AND h.Field = 'Owner'
  AND h.Id IN (SELECT MIN(Id) FROM CaseHistory WHERE Field = 'Owner' GROUP BY CaseId)

UNION ALL

/* Agent Investigates Issue */
SELECT 
  h.Case.CaseNumber AS ServiceRequest,
  'Agent Investigates Issue' AS ActivityName,
  h.CreatedDate AS EventTime,
  'Salesforce Service Cloud' AS SourceSystemName,
  NOW() AS LastDataUpdateTime,
  NULL AS EndTime,
  h.Case.Owner.Name AS AssignedAgent,
  h.Case.Priority AS CasePriority,
  h.Case.Origin AS CommunicationChannel,
  h.NewValue AS CaseStatus,
  h.Case.Type AS CaseType,
  h.Case.SlaExitDate AS SlaTargetResolutionTime,
  (h.Case.ClosedDate - h.Case.CreatedDate) * 24 * 60 AS CaseResolutionTime,
  NULL AS SlaStatus,
  h.Case.IsFirstContactResolution__c AS IsFirstContactResolution
FROM CaseHistory h 
WHERE h.Case.CreatedDate >= :startDate AND h.Case.CreatedDate <= :endDate
  AND h.Field = 'Status' AND h.NewValue = '[Your In Progress Status]'

UNION ALL

/* Information Requested From Customer */
SELECT 
  h.Case.CaseNumber AS ServiceRequest,
  'Information Requested From Customer' AS ActivityName,
  h.CreatedDate AS EventTime,
  'Salesforce Service Cloud' AS SourceSystemName,
  NOW() AS LastDataUpdateTime,
  NULL AS EndTime,
  h.Case.Owner.Name AS AssignedAgent,
  h.Case.Priority AS CasePriority,
  h.Case.Origin AS CommunicationChannel,
  h.NewValue AS CaseStatus,
  h.Case.Type AS CaseType,
  h.Case.SlaExitDate AS SlaTargetResolutionTime,
  (h.Case.ClosedDate - h.Case.CreatedDate) * 24 * 60 AS CaseResolutionTime,
  NULL AS SlaStatus,
  h.Case.IsFirstContactResolution__c AS IsFirstContactResolution
FROM CaseHistory h 
WHERE h.Case.CreatedDate >= :startDate AND h.Case.CreatedDate <= :endDate
  AND h.Field = 'Status' AND h.NewValue = '[Your Waiting on Customer Status]'

UNION ALL

/* Information Received From Customer */
SELECT 
  h.Case.CaseNumber AS ServiceRequest,
  'Information Received From Customer' AS ActivityName,
  h.CreatedDate AS EventTime,
  'Salesforce Service Cloud' AS SourceSystemName,
  NOW() AS LastDataUpdateTime,
  NULL AS EndTime,
  h.Case.Owner.Name AS AssignedAgent,
  h.Case.Priority AS CasePriority,
  h.Case.Origin AS CommunicationChannel,
  h.NewValue AS CaseStatus,
  h.Case.Type AS CaseType,
  h.Case.SlaExitDate AS SlaTargetResolutionTime,
  (h.Case.ClosedDate - h.Case.CreatedDate) * 24 * 60 AS CaseResolutionTime,
  NULL AS SlaStatus,
  h.Case.IsFirstContactResolution__c AS IsFirstContactResolution
FROM CaseHistory h 
WHERE h.Case.CreatedDate >= :startDate AND h.Case.CreatedDate <= :endDate
  AND h.Field = 'Status' AND h.OldValue = '[Your Waiting on Customer Status]'

UNION ALL

/* Case Reassigned */
SELECT
  h.Case.CaseNumber AS ServiceRequest,
  'Case Reassigned' AS ActivityName,
  h.CreatedDate AS EventTime,
  'Salesforce Service Cloud' AS SourceSystemName,
  NOW() AS LastDataUpdateTime,
  NULL AS EndTime,
  u.Name AS AssignedAgent,
  h.Case.Priority AS CasePriority,
  h.Case.Origin AS CommunicationChannel,
  h.Case.Status AS CaseStatus,
  h.Case.Type AS CaseType,
  h.Case.SlaExitDate AS SlaTargetResolutionTime,
  (h.Case.ClosedDate - h.Case.CreatedDate) * 24 * 60 AS CaseResolutionTime,
  NULL AS SlaStatus,
  h.Case.IsFirstContactResolution__c AS IsFirstContactResolution
FROM CaseHistory h
LEFT JOIN User u ON (h.NewValue = u.Id)
WHERE h.Case.CreatedDate >= :startDate AND h.Case.CreatedDate <= :endDate
  AND h.Field = 'Owner'
  AND h.Id NOT IN (SELECT MIN(Id) FROM CaseHistory WHERE Field = 'Owner' GROUP BY CaseId)

UNION ALL

/* Internal Escalation Triggered */
SELECT 
  h.Case.CaseNumber AS ServiceRequest,
  'Internal Escalation Triggered' AS ActivityName,
  h.CreatedDate AS EventTime,
  'Salesforce Service Cloud' AS SourceSystemName,
  NOW() AS LastDataUpdateTime,
  NULL AS EndTime,
  h.Case.Owner.Name AS AssignedAgent,
  h.Case.Priority AS CasePriority,
  h.Case.Origin AS CommunicationChannel,
  h.Case.Status AS CaseStatus,
  h.Case.Type AS CaseType,
  h.Case.SlaExitDate AS SlaTargetResolutionTime,
  (h.Case.ClosedDate - h.Case.CreatedDate) * 24 * 60 AS CaseResolutionTime,
  NULL AS SlaStatus,
  h.Case.IsFirstContactResolution__c AS IsFirstContactResolution
FROM CaseHistory h 
WHERE h.Case.CreatedDate >= :startDate AND h.Case.CreatedDate <= :endDate
  AND h.Field = 'IsEscalated' AND h.NewValue = 'true'

UNION ALL

/* SLA Milestone Violated */
SELECT
  m.Case.CaseNumber AS ServiceRequest,
  'SLA Milestone Violated' AS ActivityName,
  m.CompletionDate AS EventTime,
  'Salesforce Service Cloud' AS SourceSystemName,
  NOW() AS LastDataUpdateTime,
  NULL AS EndTime,
  m.Case.Owner.Name AS AssignedAgent,
  m.Case.Priority AS CasePriority,
  m.Case.Origin AS CommunicationChannel,
  m.Case.Status AS CaseStatus,
  m.Case.Type AS CaseType,
  m.Case.SlaExitDate AS SlaTargetResolutionTime,
  (m.Case.ClosedDate - m.Case.CreatedDate) * 24 * 60 AS CaseResolutionTime,
  'Violated' AS SlaStatus,
  m.Case.IsFirstContactResolution__c AS IsFirstContactResolution
FROM CaseMilestone m
WHERE m.Case.CreatedDate >= :startDate AND m.Case.CreatedDate <= :endDate
  AND m.IsViolated = true

UNION ALL

/* Solution Proposed To Customer */
SELECT 
  h.Case.CaseNumber AS ServiceRequest,
  'Solution Proposed To Customer' AS ActivityName,
  h.CreatedDate AS EventTime,
  'Salesforce Service Cloud' AS SourceSystemName,
  NOW() AS LastDataUpdateTime,
  NULL AS EndTime,
  h.Case.Owner.Name AS AssignedAgent,
  h.Case.Priority AS CasePriority,
  h.Case.Origin AS CommunicationChannel,
  h.NewValue AS CaseStatus,
  h.Case.Type AS CaseType,
  h.Case.SlaExitDate AS SlaTargetResolutionTime,
  (h.Case.ClosedDate - h.Case.CreatedDate) * 24 * 60 AS CaseResolutionTime,
  NULL AS SlaStatus,
  h.Case.IsFirstContactResolution__c AS IsFirstContactResolution
FROM CaseHistory h 
WHERE h.Case.CreatedDate >= :startDate AND h.Case.CreatedDate <= :endDate
  AND h.Field = 'Status' AND h.NewValue = '[Your Solution Proposed Status]'

UNION ALL

/* Case Resolved */
SELECT 
  h.Case.CaseNumber AS ServiceRequest,
  'Case Resolved' AS ActivityName,
  h.CreatedDate AS EventTime,
  'Salesforce Service Cloud' AS SourceSystemName,
  NOW() AS LastDataUpdateTime,
  NULL AS EndTime,
  h.Case.Owner.Name AS AssignedAgent,
  h.Case.Priority AS CasePriority,
  h.Case.Origin AS CommunicationChannel,
  h.NewValue AS CaseStatus,
  h.Case.Type AS CaseType,
  h.Case.SlaExitDate AS SlaTargetResolutionTime,
  (h.Case.ClosedDate - h.Case.CreatedDate) * 24 * 60 AS CaseResolutionTime,
  NULL AS SlaStatus,
  h.Case.IsFirstContactResolution__c AS IsFirstContactResolution
FROM CaseHistory h 
WHERE h.Case.CreatedDate >= :startDate AND h.Case.Createddate <= :endDate
  AND h.Field = 'Status' AND h.NewValue = '[Your Resolved Status]'

UNION ALL

/* Satisfaction Survey Sent */
SELECT
  e.Case.CaseNumber AS ServiceRequest,
  'Satisfaction Survey Sent' AS ActivityName,
  e.MessageDate AS EventTime,
  'Salesforce Service Cloud' AS SourceSystemName,
  NOW() AS LastDataUpdateTime,
  NULL AS EndTime,
  e.Case.Owner.Name AS AssignedAgent,
  e.Case.Priority AS CasePriority,
  e.Case.Origin AS CommunicationChannel,
  e.Case.Status AS CaseStatus,
  e.Case.Type AS CaseType,
  e.Case.SlaExitDate AS SlaTargetResolutionTime,
  (e.Case.ClosedDate - e.Case.CreatedDate) * 24 * 60 AS CaseResolutionTime,
  NULL AS SlaStatus,
  e.Case.IsFirstContactResolution__c AS IsFirstContactResolution
FROM EmailMessage e
WHERE e.Case.CreatedDate >= :startDate AND e.Case.CreatedDate <= :endDate
  AND e.IsOutgoing = true AND e.Subject LIKE '[Your Survey Subject Pattern]%'

UNION ALL

/* Case Closed */
SELECT
  c.CaseNumber AS ServiceRequest,
  'Case Closed' AS ActivityName,
  c.ClosedDate AS EventTime,
  'Salesforce Service Cloud' AS SourceSystemName,
  NOW() AS LastDataUpdateTime,
  NULL AS EndTime,
  c.Owner.Name AS AssignedAgent,
  c.Priority AS CasePriority,
  c.Origin AS CommunicationChannel,
  c.Status AS CaseStatus,
  c.Type AS CaseType,
  c.SlaExitDate AS SlaTargetResolutionTime,
  (c.ClosedDate - c.CreatedDate) * 24 * 60 AS CaseResolutionTime,
  NULL AS SlaStatus,
  c.IsFirstContactResolution__c AS IsFirstContactResolution
FROM Case c
WHERE c.CreatedDate >= :startDate AND c.CreatedDate <= :endDate
  AND c.IsClosed = true

UNION ALL

/* Case Reopened */
SELECT
  h.Case.CaseNumber AS ServiceRequest,
  'Case Reopened' AS ActivityName,
  h.CreatedDate AS EventTime,
  'Salesforce Service Cloud' AS SourceSystemName,
  NOW() AS LastDataUpdateTime,
  NULL AS EndTime,
  h.Case.Owner.Name AS AssignedAgent,
  h.Case.Priority AS CasePriority,
  h.Case.Origin AS CommunicationChannel,
  h.NewValue AS CaseStatus,
  h.Case.Type AS CaseType,
  h.Case.SlaExitDate AS SlaTargetResolutionTime,
  (h.Case.ClosedDate - h.Case.CreatedDate) * 24 * 60 AS CaseResolutionTime,
  NULL AS SlaStatus,
  h.Case.IsFirstContactResolution__c AS IsFirstContactResolution
FROM CaseHistory h
WHERE h.Case.CreatedDate >= :startDate AND h.Case.CreatedDate <= :endDate
  AND h.Field = 'IsClosed' AND h.OldValue = 'true' AND h.NewValue = 'false'

Passaggi

Configuri un’app connessa Salesforce: prima di eseguire lo script, configuri un’app connessa in Salesforce per abilitare l’accesso API. Acceda a Setup > Apps > App Manager e crei una nuova app connessa. Attivi OAuth Settings, selezioni 'Full access (full)' per OAuth Scopes e annoti Consumer Key e Consumer Secret.
Installi le librerie Python: si assicuri di avere Python installato, quindi installi le librerie necessarie con pip: pip install simple-salesforce pandas.
Recuperi le credenziali Salesforce: Le serviranno il nome utente e la password Salesforce, oltre a un token di sicurezza. Per ottenere il token, acceda alle Sue impostazioni personali in Salesforce e cerchi l’opzione 'Reset My Security Token'. Conservi le credenziali in modo sicuro, ad esempio come variabili d’ambiente, anziché inserirle direttamente nello script.
Configuri lo script Python: copi lo script Python fornito in un file, ad esempio extract_sfdc.py. Aggiorni le variabili segnaposto all’inizio dello script inserendo il nome utente e la password Salesforce, il token di sicurezza, la chiave e il segreto del consumer.
Definisca i parametri di estrazione: modifichi la variabile SOQL_DATE_FILTER nello script per specificare l’intervallo di date desiderato per l’estrazione dei casi. Per verificare lo script, si consiglia di iniziare con un intervallo più breve, ad esempio un mese.
Personalizzi i valori dello stato: controlli il dizionario STATUS_MAPPING nello script, che associa le fasi concettuali del processo ai valori di stato effettivamente utilizzati nella Sua istanza Salesforce. Aggiorni questi valori in base alla configurazione specifica della Sua organizzazione.
Esegua lo script di estrazione: esegua lo script dalla riga di comando con python extract_sfdc.py. Lo script si collegherà all’API Salesforce, recupererà i dati relativi a casi, cronologia dei casi e milestone dei casi, quindi li trasformerà in un Event Log.
Riveda l’output dello script: lo script mostrerà nella console gli aggiornamenti sull’avanzamento, compreso il numero di casi ed eventi elaborati. Verifichi che non si verifichino errori durante l’esecuzione.
Elabori il CSV generato: al termine dell’esecuzione, lo script creerà nella stessa cartella un file denominato salesforce_event_log.csv, contenente l’Event Log strutturato.
Prepari il file per il caricamento: prima di caricarlo in ProcessMind, apra il CSV e verifichi che tutte le colonne, comprese ServiceRequest, ActivityName e EventTime, siano compilate correttamente. Il file è quindi pronto per l’analisi.

Configurazione

Prerequisiti: è necessario disporre di un account utente Salesforce con accesso API e autorizzazioni di lettura per gli oggetti Caso, CaseHistory, CaseMilestone, Utente ed EmailMessage. È inoltre necessario configurare un’app connessa Salesforce per l’autenticazione OAuth 2.0.
Autenticazione: lo script utilizza il nome utente, la password, il token di sicurezza e le credenziali dell’app connessa (Consumer Key e Consumer Secret) per l’autenticazione. Per motivi di sicurezza, si consiglia vivamente di conservarli come variabili d’ambiente.
Intervallo di date: il periodo di estrazione dei dati è controllato dalla variabile SOQL_DATE_FILTER nello script. Per le estrazioni iniziali, si consiglia un periodo compreso tra 3 e 6 mesi, così da ottenere un set di dati significativo senza tempi di caricamento eccessivi.
Oggetti Salesforce principali: lo script interroga principalmente i seguenti oggetti Salesforce per creare l’Event Log:
- Caso: attributi principali del caso ed eventi di creazione.
- CaseHistory: modifiche ai campi chiave, come Status, OwnerId, Priority e IsEscalated.
- CaseMilestone: individuazione delle violazioni degli SLA.
- EmailMessage: deduzione delle attività relative alle comunicazioni.
- Utente: recupero dei nomi degli agenti assegnati.
Personalizzazione: la variabile STATUS_MAPPING nello script deve essere configurata in base ai valori di stato personalizzati utilizzati nella Sua implementazione Salesforce. In caso contrario, attività come 'Agente esamina il problema' o 'Caso risolto' non verranno acquisite correttamente.
Prestazioni: estrarre i dati da CaseHistory per un numero elevato di casi e un periodo esteso può richiedere molte risorse ed essere lento. L’operazione può inoltre consumare una parte significativa del limite giornaliero di chiamate API. Valuti di eseguire l’estrazione nelle fasce orarie di minore attività o di adottare una strategia di caricamento incrementale negli ambienti di produzione.

Query di esempio python

import pandas as pd
from simple_salesforce import Salesforce
from datetime import datetime
import os

class=class="hl-string">"hl-comment"># --- Configuration Settings --- #
class=class="hl-string">"hl-comment"># It is highly recommended to use environment variables for security.
SF_USERNAME = os.environ.get(class="hl-string">'SF_USERNAME', class="hl-string">'[Your Salesforce Username]')
SF_PASSWORD = os.environ.get(class="hl-string">'SF_PASSWORD', class="hl-string">'[Your Salesforce Password]')
SF_SECURITY_TOKEN = os.environ.get(class="hl-string">'SF_SECURITY_TOKEN', class="hl-string">'[Your Salesforce Security Token]')
SF_CONSUMER_KEY = os.environ.get(class="hl-string">'SF_CONSUMER_KEY', class="hl-string">'[Your Connected App Consumer Key]')
SF_CONSUMER_SECRET = os.environ.get(class="hl-string">'SF_CONSUMER_SECRET', class="hl-string">'[Your Connected App Consumer Secret]')

class=class="hl-string">"hl-comment"># Date filter for the SOQL query (e.g., last 90 days)
SOQL_DATE_FILTER = class="hl-string">'LAST_N_DAYS:90'

class=class="hl-string">"hl-comment"># IMPORTANT: Map your org's specific Case Status values here
STATUS_MAPPING = {
    class="hl-string">'investigating': [class="hl-string">'In Progress', class="hl-string">'Working', class="hl-string">'Researching'],
    class="hl-string">'waiting_on_customer': [class="hl-string">'Waiting on Customer', class="hl-string">'Pending Customer Response'],
    class="hl-string">'resolved': [class="hl-string">'Resolved', class="hl-string">'Solution Provided'],
    class="hl-string">'closed': [class="hl-string">'Closed'],
    class="hl-string">'reopened': [class="hl-string">'Reopened', class="hl-string">'Re-opened'] class=class="hl-string">"hl-comment"># Statuses indicating a case is active again after resolution
}

SOURCE_SYSTEM_NAME = class="hl-string">'Salesforce Service Cloud'

def fetch_salesforce_data(sf_conn):
    class="hl-string">"""Fetches all necessary data from Salesforce."""
    print(class="hl-string">"Fetching Case data...")
    case_query = fclass="hl-string">"""
    SELECT Id, CaseNumber, CreatedDate, ClosedDate, OwnerId, Priority, Origin, Status, Type, 
           Entitlement.SlaExitDate, (SELECT Name FROM Owner) 
    FROM Case 
    WHERE CreatedDate >= {SOQL_DATE_FILTER}
    """
    cases = sf_conn.query_all(case_query)[class="hl-string">'records']
    case_ids = [case[class="hl-string">'Id'] for case in cases]
    print(fclass="hl-string">"Found {len(case_ids)} cases.")

    if not case_ids:
        return pd.DataFrame(), pd.DataFrame(), pd.DataFrame(), pd.DataFrame()

    class=class="hl-string">"hl-comment"># Batch case IDs for subsequent queries
    case_id_str = class="hl-string">"','".join(case_ids)

    print(class="hl-string">"Fetching Case History data...")
    history_query = fclass="hl-string">"""
    SELECT CaseId, CreatedDate, Field, NewValue, OldValue, (SELECT Name FROM CreatedBy)
    FROM CaseHistory 
    WHERE CaseId IN ('{case_id_str}') AND Field IN ('Status', 'Owner', 'Priority', 'Type', 'IsEscalated')
    ORDER BY CreatedDate ASC
    """
    history = sf_conn.query_all(history_query)[class="hl-string">'records']

    print(class="hl-string">"Fetching Case Milestone data...")
    milestone_query = fclass="hl-string">"""
    SELECT CaseId, CompletionDate, IsViolated, IsCompleted, TargetDate, (SELECT Name FROM MilestoneType)
    FROM CaseMilestone
    WHERE CaseId IN ('{case_id_str}') AND IsViolated = true
    """
    milestones = sf_conn.query_all(milestone_query)[class="hl-string">'records']
    
    print(class="hl-string">"Fetching Email Message data...")
    email_query = fclass="hl-string">"""
    SELECT ParentId, CreatedDate, Status, Incoming, Subject
    FROM EmailMessage
    WHERE ParentId IN ('{case_id_str}') AND Status = 'Sent'
    ORDER BY CreatedDate ASC
    """
    emails = sf_conn.query_all(email_query)[class="hl-string">'records']

    return pd.DataFrame(cases), pd.DataFrame(history), pd.DataFrame(milestones), pd.DataFrame(emails)

def transform_to_event_log(cases_df, history_df, milestones_df, emails_df):
    class="hl-string">"""Transforms raw Salesforce data into a structured event log."""
    event_log = []
    last_update_time = datetime.utcnow().isoformat() + class="hl-string">'Z'

    class=class="hl-string">"hl-comment"># Create a lookup for case attributes
    cases_df[class="hl-string">'OwnerName'] = cases_df[class="hl-string">'Owner'].apply(lambda x: x[class="hl-string">'Name'] if x else None)
    case_details = cases_df.set_index(class="hl-string">'Id').to_dict(class="hl-string">'index')
    
    class=class="hl-string">"hl-comment"># Group related data by CaseId
    history_by_case = history_df.groupby(class="hl-string">'CaseId')
    milestones_by_case = milestones_df.groupby(class="hl-string">'CaseId')
    emails_by_case = emails_df.groupby(class="hl-string">'CaseId')

    for case_id, case in case_details.items():
        base_attributes = {
            class="hl-string">'ServiceRequest': case[class="hl-string">'CaseNumber'],
            class="hl-string">'SourceSystemName': SOURCE_SYSTEM_NAME,
            class="hl-string">'LastDataUpdateTime': last_update_time,
            class="hl-string">'CasePriority': case[class="hl-string">'Priority'],
            class="hl-string">'CommunicationChannel': case[class="hl-string">'Origin'],
            class="hl-string">'CaseType': case[class="hl-string">'Type'],
            class="hl-string">'SlaTargetResolutionTime': case.get(class="hl-string">'Entitlement', {}).get(class="hl-string">'SlaExitDate')
        }

        class=class="hl-string">"hl-comment"># 1. Case Created
        event_log.append({
            **base_attributes,
            class="hl-string">'ActivityName': class="hl-string">'Case Created',
            class="hl-string">'EventTime': case[class="hl-string">'CreatedDate'],
            class="hl-string">'AssignedAgent': case[class="hl-string">'OwnerName'],
            class="hl-string">'CaseStatus': class="hl-string">'New' class=class="hl-string">"hl-comment"># Assume initial status is class="hl-string">'New'
        })
        
        case_history = history_by_case.get_group(case_id) if case_id in history_by_case.groups else pd.DataFrame()
        case_emails = emails_by_case.get_group(case_id) if case_id in emails_by_case.groups else pd.DataFrame()
        
        class=class="hl-string">"hl-comment"># 2. Initial Acknowledgment Sent (Inferred)
        outbound_emails = case_emails[case_emails[class="hl-string">'Incoming'] == False]
        if not outbound_emails.empty:
            ack_email = outbound_emails.iloc[0]
            event_log.append({
                **base_attributes,
                class="hl-string">'ActivityName': class="hl-string">'Initial Acknowledgment Sent',
                class="hl-string">'EventTime': ack_email[class="hl-string">'CreatedDate'],
                class="hl-string">'AssignedAgent': case[class="hl-string">'OwnerName'], class=class="hl-string">"hl-comment"># Agent at time of creation
                class="hl-string">'CaseStatus': class="hl-string">'New' class=class="hl-string">"hl-comment"># Status at time of acknowledgement
            })
        
        owner_changes = case_history[case_history[class="hl-string">'Field'] == class="hl-string">'Owner'].copy()
        owner_changes[class="hl-string">'NewValueName'] = owner_changes[class="hl-string">'NewValue'].apply(lambda x: x[class="hl-string">'Name'] if isinstance(x, dict) else x)

        class=class="hl-string">"hl-comment"># 4. Case Assigned To Agent & 8. Case Reassigned
        if not owner_changes.empty:
            class=class="hl-string">"hl-comment"># First owner change is the initial assignment if it differs from creator's queue
            event_log.append({
                **base_attributes,
                class="hl-string">'ActivityName': class="hl-string">'Case Assigned To Agent',
                class="hl-string">'EventTime': owner_changes.iloc[0][class="hl-string">'CreatedDate'],
                class="hl-string">'AssignedAgent': owner_changes.iloc[0][class="hl-string">'NewValueName'],
                class="hl-string">'CaseStatus': case[class="hl-string">'Status']
            })
            class=class="hl-string">"hl-comment"># Subsequent owner changes are reassignments
            for _, row in owner_changes.iloc[1:].iterrows():
                event_log.append({
                    **base_attributes,
                    class="hl-string">'ActivityName': class="hl-string">'Case Reassigned',
                    class="hl-string">'EventTime': row[class="hl-string">'CreatedDate'],
                    class="hl-string">'AssignedAgent': row[class="hl-string">'NewValueName'],
                    class="hl-string">'CaseStatus': case[class="hl-string">'Status'] 
                })

        last_status = class="hl-string">'New'
        resolved_time = None

        class=class="hl-string">"hl-comment"># Process status, priority, type, and escalation changes from history
        for _, hist in case_history.iterrows():
            event_time = hist[class="hl-string">'CreatedDate']
            current_agent = owner_changes[owner_changes[class="hl-string">'CreatedDate'] <= event_time].iloc[-1][class="hl-string">'NewValueName'] if not owner_changes[owner_changes[class="hl-string">'CreatedDate'] <= event_time].empty else case[class="hl-string">'OwnerName']

            if hist[class="hl-string">'Field'] == class="hl-string">'Status':
                new_status = hist[class="hl-string">'NewValue']
                old_status = hist[class="hl-string">'OldValue']
                last_status = new_status
                
                class=class="hl-string">"hl-comment"># 5. Agent Investigates Issue
                if new_status in STATUS_MAPPING[class="hl-string">'investigating']:
                    event_log.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Agent Investigates Issue', class="hl-string">'EventTime': event_time, class="hl-string">'AssignedAgent': current_agent, class="hl-string">'CaseStatus': new_status})
                class=class="hl-string">"hl-comment"># 6. Information Requested From Customer
                elif new_status in STATUS_MAPPING[class="hl-string">'waiting_on_customer']:
                    event_log.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Information Requested From Customer', class="hl-string">'EventTime': event_time, class="hl-string">'AssignedAgent': current_agent, class="hl-string">'CaseStatus': new_status})
                class=class="hl-string">"hl-comment"># 7. Information Received From Customer
                elif old_status in STATUS_MAPPING[class="hl-string">'waiting_on_customer']:
                    event_log.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Information Received From Customer', class="hl-string">'EventTime': event_time, class="hl-string">'AssignedAgent': current_agent, class="hl-string">'CaseStatus': new_status})
                class=class="hl-string">"hl-comment"># 12. Case Resolved
                elif new_status in STATUS_MAPPING[class="hl-string">'resolved']:
                    resolved_time = event_time
                    event_log.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Case Resolved', class="hl-string">'EventTime': event_time, class="hl-string">'AssignedAgent': current_agent, class="hl-string">'CaseStatus': new_status})
                class=class="hl-string">"hl-comment"># 15. Case Reopened
                elif (old_status in STATUS_MAPPING[class="hl-string">'resolved'] or old_status in STATUS_MAPPING[class="hl-string">'closed']) and new_status not in STATUS_MAPPING[class="hl-string">'closed']:
                    event_log.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Case Reopened', class="hl-string">'EventTime': event_time, class="hl-string">'AssignedAgent': current_agent, class="hl-string">'CaseStatus': new_status})
            
            class=class="hl-string">"hl-comment"># 3. Case Categorized And Prioritized
            elif hist[class="hl-string">'Field'] in [class="hl-string">'Priority', class="hl-string">'Type']:
                 event_log.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Case Categorized And Prioritized', class="hl-string">'EventTime': event_time, class="hl-string">'AssignedAgent': current_agent, class="hl-string">'CaseStatus': last_status})
            
            class=class="hl-string">"hl-comment"># 9. Internal Escalation Triggered
            elif hist[class="hl-string">'Field'] == class="hl-string">'IsEscalated' and hist[class="hl-string">'NewValue'] == True:
                 event_log.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Internal Escalation Triggered', class="hl-string">'EventTime': event_time, class="hl-string">'AssignedAgent': current_agent, class="hl-string">'CaseStatus': last_status})

        class=class="hl-string">"hl-comment"># 10. SLA Milestone Violated
        if case_id in milestones_by_case.groups:
            case_milestones = milestones_by_case.get_group(case_id)
            for _, ms in case_milestones.iterrows():
                 event_log.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'SLA Milestone Violated', class="hl-string">'EventTime': ms[class="hl-string">'CompletionDate'], class="hl-string">'AssignedAgent': case[class="hl-string">'OwnerName'], class="hl-string">'CaseStatus': last_status})

        class=class="hl-string">"hl-comment"># 11. Solution Proposed To Customer (Inferred)
        if resolved_time and not outbound_emails.empty:
            proposal_email = outbound_emails[outbound_emails[class="hl-string">'CreatedDate'] < resolved_time]
            if not proposal_email.empty:
                 event_log.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Solution Proposed To Customer', class="hl-string">'EventTime': proposal_email.iloc[-1][class="hl-string">'CreatedDate'], class="hl-string">'AssignedAgent': case[class="hl-string">'OwnerName'], class="hl-string">'CaseStatus': last_status})
        
        class=class="hl-string">"hl-comment"># 13. Satisfaction Survey Sent (Inferred)
        if resolved_time and not outbound_emails.empty:
            survey_email = outbound_emails[outbound_emails[class="hl-string">'CreatedDate'] > resolved_time]
            if not survey_email.empty:
                class=class="hl-string">"hl-comment"># This logic assumes any email after resolution is a survey. Customize with Subject filter if possible.
                event_log.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Satisfaction Survey Sent', class="hl-string">'EventTime': survey_email.iloc[0][class="hl-string">'CreatedDate'], class="hl-string">'AssignedAgent': case[class="hl-string">'OwnerName'], class="hl-string">'CaseStatus': last_status})
        
        class=class="hl-string">"hl-comment"># 14. Case Closed
        if pd.notna(case[class="hl-string">'ClosedDate']):
            event_log.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Case Closed', class="hl-string">'EventTime': case[class="hl-string">'ClosedDate'], class="hl-string">'AssignedAgent': case[class="hl-string">'OwnerName'], class="hl-string">'CaseStatus': class="hl-string">'Closed'})
    
    return pd.DataFrame(event_log)

def main():
    class="hl-string">"""Main function to run the extraction process."""
    try:
        sf = Salesforce(
            username=SF_USERNAME,
            password=SF_PASSWORD,
            security_token=SF_SECURITY_TOKEN,
            consumer_key=SF_CONSUMER_KEY,
            consumer_secret=SF_CONSUMER_SECRET
        )
        print(class="hl-string">"Successfully connected to Salesforce.")
    except Exception as e:
        print(fclass="hl-string">"Failed to connect to Salesforce: {e}")
        return

    cases_df, history_df, milestones_df, emails_df = fetch_salesforce_data(sf)

    if cases_df.empty:
        print(class="hl-string">"No cases found for the specified date range. Exiting.")
        return

    print(class="hl-string">"Transforming data into event log...")
    event_log_df = transform_to_event_log(cases_df, history_df, milestones_df, emails_df)
    
    class=class="hl-string">"hl-comment"># Final data cleansing and sorting
    if not event_log_df.empty:
        event_log_df = event_log_df.sort_values(by=[class="hl-string">'ServiceRequest', class="hl-string">'EventTime']).reset_index(drop=True)
        event_log_df[class="hl-string">'EndTime'] = event_log_df[class="hl-string">'EventTime'] class=class="hl-string">"hl-comment"># Set EndTime equal to EventTime
        
        class=class="hl-string">"hl-comment"># Add missing recommended columns with nulls if not present
        recommended_cols = [class="hl-string">'SlaStatus', class="hl-string">'IsFirstContactResolution', class="hl-string">'CaseResolutionTime']
        for col in recommended_cols:
            if col not in event_log_df.columns:
                event_log_df[col] = None

        class=class="hl-string">"hl-comment"># Reorder columns to match requirements
        final_cols = [
            class="hl-string">'ServiceRequest', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'SourceSystemName', class="hl-string">'LastDataUpdateTime',
            class="hl-string">'EndTime', class="hl-string">'AssignedAgent', class="hl-string">'CasePriority', class="hl-string">'CommunicationChannel', class="hl-string">'CaseStatus',
            class="hl-string">'CaseType', class="hl-string">'SlaTargetResolutionTime', class="hl-string">'CaseResolutionTime', class="hl-string">'SlaStatus', class="hl-string">'IsFirstContactResolution'
        ]
        event_log_df = event_log_df[[col for col in final_cols if col in event_log_df.columns]]

        class=class="hl-string">"hl-comment"># Save to CSV
        output_filename = class="hl-string">'salesforce_event_log.csv'
        event_log_df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%S.%f%z')
        print(fclass="hl-string">"Successfully created event log with {len(event_log_df)} events.")
        print(fclass="hl-string">"File saved as {output_filename}")
    else:
        print(class="hl-string">"No events were generated.")

if __name__ == class="hl-string">'__main__':
    main()

È pronto a iniziare?

Utilizzi questo template di dati per avviare il Suo percorso di Process Mining e individuare opportunità nascoste nelle attività di assistenza clienti. Inizi oggi a trasformare l’erogazione del servizio.

Torna alla guida al miglioramento

Scarica il template

Aumenti subito l’efficienza dell’assistenza clienti

Risolva l’80% delle richieste al primo contatto e migliori i punteggi CSAT.

Inizi la prova gratuita

Non è richiesta alcuna carta di credito

Il Suo template di dati per l’assistenza clienti

Il Suo template di dati per l’assistenza clienti

Attributi dell’assistenza clienti

Attività dell’assistenza clienti

Guide all’estrazione

Query dirette Salesforce Object Query Language (SOQL)

Passaggi

Configurazione

Query di esempio sql

Estrazione con script Python tramite Salesforce REST API

Passaggi

Configurazione

Query di esempio python

È pronto a iniziare?

Aumenti subito l’efficienza dell’assistenza clienti