Integra airfocus con Salesforce

Vantaggi dell'utilizzo dell'integrazione con Salesforce

La nostra integrazione con Salesforce ti permette di raccogliere feedback direttamente dai tuoi casi e opportunità Salesforce. Importare e centralizzare facilmente gli input da Salesforce a airfocus e informare la scoperta del prodotto.

• Importare senza problemi casi e opportunità Salesforce come elementi da airfocus per creare Insight per la scoperta e la prioritizzazione del prodotto.
• Capacità di mappare in modo flessibile molti campi di sistema Salesforce in airfocus campi.

Requisiti

Per poter utilizzare l'integrazione con Salesforce, gli utenti devono assicurarsi di soddisfare i seguenti requisiti:

Al airfocus

• Gli utenti devono avere permessi di accesso "Full" a uno spazio di lavoro.
• airfocus Team deve essere iscritto al piano "Aziendale".

Su Salesforce

L'utente utilizzato per configurare l'integrazione deve essere assegnato a un profilo che deve avere:

• Almeno i permessi di lettura su tutti gli oggetti/informazioni che dovrebbero essere sincronizzati tramite l'integrazione
• Le impostazioni "API Abilitate" e "Gestisci app connesse" si sono attivate. Gli amministratori di sistema possono verificare questo per uno qualsiasi dei loro profili configurati tramite Setup > Administration Setup > Manage Users > Profiles
• Di default, quando si crea un'app in Salesforce, è abilitata l'estensione "Request Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows". Questa bandiera deve essere disattivata.

Aggiuntivo per la sincronizzazione dei "casi":

• L'organizzazione Salesforce deve essere abbonato al Salesforce Service Cloud e deve avere accesso all'"Web Services API" attualmente disponibile nelle edizioni "Professional" (a costo aggiuntivo), "Aziendale" e "Illimitata".
  

Ulteriori informazioni per la sincronizzazione delle "opportunità":

• L'organizzazione Salesforce deve essere abbonata al Salesforce Sales Cloud e deve avere accesso all'"Web Services API" attualmente disponibile nelle edizioni "Professional" (a costo aggiuntivo), "Aziendale" e "Illimitata".
  

Impostazione dell'integrazione

Configurare l'integrazione è semplice e dovrebbe richiedere solo pochi minuti. Ecco come si fa:

Accedi a airfocus

Per prima cosa, iscriviti a airfocus o accedi al tuo account esistente. Crea un nuovo spazio di lavoro in airfocus oppure seleziona quello con cui vorresti integrare Salesforce.

Aggiungi un'integrazione Salesforce ad airfocus

Tieni presente che un'integrazione si collega sempre a uno specifico airfocus Workspace. Puoi aggiungere più integrazioni Salesforce a un dato spazio di lavoro.

Per configurare l'integrazione, vai su "Gestisci integrazioni" nelle tue Estensioni e connettiti a Salesforce.

Nella schermata successiva, devi selezionare "Collega una nuova istanza Salesforce" dal menu a tendina. Se ti sei collegato in precedenza con istanze Salesforce nel tuo team, tutte le istanze disponibili di Salesforce saranno visualizzate in questo menu a tendina. Puoi creare quante più integrazioni Salesforce su un'unica istanza Salesforce vuoi.

Successivamente, devi dare un nome alla tua nuova connessione di istanza Salesforce (che poi verrà visualizzato su airfocus). Qui sotto puoi inserire la chiave Consumer (ID Client) e il segreto Consumer (Client secret) della tua app connessa a Salesforce per poter connetterti a Salesforce.

Configura un'app connessa su Salesforce

1. Accedi alla tua organizzazione Salesforce.
2. Apri la pagina delle impostazioni per le app connesse:
   • se utilizzi Salesforce Classic tramite Imposta > Imposta app > Crea > App.
     
   • Se usi Salesforce Lightning tramite Setup > Platform Tools > Apps > App Manager.
     
     
3. Crea una nuova app connessa:
   • Se usi Salesforce Classic : nella sezione app connesse clicca su "Nuovo".
     
   • se utilizzi Salesforce Lightning : accanto a "Lightning Experience App Manager" fai clic su "Nuova app connessa".
     
4. Compila la sezione di informazioni di base:
   • Nome app connessa: ad esempio "airfocus".
   • Nome API: ad esempio "airfocus".
   • Email di contatto: il tuo indirizzo email.
     
5. Nella sezione API (Abilita le impostazioni OAuth):
   • Seleziona la casella "Abilita impostazioni OAuth"
   • A seconda del tuo server airfocus (vedi nota sotto) - copia questo URL di Callback:
     • Server europeo : https://app.airfocus.com/api/integration-providers/salesforce/callback e incollarlo nel campo "URL di richiamo".
     • Server USA: https://app.airfocus.com/api/integration-providers/salesforce/callback e incollarlo nel campo "URL di richiamo".
     • Nuovo server USA (se ti trovi nella regione USA o APAC e il tuo account è stato creato dopo settembre 2025): https://app.airfocus.app/api/integration-providers/salesforce/callback e incollarlo nel campo "URL di richiamo".
   • Nei Selezionati Telescopi OAuth, aggiungi i seguenti telescopi:
     • Gestire i dati degli utenti tramite API (API).
     • Esegui le richieste in qualsiasi momento (refresh_token, offline_access).
       
     • Nota: per trovare la posizione del tuo server airfocus , controlla il tuo URL airfocus , se ci contiene.airfocus negli Stati Uniti, se non lo è, è in Europa. Ad esempio: teamname.us.airfocus.com invece di teamname.airfocus.com
     • Si prega di notare che, se ti trovi nella regione degli Stati Uniti o dell'APAC e il tuo account è stato creato dopo settembre 2025, l'URL sarà teamname.airfocus.app
6. Fare clic su "Salva". Nella schermata successiva ti verrà comunicato che potresti dover attendere fino a 10 minuti affinché le modifiche vengano applicate. Fare clic su "Continua". Attendi 10 minuti.
   

Nota: Verrai reindirizzato alla pagina di gestione dell'app collegata, così potrai continuare direttamente con il 4. nella sezione successiva di questa guida.

Collega airfocus a Salesforce

1. Accedi alla tua organizzazione Salesforce.
2. Apri la pagina delle impostazioni per le app connesse:
   • se utilizzi Salesforce Classic tramite Imposta > Imposta app > Crea > App.
     
   • Se usi Salesforce Lightning tramite Setup > Platform Tools > Apps > App Manager.
     
3. Apri la panoramica della tua Connected App:
   • Se sei su Salesforce Classic , nella sezione "App connesse", clicca sul nome della tua app connessa per airfocus.
     
   • Se sei su Salesforce Lightning nella tabella, clicca sulla freccia a tendina della tua app e clicca su "Visualizza".
     
4. Nella sezione "API (Abilita le impostazioni OAuth)" clicca su "Gestisci i dati del consumatore".
   
5. Potresti dover verificare la tua identità con Salesforce.
6. Copia la "Consumer Key" e la "Consumer Secret" e incollali nei campi corrispondenti nella configurazione di integrazione airfocus Salesforce.
   
   
7. Clicca su "Collega" su airfocus.
8. Verrai reindirizzato a una schermata di conferma Salesforce. Clicca su "Consenti".
   

Configura la tua integrazione

È possibile assegnare un nome all'integrazione inserendo un nome nel campo "Nome" situato nella parte superiore della pagina delle impostazioni dell'integrazione Salesforce. Questo nome verrà visualizzato anche nella panoramica delle integrazioni e nel popover delle estensioni per una facile identificazione.

Filtri

Seleziona il tipo di oggetto Salesforce con cui vuoi importare/sincroniz airfocuszare. L'integrazione attualmente supporta casi e opportunità Salesforce. Se vuoi sincronizzare entrambi i tipi di oggetti, devi configurare un'integrazione per ciascuno di essi (entrambi possono connettersi tramite la stessa istanza Salesforce, quindi non devi creare un'app connessa per ogni tipo di oggetto).

Seleziona una data tramite il selettore di date nel campo "Importa oggetti creati dopo" per importare solo gli oggetti creati dopo la data selezionata. Se non specifichi una data qui, l'integrazione importerà tutti gli oggetti Salesforce del tipo selezionato.

Puoi filtrare ulteriormente quali oggetti devono essere sincronizzati inserendo una condizione WHERE per il Salesforce Object Query Language (SOQL). Combina più condizioni con AND o OR. Se selezioni una data di inizio nel campo sopra, questa verrà implicitamente aggiunta alla clausola WHERE. Tutti i campi qui citati devono avere una mappatura definita nella sezione "Mappatura del campo" qui sotto. Scopri di più.

Mappatura del campo

Usa la mappatura per definire come le informazioni di Salesforce dovrebbero essere mappate su airfocus. I nomi degli oggetti e le descrizioni degli oggetti sono sempre mappati di default quando si configura una nuova integrazione e possono essere opzionalmente rimossi o modificati.

Come aggiungere una nuova mappatura di campo

Quando si seleziona un campo nel menu a tendina, solo i campi corrispondenti al tipo di campo saranno visualizzati nel menu a tendina alla airfocus estremità. La nostra integrazione ti permette di mappare campi del tipo principale di oggetto (selezionato sopra) così come campi di oggetti direttamente collegati.

Nell'esempio sottostante, l'utente ha selezionato "Case" come tipo di oggetto Salesforce da importare/sincronizzare. Il campo "Priority" (contrassegnato in rosso) è un campo di sistema dell'oggetto "Case". Il campo "Case ID" (contrassegnato in verde) è un campo di sistema dell'oggetto "MasterRecord" che è un oggetto direttamente collegato a "Case".

Per dirla semplicemente: se un campo è a massimo un clic dal tuo oggetto sincronizzato su Salesforce, puoi mapparelo al tuo airfocus articolo (le condizioni descritte in questo articolo si applicano).

L'integrazione attualmente permette solo di sincronizzare le informazioni "unidirezionale" da Salesforce a airfocus.

Dopo aver selezionato due campi che vuoi mappare, puoi selezionare le opzioni dei campi e come dovrebbero essere mappate. Puoi anche mappare più opzioni di campo Salesforce a un'unica opzione di campo airfocus .

Tipi di campo disponibili per la mappatura

L'integrazione attualmente permette solo di sincronizzare i campi di sistema "unidirezionale" da Salesforce a airfocus. Ecco un elenco di possibili mappe di campo che puoi configurare:

Come determinare il tipo di campo dei campi Salesforce

Puoi trovare un elenco di tutti i campi disponibili / configurati sul tipo di oggetto Salesforce (come "Caso" o "Opportunità") nelle impostazioni di Salesforce:

1. Accedi all'organizzazione Salesforce a cui ti stai collegando airfocus.
2. Nella tua dashboard principale di Salesforce clicca sulla volantino delle impostazioni accanto all'avatar del tuo profilo e clicca su "Configura".
   
3. Nella barra laterale di configurazione clicca su Tool Platform > Objects and Fields > "Object Manager".
   
4. Cerca il tipo di oggetto per cui vuoi vedere i tipi di campo e clicca sul suo oggetto "etichetta".
   
5. Nel tipo di oggetto (ad esempio "Caso" qui) clicca su "Campi e Relazioni" e rivedi la colonna "Tipo di dato" della tabella per determinare il tipo di campo di qualsiasi campo tu abbia configurato per questo tipo di oggetto.
   
6. Puoi determinare se un campo è personalizzato o di sistema esaminando la colonna "Nome campo" della tabella. Se il nome di un campo termina con un "__c", è un campo personalizzato.
   

Impostazioni aggiuntive

Quando "Archivia elementi sconosciuti" è abilitato, gli elementi importati in precedenza verranno archiviati in airfocus, se non sono più presenti in Salesforce o non rientrano più nei filtri impostati per l'integrazione.

Quando è abilitata la "Sincronizzazione automatica", la tua integrazione si sincronizzerà automaticamente ogni 10 minuti e ogni volta che accedi allo spazio di lavoro.

Quando clicchi su "Visualizza log",puoi visualizzare i log delle attività di integrazione di Salesforce e vedere quali modifiche sono state apportate prima dell'ultima sincronizzazione.

Per salvare le impostazioni e importare gli oggetti su airfocus, "Aggiorna e sincronizza".

Note importanti

L'account utente Salesforce usato per configurare l'integrazione non deve necessariamente essere usato per l'integrazione. Finché gli utenti airfocus hanno Chiavi e Segreti Consumer validi, possono configurare quante più integrazioni vogliono con quel Salesforce collegato.

L'integrazione è attualmente limitata al massimo della sincronizzazione. Oggetti Salesforce del 2000.

La tua app collegata è considerata da Salesforce una "Non-SDFC Application". Si prega di leggere l'Accordo di Servizio Principale di Salesforce se desideri rivedere le loro politiche sull'uso di applicazioni non SDFC e su quelle per i servizi di integrazione.

Dai un feedback su questo articolo