Zintegruj airfocus z Salesforce

Korzyści z korzystania z integracji Salesforce

Nasza integracja z Salesforce umożliwia zbieranie informacji zwrotnych bezpośrednio z Twoich przypadków i możliwości Salesforce. Łatwo importuj i centralizuj dane wejściowe z Salesforce do airfocus i informuj o wykrywaniu produktów.

• Bezproblemowo importuj sprawy i szanse Salesforce jako elementy do airfocus do /utworz/ Podsumowanie w celu odnalezienia produktów i ustalenia ich priorytetów.
• Możliwość elastycznego mapowania wielu pól systemowych Salesforce na pola airfocus.

Wymagania

Aby móc korzystać z integracji Salesforce, użytkownicy muszą upewnić się, że spełniają następujące wymagania:

Na aerogusie

• Użytkownicy muszą mieć „pełne” uprawnienia dostępu do obszaru roboczego.
• airfocus Zespół wymaga wykupienia abonamentu „Przedsiębiorstwo”.

Na Salesforce

Użytkownik używany do skonfigurowania integracji musi być przypisany do profilu, który musi mieć:

• Przynajmniej uprawnienia do odczytu wszystkich obiektów/informacji, które powinny być zsynchronizowane poprzez integrację
• Ustawienia „Włączone API” i „Zarządzaj połączonymi aplikacjami” zostały włączone. Administratorzy systemu mogą to sprawdzić dla dowolnego ze swoich skonfigurowanych profili poprzez Setup > Administration Setup > Manage Users > Profiles
• Domyślnie po utworzeniu aplikacji w Salesforce, opcja „Wymagaj klucza dowodu dla wymiany kodu (PKCE) dla obsługiwanych przepływów autoryzacji” jest włączona. Ta flaga musi być wyłączona.

Dodatkowe do synchronizacji „przypadków”:

• Organizacja Salesforce musi być subskrybentem Salesforce Service Cloud i musi mieć dostęp do „Web Services API”, który jest obecnie dostępny w edycjach „Professional” (płatna dodatkowo), „Przedsiębiorstwo” i „Unlimited”.
  

Dodatkowe do synchronizacji „możliwości”:

• Organizacja Salesforce musi być subskrybentem Salesforce Sales Cloud i musi mieć dostęp do „interfejsu Web Services API”, który jest obecnie dostępny w edycjach „Professional” (płatna dodatkowo), „Przedsiębiorstwo” i „Unlimited”.
  

Konfigurowanie integracji

Konfigurowanie integracji jest łatwe i powinno zająć tylko kilka minut. Oto jak to zrobić:

Zaloguj się do airfocus

Najpierw zarejestruj się w airfocus lub zaloguj się na swoje istniejące konto. /utworz/ nowy obszar roboczy w airfocus lub wybierz ten, z którym chcesz zintegrować Salesforce.

Dodaj integrację Salesforce do airfocus

Należy pamiętać, że integracja zawsze łączy się z jednym konkretnym obszarem roboczym airfocus. Do danego obszaru roboczego można dodać wiele integracji Salesforce.

Aby skonfigurować integrację, przejdź do " Zarządzaj integracjami " w rozszerzeniach i połącz się z Salesforce.

Na następnym ekranie musisz wybrać " Podłącz nową instancję Salesforce " z menu rozwijanego. Jeśli wcześniej nawiązałeś połączenie z instancjami Salesforce w swoim Zespole, wszystkie dostępne instancje Salesforce zostaną wyświetlone na tej liście rozwijanej. Możesz /utworzyć/ dowolną liczbę integracji Salesforce z jedną instancją Salesforce.

Następnie musisz nadać swojemu nowemu połączeniu instancji Salesforce nazwę (która zostanie później wyświetlona na airfocus). Poniżej możesz wstawić klucz konsumencki (identyfikator klienta) i tajemnicę klienta (Secret klienta) swojej aplikacji Salesforce Connected, aby móc połączyć się z Salesforce.

Skonfiguruj połączoną aplikację w Salesforce

1. Zaloguj się do swojej organizacji Salesforce.
2. Otwórz stronę ustawień dla podłączonych aplikacji:
   • jeśli korzystasz z Salesforce Classic poprzez Ustawienia > Ustawienia aplikacji > /utworz/ > Aplikacje.
     
   • jeśli korzystasz z Salesforce Lightning za pośrednictwem Setup > Platform Tools > Apps > App Manager.
     
     
3. /utworz/ nową połączoną aplikację:
   • jeśli korzystasz z Salesforce Classic : W sekcji połączonych aplikacji kliknij „Nowy”.
     
   • jeśli korzystasz z Salesforce Lightning : Obok " Lightning Experience App Manger " kliknij " Nowa aplikacja połączona ".
     
4. Wypełnij sekcję podstawowych informacji:
   • Nazwa podłączonej aplikacji: na przykład „airfocus”.
   • Nazwa API: na przykład „airfocus”.
   • Kontakt e-mail: Twój adres e-mail.
     
5. W sekcji API (Włącz ustawienia OAuth):
   • Zaznacz pole „Włącz ustawienia OAuth”
   • W zależności od serwera airfocus (patrz uwaga poniżej) - skopiuj ten adres URL wywołania zwrotnego:
     • Serwer europe jski: https://app.airfocus.com/api/integration-providers/salesforce/callback i wklej go do pola " Callback URL ".
     • Serwer USA: https://app.airfocus.com/api/integration-providers/salesforce/callback i wklej go do pola " Callback URL ".
     • Nowy serwer w USA (jeśli znajdujesz się w USA lub regionie Azji i Pacyfiku, a Twoje konto zostało utworzone /utworz/ po wrześniu 2025 r.): https://app.airfocus.app/api/integration-providers/salesforce/callback i wklej go do pola " Callback URL ".
   • W wybranych zakresach OAuth dodaj następujące zakresy:
     • Zarządzaj danymi użytkownika za pomocą interfejsów API (api).
     • Wykonuj żądania w dowolnym momencie (refresh _token, offline_access).
       
     • Uwaga: aby znaleźć lokalizację serwera airfocus, sprawdź adres URL airfocus, jeśli zawiera us.airfocus, znajduje się w USA, jeśli nie, to jest w Europie. Na przykład: teamname.us.airfocus.com zamiast teamname.airfocus.com
     • Należy pamiętać, że jeśli znajdujesz się w Stanach Zjednoczonych lub regionie Azji i Pacyfiku, a Twoje konto miało nazwę /utworz/ po wrześniu 2025 r., adres URL będzie wyglądał następująco: teamname.airfocus.app
6. Kliknij „Zapisz”. Następny ekran poinformuje Cię, że być może będziesz musiał poczekać do 10 minut na zastosowanie zmian. Kliknij " Kontynuuj ". Poczekaj 10 minut.
   

Uwaga: Zostaniesz przekierowany na stronę zarządzania połączonej aplikacji, dzięki czemu możesz kontynuować bezpośrednio z 4. w następnej sekcji tego przewodnika.

Podłącz airfocus do Salesforce

1. Zaloguj się do swojej organizacji Salesforce.
2. Otwórz stronę ustawień dla podłączonych aplikacji:
   • jeśli korzystasz z Salesforce Classic poprzez Ustawienia > Ustawienia aplikacji > /utworz/ > Aplikacje.
     
   • jeśli korzystasz z Salesforce Lightning za pośrednictwem Setup > Platform Tools > Apps > App Manager.
     
3. Otwórz przegląd aplikacji Connected:
   • jeśli korzystasz z Salesforce Classic w sekcji „Połączone aplikacje” kliknij nazwę podłączonej aplikacji dla airfocus.
     
   • jeśli korzystasz z Salesforce Lightning w tabeli kliknij strzałkę rozwijanej aplikacji i kliknij " Wyświetl ".
     
4. W sekcji „API (Włącz ustawienia OAuth)” kliknij „Zarządzaj szczegółami konsumenta”.
   
5. Być może będziesz musiał zweryfikować swoją tożsamość za pomocą Salesforce.
6. Skopiuj „Klucz konsumencki” i " Consumer Secret " i wklej je do odpowiednich pól w konfiguracji integracji Airfocus Salesforce.
   
   
7. Kliknij „Połącz” na airfocus.
8. Zostaniesz przekierowany na ekran potwierdzenia Salesforce. Kliknij " Zezwalaj na ".
   

Skonfiguruj integrację

Możesz nazwać integrację, wprowadzając nazwę w polu " Nazwa " znajdującym się u góry strony ustawień integracji Salesforce. Ta nazwa będzie wyświetlana w przeglądzie integracji i wyskakującym okienku rozszerzeń, aby ułatwić identyfikację.

Filtry

Wybierz typ obiektu Salesforce, który chcesz zaimportować/zsynchronizować z airfocus. Integracja obsługuje obecnie przypadki i możliwości Salesforce. Jeśli chcesz zsynchronizować oba typy obiektów, musisz skonfigurować pojedynczą integrację dla każdego z nich (oba mogą łączyć się za pośrednictwem tej samej instancji Salesforce, więc nie musisz tworzyć połączonej aplikacji dla każdego typu obiektu).

Wybierz datę za pomocą selektora dat w polu „Importuj obiekty /utworz/ po”, aby zaimportować tylko te obiekty, których data /utworz/ została ustalona po wybranej dacie. Jeśli nie podasz tutaj daty, integracja zaimportuje wszystkie obiekty Salesforce wybranego typu.

Możesz dalej filtrować obiekty, które powinny być zsynchronizowane, wprowadzając warunek WHERE dla języka zapytań obiektów Salesforce (SOQL). Połącz wiele warunków z AND lub OR. Jeśli wybierzesz datę rozpoczęcia w powyższym polu, zostanie ona domyślnie dodana do klauzuli WHERE. Wszystkie pola, do których się tu odwołuje, muszą mieć odwzorowanie zdefiniowane w sekcji " Mapowanie pola " poniżej. Dowiedz się więcej.

Mapowanie pola

Użyj mapowania, aby określić, w jaki sposób informacje z Salesforce powinny być mapowane do airfocus. Nazwy elementów i opisy elementów są zawsze domyślnie mapowane podczas konfigurowania nowej integracji i opcjonalnie można je usunąć lub zmodyfikować.

Jak dodać nowe mapowanie pól

Podczas wybierania pola z menu rozwijanego, tylko pola odpowiadające typowi pola będą wyświetlane w menu rozwijanym na końcu ostrości airfocus. Nasza integracja umożliwia mapowanie pól głównego typu obiektu (wybranego powyżej) oraz pól bezpośrednio połączonych obiektów.

W poniższym przykładzie użytkownik wybrał " Case " jako typ obiektu Salesforce do importowania/synchronizacji. Pole " Priority " (zaznaczone na czerwono) jest polem systemowym obiektu " Case ". Pole " Case ID " (oznaczone na zielono) jest polem systemowym obiektu " MasterRecord ", który jest obiektem bezpośrednio połączonym z " Case ".

Mówiąc prościej: Jeśli pole znajduje się maksymalnie jedno kliknięcie od zsynchronizowanego obiektu w Salesforce, możesz zmapować je do elementu airfocus (obowiązują warunki opisane w tym artykule).

Integracja umożliwia obecnie synchronizację informacji " w jedną stronę " z Salesforce do airfocus.

Po wybraniu dwóch pól, które chcesz zmapować, możesz wybrać opcje pól i sposób ich mapowania. Możesz także zmapować wiele opcji pól Salesforce na jedną opcję pola airfocus.

Dostępne typy pól do mapowania

Integracja umożliwia obecnie tylko synchronizację pól systemowych " w jedną stronę " z Salesforce do airfocus. Oto lista możliwych mapowań pól, które możesz skonfigurować:

Jak określić typ pola dla pól Salesforce

Listę wszystkich pól dostępnych/skonfigurowanych w typie obiektu Salesforce (np. „Case” lub „Opportunity”) można znaleźć w ustawieniach Salesforce:

1. Zaloguj się do organizacji Salesforce, z którą łączysz się z airfocus.
2. Na głównym pulpicie nawigacyjnym Salesforce kliknij koło ustawień obok awatara profilu i kliknij „Konfiguracja”.
   
3. Na pasku po stronie konfiguracji kliknij Narzędzia platformy > Obiekty i pola > „Menedżer obiektów”.
   
4. Poszukaj typu obiektu, dla którego chcesz zobaczyć typy pól i kliknij jego „etykiet ę” obiektu.
   
5. Na pasku bocznym typu obiektu (przykład „Case” tutaj) kliknij „Relacje pól &” i przejrzyj kolumnę „Typ danych” tabeli, aby określić typ pola dowolnego pola skonfigurowanego dla tego typu obiektu.
   
6. Możesz określić, czy pole jest polem niestandardowym czy systemowym, przeglądając kolumnę „Nazwa pola” tabeli. Jeśli nazwa pola kończy się na „__c”, jest to pole niestandardowe.
   

Dodatkowe ustawienia

Gdy "Archiwizuj nieznane elementy " jest włączona, wcześniej zaimportowane elementy zostaną zarchiwizowane w airfocus, jeśli nie są już obecne w Salesforce lub nie należą już do filtrów ustawionych do integracji.

Gdy "Automatyczna synchronizacja " jest włączona, integracja będzie automatycznie synchronizowana co 10 minut i za każdym razem, gdy uzyskasz dostęp do obszaru roboczego.

Po kliknięciu przycisku „ Wyświetl logi ” możesz wyświetlić logi panelu integracji Salesforce i sprawdzić, jakie zmiany zostały wprowadzone przed ostatnią synchronizacją.

Aby zapisać ustawienia i zaimportować elementy do airfocus, " Aktualizuj i zsynchronizuj ".

Ważne uwagi

Konto użytkownika Salesforce używane do skonfigurowania integracji niekoniecznie musi być używane do korzystania z integracji. Dopóki użytkownicy airfocus mają ważne klucze i tajemnice konsumenckie, mogą skonfigurować tyle integracji z połączonym Salesforce, ile chcą.

Integracja jest obecnie ograniczona do synchronizacji max. 2000 obiektów Salesforce.

Twoja podłączona aplikacja jest uważana za " Non-SDFC Application " przez Salesforce. Zapoznaj się z główną umową serwis ową Salesforce, jeśli chcesz zapoznać się z ich zasadami dotyczącymi korzystania z Aplikacji innych niż SDFC i korzystania z nich w usługach integracyjnych.

Przekaż opinię na temat tego artykułu