Integration von AirFocus mit Salesforce

Vorteile der Nutzung der Salesforce-Integration

Unsere Salesforce-Integration ermöglicht es Ihnen, Feedback direkt aus Ihren Salesforce-Fällen und -Chancen zu sammeln. Importieren und zentralisieren Sie Eingaben aus Salesforce einfach, um Airfocus zu Airfocusen und die Produktentdeckung zu informieren.

• Importieren Sie Salesforce-Fälle und -Chancen nahtlos als Elemente in airfocus, um Einsichten für die Produktfindung und -priorisierung zu erstellen.
• Fähigkeit, viele Salesforce-Systemfelder flexibel auf Airfocus-Felder zuzuordnen.

Anforderungen

Um die Salesforce-Integration nutzen zu können, müssen Nutzende folgende Voraussetzungen erfüllen:

Auf Airfocus

• Nutzende benötigen „vollständige“ Zugriffsberechtigungen für einen Arbeitsbereich.
• Das airfocus-Team muss den „Enterprise“-Tarif abonniert haben.

Auf Salesforce

Die Nutzende, die zum Setzen, Bringen verwendet wird, beim Einrichten der Integration muss einem Profil zugewiesen werden, das Folgendes enthalten muss:

• Mindestens Leseberechtigungen für alle Objekte/Informationen, die über die Integration synchronisiert werden sollen.
• Die Einstellungen "API aktiviert" und "Verbundene Apps verwalten" wurden aktiviert. Systemadministratoren können dies für jedes ihrer konfigurierten Profile unter Setup > Administrations-Setup > Nutzen verwalten > Profile überprüfen.
• Standardmäßig ist bei der Erstellung einer App in Salesforce "Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows" aktiviert. Diese Flagge muss deaktiviert werden.

Zusätzlich zum Synchronisieren von "Fällen":

• Die Salesforce-Organisation muss Salesforce Service Cloud abonniert haben und Zugriff auf die „Web Services API“ besitzen, die derzeit in den Editionen „Professional“ (gegen Aufpreis), „Enterprise“ und „Unlimited“ verfügbar ist.
  

Zusätzlich zum Synchronisieren von "Opportunities":

• Die Salesforce-Organisation muss Salesforce Sales Cloud abonniert haben und Zugriff auf die „Web Services API“ besitzen, die derzeit in den Editionen „Professional“ (gegen Aufpreis), „Enterprise“ und „Unlimited“ verfügbar ist.
  

Einrichten der Integration

Die Einrichtung der Integration ist einfach und sollte nur wenige Minuten dauern. So geht's:

Melden Sie sich bei AirFocus an

Melden Sie sich zuerst bei AirFocus an oder melden Sie sich in Ihr bestehendes Konto ein. Erstellen Sie einen neuen Arbeitsbereich in airfocus oder wählen Sie denjenigen aus, mit dem Sie Salesforce integrieren möchten.

Fügen Sie eine Salesforce-Integration zu airfocus hinzu

Bitte beachten Sie, dass eine Integration immer mit einem bestimmten airfocus Der Arbeitsbereich verbunden ist. Sie können einem bestimmten Arbeitsbereich mehrere Salesforce-Integrationen hinzufügen.

Um die Integration einzurichten, gehen Sie in Ihren Erweiterungen auf „Integration verwalten“ und stellen Sie eine Verbindung zu Salesforce her.

Im nächsten Bildschirm müssen Sie im Dropdown-Menü „Eine neue Salesforce-Instanz verbinden“ auswählen. Wenn Sie zuvor eine Verbindung zu einer Salesforce-Instanz in Ihrem Team hergestellt haben, werden alle verfügbaren Salesforce-Instanzen in diesem Dropdown-Menü angezeigt. Sie können beliebig viele Salesforce-Integrationen zu einer einzelnen Salesforce-Instanz erstellen.

Als Nächstes müssen Sie Ihrer neuen Salesforce-Instanzverbindung einen Namen geben (der später auf airfocus angezeigt wird). Unten können Sie den Verbraucherschlüssel (Client-ID) und das Verbrauchergeheimnis (Client-Geheimnis) Ihrer Salesforce Connected App einfügen, um sich mit Salesforce verbinden zu können.

Richte eine verbundene App in Salesforce ein

1. Melden Sie sich bei Ihrer Salesforce-Organisation an.
2. Öffnen Sie die Einstellungsseite für verbundene Apps:
   • Wenn Sie Salesforce Classic verwenden, gehen Sie zu Setup > App-Setup > Erstellen > Apps.
     
   • Wenn du Salesforce nutzt, Lightning über Setup > Platform Tools > Apps > App Manager.
     
     
3. Erstellen Sie eine neue vernetzte App:
   • wenn du Salesforce Classic nutzt : Klicke unter dem Bereich "Verbundene Apps" auf "Neu".
     
   • Wenn Sie Salesforce Lightning verwenden : Klicken Sie neben „Lightning Experience App Manager“ auf „Neue verbundene App“.
     
4. Füllen Sie den Bereich für die Grundinformationen aus:
   • Verbundener App-Name: zum Beispiel "airfocus".
   • API-Name: zum Beispiel "airfocus".
   • Kontakt-E-Mail: Ihre E-Mail-Adresse.
     
5. Im Abschnitt API (OAuth-Einstellungen aktivieren):
   • Aktivieren Sie das Kontrollkästchen, um „ OAuth Einstellungen zu aktivieren“.
   • Je nach Ihrem AirFocus-Server (siehe Anmerkung unten) – kopieren Sie diese Callback-URL:
     • Europäischer Server : https://app.airfocus.com/api/integration-providers/salesforce/callback und fügte es in das Feld "Callback URL" ein.
     • US-Server: https://app.airfocus.com/api/integration-providers/salesforce/callback und fügte es in das Feld "Callback URL" ein.
     • Neuer US-Server (falls Sie in den USA oder im asiatisch-pazifischen Raum ansässig sind und Ihr Konto nach September 2025 erstellt wurde): https://app.airfocus.app/api/integration-providers/salesforce/callback und fügte es in das Feld "Callback URL" ein.
   • Fügen Sie unter „Ausgewählte OAuth-Bereiche“ die folgenden Bereiche hinzu:
     • Nutzende Daten über APIs verwalten (API).
     • Anfragen können jederzeit ausgeführt werden (refresh_token, offline_access).
       
     • Hinweis: Um den Standort deines AirFocus-Servers zu finden, überprüfe deine AirFocus-URL. Wenn sie us.airfocus enthält, befindet sie sich in den USA, falls nicht, in Europa. Zum Beispiel: teamname.us.airfocus.com statt teamname.airfocus.com
     • Bitte beachten Sie, dass die URL, wenn Sie sich in den USA oder der APAC-Region befinden und Ihr Konto nach September 2025 erstellt wurde, teamname.airfocus.app
6. Klicken Sie auf "Speichern". Der nächste Bildschirm zeigt an, dass du möglicherweise bis zu 10 Minuten warten musst, bis die Änderungen angewendet werden. Klicken Sie auf "Fortsetzen". Warte 10 Minuten.
   

Hinweis: Sie werden zur Verwaltungsseite Ihrer verbundenen App weitergeleitet, sodass Sie direkt mit Punkt 4 im nächsten Abschnitt dieses Leitfadens fortfahren können.

Verbinden Sie airfocus mit Salesforce

1. Melden Sie sich bei Ihrer Salesforce-Organisation an.
2. Öffnen Sie die Einstellungsseite für verbundene Apps:
   • Wenn Sie Salesforce Classic verwenden, gehen Sie zu Setup > App-Setup > Erstellen > Apps.
     
   • Wenn du Salesforce nutzt, Lightning über Setup > Platform Tools > Apps > App Manager.
     
3. Öffnen Sie die Übersicht Ihrer Connected App:
   • Wenn du Salesforce Classic nutzt , klicke im Bereich "Connected Apps" auf den Namen deiner verbundenen App für Airfocus.
     
   • Wenn Sie Salesforce Lightning verwenden, klicken Sie in den Tabellen auf den Dropdown-Pfeil Ihrer App und anschließend auf „Ansichten“.
     
4. Klicken Sie im Abschnitt „API (OAuth-Einstellungen aktivieren)“ auf „Verbraucherdetails verwalten“.
   
5. Möglicherweise müssen Sie Ihre Identität bei Salesforce verifizieren.
6. Kopieren Sie den „Consumer Key“ und das „Consumer Secret“ und fügen Sie sie in die entsprechenden Felder im airfocus Salesforce Integration-Setup ein.
   
   
7. Klicken Sie auf "Verbinden" bei Airfocus.
8. Sie werden zu einem Salesforce-Bestätigungsbildschirm weitergeleitet. Klicken Sie auf "Erlauben".
   

Konfigurieren Sie Ihre Integration

Sie können der Integration einen Namen geben, indem Sie im Feld „Name“ oben auf der Seite mit den Salesforce-Integrationseinstellungen einen Namen eingeben. Dieser Name wird zur einfacheren Identifizierung auch in der Integrationsübersicht und im Erweiterungs-Popup angezeigt.

Filter

Wählen Sie den Salesforce-Objekttyp, den Sie importieren oder synchronisieren möchten. Die Integration unterstützt aktuell Salesforce-Fälle und -Chancen. Wenn Sie beide Objekttypen synchronisieren möchten, müssen Sie für jeden von ihnen eine Integration einrichten (beide können über dieselbe Salesforce-Instanz verbunden werden, sodass Sie nicht für jeden Objekttyp eine verbundene App erstellen müssen).

Wählen Sie ein Datum über den Datumswähler im Feld "Objekte importieren, die danach erstellt wurden", um nur Objekte zu importieren, die nach dem ausgewählten Datum erstellt wurden. Wenn Sie hier kein Datum angeben, importiert die Integration alle Salesforce-Objekte des von Ihnen ausgewählten Typs.

Sie können die zu synchronisierenden Objekte weiter eingrenzen, indem Sie eine WHERE-Bedingung für die Salesforce Object Abfrage Language (SOQL) eingeben. Kombinieren Sie mehrere Bedingungen mit AND oder OR. Wenn Sie im obigen Feld ein Startdatum auswählen, wird dieses automatisch in die WHERE-Klausel aufgenommen. Alle hier referenzierten Felder müssen eine Abbildung haben, die im Abschnitt "Feldabbildung" unten definiert ist. Erfahren Sie mehr.

Feldabbildung

Verwenden Sie Mapping, um zu definieren, wie Informationen aus Salesforce auf AirFocus abgebildet werden sollen. Die Namen und Beschreibungen der Elemente werden beim Einrichten einer neuen Integration immer standardmäßig zugeordnet und können optional entfernt oder geändert werden.

Wie man eine neue Feldabbildung fügt

Beim Auswählen eines Feldes im Dropdown-Menü werden nur Felder angezeigt, die dem Feldtyp entsprechen, im Dropdown-Menü am Airfocus-Ende. Unsere Integration ermöglicht es Ihnen, Felder des Hauptobjekttyps (oben ausgewählt) sowie Felder direkt verbundener Objekte zuzuordnen.

Im folgenden Beispiel hat Nutzende "Case" als Salesforce-Objekttyp ausgewählt, der importiert/synchronisiert werden soll. Das Feld "Priorität" (rot markiert) ist ein Systemfeld des Objekts "Case". Das Feld "Case ID" (grün markiert) ist ein Systemfeld des Objekts "MasterRecord", das direkt mit "Case" verbunden ist.

Vereinfacht gesagt: Wenn ein Feld maximal einen Klick von Ihrem synchronisierten Objekt in Salesforce entfernt ist, können Sie es Ihren airfocus Elementen zuordnen (die in diesem Artikel beschriebenen Bedingungen gelten).

Die Integration erlaubt derzeit nur die Synchronisierung von Informationen „in eine Richtung“ von Salesforce zu airfocus.

Nachdem du zwei Felder ausgewählt hast, die du zuordnen möchtest, kannst du die Feldoptionen auswählen und wie sie zugeordnet werden sollen. Du kannst auch mehrere Salesforce-Feldoptionen auf eine einzige Airfocus-Feldoption zuordnen.

Verfügbare Feldtypen für die Zuordnung

Die Integration erlaubt derzeit nur die Synchronisierung von Systemfeldern „in eine Richtung“ von Salesforce zu airfocus. Hier ist eine Liste möglicher Feldabbildungen, die Sie konfigurieren können:

Wie man den Feldtyp Ihrer Salesforce-Felder bestimmt

Eine Liste aller verfügbaren bzw. konfigurierten Felder in deinem Salesforce-Objekttyp (wie "Fall" oder "Opportunity") findest du in deinen Salesforce-Einstellungen:

1. Melden Sie sich bei der Salesforce-Organisation an, mit der Sie sich mit AirFocus verbinden.
2. Auf Ihrem Haupt-Salesforce-Dashboard klicken Sie auf das Einstellungsrad neben Ihrem Profil-Avatar und klicken Sie auf "Einrichten".
   
3. Klicken Sie in der Einrichtungsleiste auf Platform Tools > Objects and Fields > "Object Manager".
   
4. Suchen Sie nach dem Objekttyp, für den Sie die Feldtypen sehen möchten, und klicken Sie auf dessen Objekt-"Label".
   
5. Klicken Sie in der Objekttyp-Seitenleiste (Beispiel hier „Fall“) auf „Felder & Beziehungen“ und überprüfen Sie die Spalte „Datentyp“ der Tabellen, um den Feldtyp jedes Feldes zu ermitteln, das Sie für diesen Objekttyp konfiguriert haben.
   
6. Ob es sich bei einem Feld um ein benutzerdefiniertes Feld oder ein Systemfeld handelt, können Sie anhand der Spalte „Feldname“ der Tabellen feststellen. Endet ein Feldname mit „__c“, handelt es sich um ein benutzerdefiniertes Feld.
   

Zusätzliche Einstellungen

Wenn die Option „ Unbekannte Elemente archivieren“ aktiviert ist, werden zuvor importierte Elemente in airfocus archiviert, wenn sie nicht mehr in Salesforce vorhanden sind oder nicht mehr unter die Filter setzen, bringen oder einstellen für die Integration fallen.

Wenn die Option „ Automatische Synchronisierung “ aktiviert ist, wird Ihre Integration automatisch alle 10 Minuten und jedes Mal synchronisiert, wenn Sie auf den Arbeitsbereich zugreifen.

Wenn Sie auf „ Protokolle anzeigen “ klicken, können Sie Ihre Salesforce-Integrationsaktivitätsprotokolle einsehen und sehen, welche Änderungen vor der letzten Synchronisierung vorgenommen wurden.

Um Ihre Einstellungen zu speichern und Ihre Elemente in airfocus zu importieren, wählen Sie „Aktualisieren und synchronisieren“.

Wichtige Hinweise

Das Salesforce-Konto, das zum Setzen, Bringen und Einrichten der Integration verwendet wurde, muss nicht unbedingt für die Nutzung der Integration verwendet werden. Solange die airfocus Nutzenden über gültige Consumer Keys und Secrets verfügen, können sie beliebig viele Integrationen zu dem verbundenen Salesforce einrichten.

Die Integration ist derzeit auf die Synchronisierung von max. 2000 Salesforce-Objekte.

Ihre verbundene App wird von Salesforce als „Nicht-SDFC-Anwendung“ betrachtet. Bitte lesen Sie die Haupt-Servicevereinbarung von Salesforce, wenn Sie deren Richtlinien zur Verwendung von Nicht-SDFC-Anwendungen und deren Verwendung für Integrationsdienste einsehen möchten.

Geben Sie uns Feedback zu diesem Artikel