Integreer Airfocus met Salesforce

Voordelen van het gebruik van de Salesforce-integratie

Onze Salesforce integratie stelt ons in staat om feedback direct te groeperen vanuit jouw Salesforce cases en kansen. Importeer en centraliseer eenvoudig invoer uit Salesforce om te airfocussen en productontdekking te informeren.

• Importeer naadloos Salesforce-cases en -kansen als items naar AirFocus om Inzichten te creëren voor productontdekking en prioritering.
• Mogelijkheid om flexibel veel Salesforce-systeemvelden toe te wijzen aan Airfocus-velden.

Vereisten

Om gebruik te kunnen maken van de Salesforce-integratie, moeten gebruikers ervoor zorgen dat ze aan de volgende eisen voldoen:

Op airfocus

• Gebruikers moeten "Full" access Toestemmingen to a werkruimte hebben.
• AirFocus Team moet geabonneerd zijn op het "Enterprise" plan.

Op Salesforce

De Gebruiker die wordt gebruikt om de integratie in te stellen, moet worden toegewezen aan een profiel dat het volgende moet hebben:

• Lees tenminste Toestemmingen naar alle objecten/informatie die via de integratie gesynchroniseerd moet worden
• De instellingen "API ingeschakeld" en "Beheren verbonden apps" zijn INGESCHAKELD. Systeembeheerders kunnen dit controleren voor elk van hun geconfigureerde profielen via Setup > Administration Setup > Manage Gebruiker > Profiles
• Standaard heeft het maken van een app in Salesforce "Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization stromen" ingeschakeld. Deze vlag moet uitgeschakeld worden.

Extra voor het synchroniseren van "gevallen":

• De Salesforce-organisatie moet geabonneerd zijn op de Salesforce Service cloud en toegang hebben tot de "Web Services API", die momenteel beschikbaar is in de "Professional" (tegen extra kosten), "Enterprise" en "Unlimited" edities.
  

Extra voor het synchroniseren van "kansen":

• De Salesforce-organisatie moet geabonneerd zijn op de Salesforce Sales cloud en toegang hebben tot de "Web Services API", die momenteel beschikbaar is in de edities "Professional" (tegen extra kosten), "Enterprise" en "Unlimited".
  

Het opzetten van de integratie

Het opzetten van de integratie is eenvoudig en zou maar een paar minuten moeten duren. Zo doe je het:

Log in op AirFocus

Meld je eerst aan for airfocus of log in op jouw bestaande account. Maak een nieuwe werkruimte aan in Airfocus of kies degene waarmee je Salesforce wilt integreren.

Voeg een Salesforce-integratie toe aan AirFocus

Houd er rekening mee dat een integratie altijd aansluit op één specifieke airfocus werkruimte. je kunt meerdere Salesforce-integraties toevoegen aan een bepaalde werkruimte.

Om de integratie op te zetten, ga je naar "Integratie beheren" in jouw Extensions en verbind je met Salesforce.

Op het volgende scherm moet je "Een nieuwe Salesforce-instantie verbinden" selecteren in het vervolgkeuzemenu. Als je eerder verbinding hebt gemaakt met Salesforce-instanties in jouw Team, worden alle beschikbare Salesforce-instanties in deze dropdown weergegeven. Ik kan zoveel Salesforce-integraties maken in één Salesforce-instantie als ik wil.

Vervolgens moet je jouw nieuwe Salesforce-instantieverbinding een naam geven (die later op AirFocus zal worden weergegeven). Hieronder kun je de Consumer key (Client ID) en het consumentengeheim (Client secret) van jouw Salesforce Connected App invoeren om verbinding te maken met Salesforce.

Stel een verbonden app op Salesforce op

1. Log in bij jouw Salesforce-organisatie.
2. Open de instellingenpagina voor verbonden apps:
   • Als je Salesforce Classic gebruikt via Setup > App Setup > Create > apps.
     
   • Als je Salesforce gebruikt, Lightning via Setup > Platform Tools > Apps > App Manager.
     
     
3. Maak een nieuwe Aangesloten App:
   • als je Salesforce Classic gebruikt : Klik onder de sectie 'Connected apps' op 'Nieuw'.
     
   • als je Salesforce Lightning hebt : klik naast "Lightning Experience App Manager" op "Nieuwe verbonden app".
     
4. Vul het basisinformatiegedeelte in:
   • Connected App-naam: bijvoorbeeld "airfocus".
   • API-naam: bijvoorbeeld "airfocus".
   • Contact E-mail: jouw email address.
     
5. In de sectie API (OAuth Instellingen inschakelen):
   • Controleer de vak om "Instellingen OAuth inschakelen" te bekijken.
   • Afhankelijk van jouw airfocus-server (zie opmerking hieronder) - kopieer deze Callback-URL:
     • Europese server : https://app.airfocus.com/api/integration-providers/salesforce/callback en plak het in het veld "Callback URL".
     • VS Server: https: //app.airfocus.com/api/integration-providers/salesforce/callback en plak het in het veld "Callback URL".
     • Nieuwe Amerikaanse server (als je in de VS of APAC-regio zit en jouw account is aangemaakt na september 2025): https://app.airfocus.app/api/integration-providers/salesforce/callback en plak het in het veld "Callback URL".
   • Voeg in Selected OAuth Scopes de volgende scopes toe:
     • Beheer gebruikersdata via API's (api).
     • Verzoeken op elk moment uitvoeren (refresh_token, offline_access).
       
     • Let op: om de locatie van uw airfocus-server te vinden, controleer uw airfocus URL; als deze us.airfocus bevat, is het in de VS, zo niet, dan in Europa. Bijvoorbeeld: teamname.us.airfocus.com in plaats van teamname.airfocus.com
     • Let op: als je je in de VS of de APAC-regio bevindt en jouw account is aangemaakt na september 2025, zal de URL teamname.airfocus.app
6. Klik op "Opslaan". Het volgende scherm vertelt me dat je misschien tot 10 minuten moet wachten voordat de wijzigingen van kracht zijn. Klik op "Doorgaan". Wacht 10 minuten.
   

Opmerking: ik word doorgestuurd naar de beheerpagina van jouw connected app, zodat je direct verder kunt gaan met 4. in het volgende deel van deze gids.

Airfocus verbinden met Salesforce

1. Log in bij jouw Salesforce-organisatie.
2. Open de instellingenpagina voor verbonden apps:
   • Als je Salesforce Classic gebruikt via Setup > App Setup > Create > apps.
     
   • Als je Salesforce gebruikt, Lightning via Setup > Platform Tools > Apps > App Manager.
     
3. Open het overzicht van jouw Connected App:
   • Als je Salesforce Classic gebruikt in de sectie "Connected Apps" klik dan op de naam van jouw connected app voor Airfocus.
     
   • Als je Salesforce Lightning in de tabellen hebt, klik dan op de keuzemenu van jouw app en klik op "weergaven".
     
4. Klik in de sectie "API (Enable OAuth Settings)" op "Beheer Consumentengegevens".
   
5. Misschien moet je jouw identiteit verifiëren bij Salesforce.
6. Kopieer de "Consumer Key" en "Consumer Secret" en plak deze in de bijbehorende velden in de Airfocus Salesforce integratie-setup.
   
   
7. Klik op "Verbinden" op Airfocus.
8. je wordt doorgestuurd naar een bevestigingsscherm van Salesforce. Klik op "Toestaan".
   

Configure jouw integratie

je kunt de integratie benoemen door een naam in te voeren in het veld "Name" bovenaan de Salesforce integratie-instellingenpagina. Deze naam wordt ook weergegeven in het integratie-overzicht en de extensies voor eenvoudige identificatie.

Filters

Selecteer het Salesforce-objecttype dat je wilt importeren/synchroniseren met AirFocus. De integratie ondersteunt momenteel Salesforce-cases en -mogelijkheden. Als je beide objecttypes wilt synchroniseren, moet je voor elk één integratie instellen (ze kunnen allebei via dezelfde Salesforce-instantie verbinden, dus je hoeft niet voor elk objecttype een verbonden app te maken).

Selecteer een datum via de datumkiezer in het veld "Importeer objecten die daarna zijn gemaakt" om alleen objecten te importeren die na de geselecteerde datum zijn aangemaakt. Als je hier geen datum specificeert, importeert de integratie alle Salesforce-objecten van het type dat je hebt gekozen.

je kan verder filteren welke objecten gesynchroniseerd moeten worden door een WHERE-voorwaarde in te voeren voor de Salesforce Object query Language (SOQL). Combineer meerdere aandoeningen met AND of OR. Als je een startdatum selecteert in het veld hierboven, wordt deze impliciet toegevoegd aan de WHERE-clausule. Alle hier genoemde velden moeten een mapping hebben die is gedefinieerd in de sectie "Field mapping" hieronder. Lees meer.

Veldmapping

Gebruik mapping om te bepalen hoe informatie uit Salesforce naar AirFocus moet worden gekoppeld. De itemnamen en itembeschrijvingen worden standaard altijd toegewezen bij het opzetten van een nieuwe integratie en kunnen optioneel worden verwijderd of aangepast.

Hoe voeg je een nieuwe veldmapping toe

Bij het selecteren van een veld in het keuzemenu worden alleen velden weergegeven die overeenkomen met het veldtype aan de airfocus-kant. Onze integratie stelt je in staat om velden van het hoofdobjecttype (hierboven geselecteerd) evenals velden van direct verbonden objecten in kaart te brengen.

In het onderstaande voorbeeld heeft de gebruiker "Case" geselecteerd als het Salesforce-objecttype dat geïmporteerd/gesynchroniseerd moet worden. Het veld "Prioriteit" (gemarkeerd in rood) is een systeemveld van het object "Case". Het veld "Case ID" (groen gemarkeerd) is een systeemveld van het "MasterRecord"-object, dat een object is dat direct verbonden is met "Case".

Kort gezegd: als een veld maximaal één klik verwijderd is van jouw gesynchroniseerde object in Salesforce, kan ik het mappen naar jouw Airfocus-item (de voorwaarden die in dit artikel worden beschreven gelden).

De integratie staat momenteel alleen toe dat je informatie "one-way" van Salesforce naar AirFocus kunt synchroniseren.

Nadat je twee velden hebt geselecteerd die je wilt toewijzen, kun je de veldopties selecteren en hoe ze toegewezen moeten worden. je kan ook meerdere Salesforce-veldopties koppelen aan één Airfocus-veldoptie.

Beschikbare veldtypen voor mapping

De integratie staat momenteel alleen toe dat je systeemvelden "one-way" synchroniseert van Salesforce naar Airfocus. Hier is een lijst van mogelijke veldafbeeldingen die je kunt configureren:

Hoe bepaal je het veldtype van jouw Salesforce-velden

je kunt een lijst vinden van alle beschikbare / geconfigureerde velden op jouw Salesforce objecttype (zoals "Case" of "Opportunity") in jouw Salesforce-instellingen:

1. Log in bij de Salesforce-organisatie waar je verbinding maakt met AirFocus.
2. Klik op het hoofddashboard van Salesforce op het instellingenwiel naast jouw profielavatar en klik op "Setup".
   
3. Klik in de setup-zijbalk op Platform Tools > Objects and Fields > "Object Manager".
   
4. Zoek naar het objecttype waarvoor je veldtypen wilt zien en klik op het object-"label".
   
5. In het objecttype (voorbeeld "Case" hier) zijbalk, klik op "Velden & relatie" en bekijk de kolom "Data Type" van de tabellen om het veldtype te bepalen van elk veld dat ik voor dit objecttype heb geconfigureerd.
   
6. je kan bepalen of een veld een aangepast of systeemveld is door de kolom "Veldnaam" van de tabellen te bekijken. Als een veldnaam eindigt op een "__c", is het een aangepast veld.
   

Aanvullende instellingen

Wanneer "Archief onbekende items" is ingeschakeld, worden eerder geïmporteerde items Archief in Airfocus weergegeven, als ze niet meer in Salesforce aanwezig zijn of niet meer binnen de filters van de integratie vallen.

Wanneer "Automatische synchronisatie" is ingeschakeld, synchroniseert jouw integratie automatisch elke 10 minuten en elke keer dat je de werkruimte opent.

Wanneer je op "weergaven logs" klikt, kan je weergaven jouw Salesforce integratie activiteit logs en zien welke wijzigingen zijn aangebracht vóór de laatste synchronisatie.

Om uw instellingen op te slaan en uw items te importeren in Airfocus, "Update en synchroniseren".

Belangrijke opmerkingen

Het Salesforce Gebruiker-account dat werd gebruikt om de integratie in te stellen, hoeft niet per se gebruikt te worden om de integratie te gebruiken. Zolang de AirFocus-gebruiker geldige Consumer Keys en Secrets heeft, kunnen ze zoveel integratie instellen in die verbonden Salesforce als ze willen.

De integratie is momenteel beperkt tot het maximum-synchronisatiesysteem. 2000 Salesforce-objecten.

jouw connected app wordt door Salesforce beschouwd als een "Non-SDFC applicatie". Lees alstublieft de Main Service Agreement van Salesforce als u hun beleid wilt bekijken over het gebruik van niet-SDFC applicaties en het gebruik daarvan voor integratieservices.

Feedback geven over dit artikel