Integrera airfocus med Salesforce

Fördelar med att använda Salesforce-integrationen

Vår Salesforce-integration gör att du kan samla in feedback direkt från dina Salesforce-ärenden och möjligheter. Importera och centralisera enkelt indata från Salesforce för att airfocus och informera produktutveckling.

• Importera sömlöst Salesforce-ärenden och affärsmöjligheter som objekt för att airfocus för att skapa Insikter för produktupptäckt och prioritering.
• Möjlighet att flexibelt mappa många Salesforce-systemfält till airfocus -fält.

Krav

För att kunna använda Salesforce-integrationen måste användarna se till att de uppfyller följande krav:

På airfocus

• Användare måste ha ”Fullständiga” åtkomstbehörigheter till en arbetsyta.
• airfocus Team måste prenumerera på "Enterprise "-planen.

På Salesforce

Användaren som används för att konfigurera integrationen måste tilldelas en profil som måste ha:

• Åtminstone läsbehörigheter till alla objekt/information som ska synkroniseras via integrationen
• Inställningarna ”API aktiverad” och ”Hantera anslutna appar” aktiverades. Systemadministratörer kan kontrollera detta för någon av sina konfigurerade profiler via Setup > Administration Setup > Hantera användare > Profiler
• Som standard när du skapar en app i salesforce har den " Required Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows " aktiverat. Den här flaggan måste inaktiver as.

Ytterligare för synkronisering av ”fall”:

• Salesforce-organisationen måste prenumerera på Salesforce Service Cloud och ha tillgång till "Web Services API" som för närvarande är tillgängligt i utgåvorna "Professional" (extra kostnad), "Enterprise" och "Unlimited".
  

Ytterligare för synkronisering av ”möjligheter”:

• Salesforce-organisationen måste prenumerera på Salesforce Sales Cloud och ha tillgång till "Web Services API" som för närvarande är tillgängligt i utgåvorna "Professional" (extra kostnad), "Enterprise" och "Unlimited".
  

Ställa in integrationen

Att ställa in integrationen är enkelt och bör bara ta några minuter. Så här gör du:

Logga in på airfocus

Registrera dig först för airfocus eller logga in på ditt befintliga konto. Skapa en ny arbetsyta i airfocus eller välj den du vill integrera Salesforce med.

Lägg till en Salesforce-integration till airfocus

Tänk på att en integration alltid ansluter till en specifik airfocus arbetsyta. Du kan lägga till flera Salesforce-integrationer till en viss arbetsyta.

Om du vill konfigurera integrationen går du till " Hantera integrationer " i dina tillägg och ansluter till Salesforce.

På nästa skärm måste du välja " Anslut en ny Salesforce-instans " från rullgardinsmenyn. Om du tidigare har anslutit till Salesforce-instanser i ditt team visas alla tillgängliga Salesforce-instanser i den här rullgardinsmenyn. Du kan skapa så många Salesforce-integrationer till en enda Salesforce-instans som du vill.

Sedan måste du ge din nya Salesforce-instansanslutning ett namn (vilket senare kommer att visas på airfocus). Nedan kan du infoga konsumentnyckeln (Client ID) och Consumer secret (Client secret) för din Salesforce Connected App för att kunna ansluta till Salesforce.

Konfigurera en ansluten app på Salesforce

1. Logga in på din Salesforce-organisation.
2. Öppna inställningssidan för anslutna appar:
   • om du är på Salesforce Classic via Setup > App Setup > Skapa > Apps.
     
   • om du är på Salesforce Lightning via Setup > Platform Tools > Apps > App Manager.
     
     
3. Skapa en ny ansluten app:
   • om du är på Salesforce Classic : Klicka på ”Ny” under avsnittet anslutna appar.
     
   • om du använder Salesforce Lightning : Bredvid " Lightning Experience App Manager " klickar du på " Ny ansluten app ".
     
4. Fyll i avsnittet om grundläggande information:
   • Namn på ansluten app: till exempel ”airfocus”.
   • API-namn: till exempel ”airfocus”.
   • Kontakt E-post: din e-postadress.
     
5. I avsnittet API (Aktivera OAuth-inställningar):
   • Markera rutan för att ”Aktivera OAuth-inställningar”
   • Beroende på din airfocus-server (se anmärkning nedan) - kopiera denna återanrops-URL:
     • Europeisk server : https://app.airfocus.com/api/integration-providers/salesforce/callback och klistra in det i " Callback URL " -fältet.
     • Amerikansk server: https://app.airfocus.com/api/integration-providers/salesforce/callback och klistra in det i " Callback URL " -fältet.
     • Ny amerikansk server (om du befinner dig i USA eller APAC-regionen och ditt konto skapades efter september 2025): https://app.airfocus.app/api/integration-providers/salesforce/callback och klistra in det i " Callback URL " -fältet.
   • Lägg till följande omfång i Valda OAuth-omfång:
     • Hantera användardata via API: er (api).
     • Utför förfrågningar när som helst (refresh token, offline_access).
       
     • Obs: För att hitta din airfocus-serverplats, kontrollera din airfocus-URL. Om den innehåller us.airfocus finns den i USA, annars finns den i Europa. Till exempel: lagnamn.us.airfocus.com istället för lagnamn.airfocus.com
     • Observera att om du befinner dig i USA eller Asien-Stillahavsområdet och ditt konto skapades efter september 2025 kommer URL:en att vara teamname.airfocus.app
6. Klicka på ”Spara”. Nästa skärm kommer att berätta att du kan behöva vänta upp till 10 minuter för att ändringarna ska gälla. Klicka på " Fortsätt ". Vänta 10 minuter.
   

Obs! Du kommer att omdirigeras till hanteringssidan för din anslutna app, så att du kan fortsätta direkt med 4. i nästa avsnitt i den här guiden.

Anslut airfocus till Salesforce

1. Logga in på din Salesforce-organisation.
2. Öppna inställningssidan för anslutna appar:
   • om du är på Salesforce Classic via Setup > App Setup > Skapa > Apps.
     
   • om du är på Salesforce Lightning via Setup > Platform Tools > Apps > App Manager.
     
3. Öppna översikten över din Connected App:
   • Om du använder Salesforce Classic klickar du på namnet på din anslutna app för airfocus i avsnittet "Anslutna appar".
     
   • om du är på Salesforce Lightning i tabellen klickar du på rullgardinspilen för din app och klickar på " Visa ".
     
4. Klicka på ”Hantera konsumentinformation” i avsnittet ”API (Aktivera OAuth-inställningar)”.
   
5. Du kan behöva verifiera din identitet med Salesforce.
6. Kopiera "Konsumentnyckel" och "Konsumenthemlighet" och klistra in dem i motsvarande fält i airfocus Salesforce-integrationsinställningarna.
   
   
7. Klicka på “Anslut” på airfocus.
8. Du kommer att omdirigeras till en Salesforce-bekräftelseskärm. Klicka på " Tillåt ".
   

Konfigurera din integration

Du kan namnge integrationen genom att ange ett namn i fältet " Namn " högst upp på sidan Salesforce-integreringsinställningar. Det här namnet kommer att visas i integrationsöversikt och tilläggsfönster för enkel identifiering också.

Filter

Välj den Salesforce-objekttyp som du vill importera/synkronisera med airfocus. Integrationen stöder för närvarande Salesforce-fall och möjligheter. Om du vill synkronisera båda objekttyperna måste du konfigurera en integration för var och en av dem (de kan båda anslutas via samma Salesforce-instans, så du behöver inte skapa en ansluten app för varje objekttyp).

Välj ett datum via datumväljaren i fältet " Importera objekt skapade efter " för att bara importera objekt som skapades efter det valda datumet. Om du inte anger ett datum här importerar integrationen alla Salesforce-objekt av den typ du valt.

Du kan ytterligare filtrera ner vilka objekt som ska synkroniseras genom att ange ett WHERE-villkor för Salesforce Object Query Language (SOQL). Kombinera flera villkor med AND eller OR. Om du väljer ett startdatum i fältet ovan läggs det implicit till i WHERE-satsen. Alla fält som refereras här måste ha en mappning definierad i " Fältmappning " avsnitt nedan. Läs mer.

Fältkartläggning

Använd mappning för att definiera hur information från Salesforce ska mappas till airfocus. Objektnamnen och artikelbeskrivningarna mappas alltid som standard när en ny integration skapas och kan valfritt tas bort eller ändras.

Så här lägger du till en ny fältmappning

När du väljer ett fält i rullgardinsmenyn visas endast fält som matchar fälttypen i rullgardinsmenyn i airfocus änden. Vår integration gör att du kan kartlägga fält av huvudobjekttypen (vald ovan) samt fält av direkt anslutna objekt.

I exemplet nedan har användaren valt " Case " som Salesforce-objekttyp som ska importeras eller synkroniseras. Fältet " Priority " (markerat med rött) är ett systemfält för objektet " Case ". Fältet " Case ID " (markerat med grönt) är ett systemfält för " MasterRecord " objekt som är direkt kopplat till " Case ".

Enkelt uttryckt: Om ett fält bara är max ett klick bort från ditt synkroniserade objekt i Salesforce kan du mappa det till ditt airfocus-objekt (villkor som beskrivs i den här artikeln gäller).

Integrationen tillåter för närvarande endast att synkronisera information "enkelriktad" från Salesforce till airfocus.

När du har valt två fält som du vill kartlägga kan du välja fältalternativ och hur de ska mappas. Du kan också mappa flera Salesforce-fältalternativ till ett enda airfocus-fältalternativ.

Tillgängliga fälttyper för mappning

Integrationen tillåter för närvarande endast att synkronisera systemfält "enkelriktat" från Salesforce till airfocus. Här är en lista över möjliga fältmappningar som du kan konfigurera:

Så här bestämmer du fälttypen för dina Salesforce-fält

Du kan hitta en lista över alla fält som är tillgängliga/konfigurerade för din Salesforce-objekttyp (som ”Ärende” eller ”Möjlighet”) i dina Salesforce-inställningar:

1. Logga in på den Salesforce-organisation som du ansluter till airfocus.
2. På din huvudsakliga Salesforce Dashboard klickar du på inställningshjulet bredvid din profilavatar och klickar på ”Inställningar”.
   
3. Klicka på plattformsverktyg > Objects and Fields > ”Object Manager” i inställningssido fältet.
   
4. Leta efter den objekttyp du vill se fälttyperna för och klicka på dess objekt ”etikett”.
   
5. I objekttypen (exempel ”Fall” här) klickar du på ”Fält & Relationer” och granskar kolumnen ”Datatyp” i tabellen för att bestämma fälttypen för alla fält du har konfigurerat för den här objekttypen.
   
6. Du kan avgöra om ett fält är ett anpassat fält eller ett systemfält genom att granska kolumnen Fältnamn i tabellen. Om ett fältnamn slutar med en ”__c” är det ett anpassat fält.
   

Fler inställningar

När "Arkivera okända objekt" är aktiverat kommer tidigare importerade objekt att arkiveras i airfocus, om de inte längre finns i Salesforce eller om de inte längre faller under de filter som angetts för integrationen.

När "Automatisk synkronisering" är aktiverat synkroniseras integreringen automatiskt var tionde minut och varje gång du öppnar arbetsytan.

När du klickar på "Visa loggar" kan du visa dina aktivitetsloggar för Salesforce-integrationen och se vilka ändringar som gjordes före den senaste synkroniseringen.

För att spara dina inställningar och importera dina objekt till airfocus, klicka på "Uppdatera och synkronisera".

Viktiga anteckningar

Det Salesforce-användarkonto som används för att konfigurera integrationen behöver inte nödvändigtvis användas för att använda integrationen. Så länge airfocus-användarna har giltiga konsumentnycklar och hemligheter kan de konfigurera så många integrationer med den anslutna Salesforce-tjänsten som de vill.

Integrationen är för närvarande begränsad till synkronisering max. 2000 Salesforce-objekt.

Din anslutna app betraktas som en " icke-SDFC-applikation " av Salesforce. Läs Salesforces huvudsakliga serviceavtal om du vill granska deras policyer för användning av icke-SDFC-applikationer och användningen av dem för integrationstjänster.

Ge feedback på den här artikeln