Dziękujemy za opinię.

Przed kontynuowaniem upewnij się, że spełniasz następujące warunki wstępne:

• Użytkownik wykonujący konfigurację musi być administratorem organizacji Salesforce, w której ma być zainstalowana integracja.
• Ta integracja wymaga minimum Salesforce Enterprise Edition. Więcej informacji można znaleźć w sekcji Edycje Salesforce.
• Organizacja musi mieć skonfigurowany Webex z odpowiednimi licencjami dla wymaganych funkcji, w tym przesyłania wiadomości, spotkań i połączeń.
• Wszyscy użytkownicy korzystający z integracji muszą mieć dostęp do Salesforce i wymagane licencje Salesforce.
• Wszyscy użytkownicy muszą posiadać wymagane licencje Webex, aby móc korzystać z określonych funkcji Webex, takich jak Webex Meetings i Webex Calling z Salesforce.

  CUCM i Broadworks są obsługiwane z częściową funkcjonalnością. Aby uzyskać więcej informacji, zobacz O granicz enia połączeń w sekcji Połączenia.

• Ta integracja jest dostępna dla Salesforce Lightning.

  Jeśli chcesz używać składników Lightning, musisz wdrożyć Moja domena w swojej organizacji. Więcej informacji można znaleźć w sekcji My Domain Salesforce.

• Musisz skonfigurować dostęp użytkownika do integracji w organizacji.
  • Bez pakietu Pro Pack — jeśli masz podstawowe centrum sterowania, możesz zezwolić lub odmówić dostępu do wszystkich integracji dla wszystkich użytkowników.
  • Z pakietem Pro Pack — Dzięki pakiet owi Pro masz zaawansowane funkcje zarządzania dostępem użytkowników do integracji.

  Aby uzyskać więcej informacji, zobacz Konfigurowanie dostępu użytkownika do integracji.

W przypadku wersji integracji Webex Salesforce późniejszych niż 1.14 można teraz uaktual nić za pomocą Salesforce Exchange.

Aby zainstalować integrację Webex za pomocą Salesforce Exchange:

1. Przejdź do aplikacji Webex App for Salesforce w AppExchange.
2. Wybierz Pobierz teraz.
3. Wybierz Po łączoną organizację, w której chcesz zainstalować integrację.
4. Zainstaluj aplikację tylko dla administratorów.
5. Kontynuuj z Autoryzuj integrację Webex na karcie Zain staluj i administruj.

Zanim wykonasz czynności konfiguracyjne, musisz najpierw przejść do notatek o wersji i pobrać najnowszą wersję pakietu Webex App Salesforce.

Wymagania

Edycja Salesforce Enterprise

Ta integracja wymaga minimum Salesforce Enterprise Edition. Więcej informacji można znaleźć w sekcji Edycje Salesforce.

Moja domena w Salesforce org

Jeśli chcesz używać składników Lightning, musisz wdrożyć Moja domena w swojej organizacji. Więcej informacji można znaleźć w dokumentacji My Domain Salesforce.

Dostęp użytkownika w Control Hub

Musisz skonfigurować dostęp użytkownika do integracji w organizacji.

• Bez pakietu Pro Pack — jeśli masz podstawowe centrum sterowania, możesz zezwolić lub odmówić dostępu do wszystkich integracji dla wszystkich użytkowników.

• Z pakietem Pro Pack — Dzięki pakiet owi Pro masz zaawansowane funkcje zarządzania dostępem użytkowników do integracji.

Aby uzyskać więcej informacji, zobacz Konfigurowanie dostępu użytkownika do integracji.

Dzwonienie

• Webex Callingjest w pełni obsługiwany dla połączeń przychodzących i wychodzących do kontroli połączeń w Salesforce.

• Dzwonienie w Webex (Unified CM) jest częściowo obsługiwane. Tylko połączenia wychodzące otwierają wyskakujące okienko logowania do Salesforce. W przypadku połączeń przychodzących aplikacja Webex dzwoni, ale Salesforce nie może przechwycić połączenia, więc wyskakujące okienko rejestrowania nie jest wyświetlane.

Jeśli pracujesz z Webex dla Salesforce w wersji 1.18 lub starszej, musisz skonfigurować autoryzację Salesforce, zanim będzie można z nim pracować w Salesforce. Webex Calling

Tworzenie połączonej aplikacji

1. W sekcji Konfiguracja wyszukaj aplikację klienta zewnętrznego.

   

2. W obszarze Zewnętrzne aplikacje kli enckie wybierz Ustawienia.
3. Włącz opcję Z ezwalaj na tworzenie połączonych aplikacji. Jeśli przycisk Nowa połączona aplikacja jest już włączony, możesz utworzyć nową połączoną aplikację.

   

4. Aby utworzyć nową połączoną aplikację, kliknij Nowa aplikacja połącz ona i wprowadź wymagane szczegóły.

   

5. Wprowadź nazwę aplikacji połączonej, na przykład MyExample App.
6. Wprowadź adres e-mail kontak towy.
7. Zaznacz pole W łącz ustawienia OAuth.
8. Określ zastępczy adres URL wywołania zwrotnego (zaktualizujemy to później), na przykład. https://localhost/placeholder

   

9. Przewiń w dół i wybierz następujące zakresy OAuth:
   • Pełny dostęp (pełny)
   • Wykonuj żądania w dowolnym momencie (refresh_token,offline_access)

   

   Zakres Wykonuj żądania w dowolnym momencie umożliwia nazwane poświadczenia odświeżanie tokena dostępu po wygaśnięciu sesji.

10. Przewiń do dołu strony i kliknij przycisk Zap isz, a następnie kliknij przycisk Kontynuuj.
11. Na następnej stronie przewiń do interfejsu API (Włącz ustawienia OAuth) i kliknij Zarządzaj szczegółami konsumenta.

    

    Może być konieczne ponowne uwierzytelnienie za pomocą Salesforce.

12. Zanotuj klucz konsumenta i tajemnicę konsumenta.

    

Utwórz dostawcę auth

Następnie utwórz dostawcę uwierzytelniania, który ułatwi uwierzytelnianie w organizacji Salesforce.

1. W sekcji Konfiguracja wyszukaj Auth i wybierz polecenie Auth. Dostawcy. Kliknij Nowy.

   

2. Wybierz Salesforce jako typ dostawcy.
3. Wprowadź nazwę dostawcy Auth, na przykład Ap exMDTapi.
4. Wklej klucz konsumenc ki i tajemnicę konsumenta zapisane podczas konfigurowania aplikacji Connected.
5. Wprowadź pełne refresh_token offline_access w Zak resach domyślnych.
6. Pozostaw wszystko puste i kliknij Zap isz.

   

7. Skopiuj adres URL wywołania zwrotnego z sekcji Kon figuracja Salesforce.

   

8. Edytuj aplikację połączoną i zastąp adres URL symbolu zastępczego adresem URL wywołania zwrotnego skopiowanym z powyższej konfiguracji Salesforce.

   

9. Zapisz swoją połączoną aplikację.

   Ustawienia wejdą w życie i rozprzestrzeniają się w całej infrastrukturze Salesforce może zająć do 10 minut.

Utwórz nazwane dane uwierzytelniające

1. W U stawi eniach wyszukaj Nazwane i wybierz Nazwane poświadczenia. Kliknij Nowe dziedzictwo.

   

2. Wprowadź ApexMDT api w Etykiecie.
3. Wprowadź adres URL instancji swojej organizacji w adresie URL, na przykład https://na1.salesforce.com; lub, jeśli używasz Moja domena, w pełni kwalifikowaną nazwę Moja domena, taką jak https://mycompany.my.salesforce.com.
4. W polu Typ tożsamości wybierz Naz wany główny.
5. W polu Protokół uwierzytelniania wybierz polec enie OAuth 2.0.
6. W polu Dostawca uwierzytelniania wybierz wcześniej utworzonego dostawcę auth.
7. Wpis z peł refresh_token offline_access ny zakres.
8. Zaznacz pole obok opcji Rozpocz nij przepływ uwierzytelniania podczas zapisywania.

   

9. W obszarze Opcje odwołania zaznacz pole obok opcji Zezwalaj na scalanie pól w treści HTTP, a następnie kliknij przycisk Zap isz.

   

10. Zaloguj się do swojej organizacji. Po zalogowaniu kliknij opcję Zezwalaj w Zez walaj na dostęp.
11. Na ekranie N amed Credential Status oznacza Uwierzytelniony jako your-email@domain.com.

Utwórz swoją witrynę na ekranie administracyjnym Webex

Przejdź do Utwórz witrynę do połączeń w sekcji Po łączenia.

W przypadku integracji Webex dla Salesforce w wersji 1.19 i nowszej, postępuj zgodnie z instrukcjami zawartymi w tym artykule, aby usunąć istniejącą aplikację Webex Connected dla autoryzacji, nazwanych poświadczeń i dostawców auth, a następnie utworzyć nową aplikację Webex Connected dla autoryzacji Salesforce.

Usuń wszystkie istniejące aplikacje Webex Connected, nazwane dane uwierzytelniające i dostawców auth

Jeśli wcześniej utworzyłeś autoryzacje aplikacji Webex Connected, nazwane poświadczeniami lub dostawcą auth, musisz je usunąć przed kontynuowaniem. W przeciwnym razie, kontynuuj Tworzenie nowej aplikacji Webex Connected poniżej.

Usuń istniejącą aplikację Webex Connected:

1. W prawym górnym rogu strony docelowej Salesforce kliknij , a następnie wybierz Konfiguracja.
2. W polu teksto wym Szybkie wyszuki wanie wpisz Menedżer aplikacji, a następnie zaznacz go z listy.
3. Przewiń do aplikacji Webex Connected na liście, kliknij ikonę strzałki w dół po prawej stronie wpisu, a następnie wybierz Widok.
4. Wybierz Usuń, a następnie wybierz Usuń ponownie, gdy zostanie wyświetlony monit o potwierdzenie.

Usuń wszystkie istniejące dane uwierzytelniające Webex:

1. W polu teksto wym Szyb kie wyszukiwanie wpisz Nazwane poświadczenia, a następnie zaznacz je z listy.
2. Kliknij strzałkę w dół po prawej stronie wpisu danych uwierzytelniających o nazwie Webex, a następnie kliknij przycisk Usuń.
3. Kliknij przycisk Usuń ponownie, gdy zostanie wyświetlony monit o potwierdzenie.

Usuń wszystkich istniejących dostawców auth Webex:

1. W polu teksto wym Szyb kie wyszukiwanie wpisz Auth. Dostawcy, a następnie wybierz go z listy.
2. Wybierz łącze Del na początku wpisu dostawcy auth Webex.
3. Kliknij OK, gdy zostanie wyświetlony monit o potwierdzenie.

Przejdź do następnej sekcji, aby utworzyć nową aplikację Webex Connected do autoryzacji Salesforce .

Tworzenie nowej aplikacji Webex Connected do autoryzacji Salesforce

Aby utworzyć nową aplikację Webex Connected dla autoryzacji Salesforce:

1. W prawym górnym rogu strony docelowej Salesforce kliknij , a następnie wybierz Konfiguracja.
2. Pobierz adres URL domeny: w sekcji Szyb kie wyszukiwanie wyszukaj i wybierz Domen y, a następnie zapisz adres URL z mojej domeny.
3. W sekcji Konfiguracja wyszukaj aplikację klienta zewnętrznego.

   

4. W obszarze Zewnętrzne aplikacje kli enckie wybierz Ustawienia.
5. Włącz opcję Z ezwalaj na tworzenie połączonych aplikacji. Jeśli przycisk Nowa połączona aplikacja jest już włączony, możesz utworzyć nową połączoną aplikację.

   

6. Aby utworzyć nową połączoną aplikację, kliknij Nowa aplikacja połącz ona i wprowadź wymagane szczegóły.

   

7. W polu teksto wym Szyb kie wyszukiwanie wprowadź Menedżera aplikacji i wybierz go z listy.
8. Wprowadź nazwę aplikacji połączonej, na przykład autoryzacja Webex Salesforce .
9. Wprowadź adres e-mail dla adresu e-mail kontaktowego.
10. Zaznacz pole W łącz ustawienia OAuth.
11. Wprowadź dwa adresy URL wywołań zwrotnych, używając wcześniej pobranego adresu URL, po jednym na wiersz i dodając /apex/ webexsfdcauthi /apex/ cisco_webex__webexsfdcauthjako przyrostki. Na przykład:

    https://my-company.my.salesforce.com/apex/webexsfdcauth

    https://my-company.my.salesforce.com/apex/cisco_webex__webexsfdcauth

12. Wybierz następujące lunety z listy Dostępne lunety OAuth w wybranych zakresach O Auth:
    • Pełny dostęp (pełny)
    • Wykonuj żądania w dowolnym momencie (refresh_token,offline_access)
13. Usuń zaznaczenie pola dla rozszerzenia Wymagaj klucza prowodowego dla wymiany kodu (PKCE) dla obsługi wanych przepływów autoryzacji.
14. Kliknij przycisk Zapisz.
15. Kopiuj i bezpiecznie zapisz klucz konsumenta i tajemnicę konsumenta. Te wartości są potrzebne podczas konfigurowania autoryzacji Salesforce w Control Hub.

W przypadku integracji Webex for Salesforce w wersji 1.22 i nowszej skonfiguruj autoryzację Salesforce za pomocą aplikacji klienta zewnętrznego. Jeśli masz już Połączoną aplikację do autoryzacji Webex Salesforce, możesz ją przenieść do zewnętrznej aplikacji klienta i zachować jej klucz konsumencki.

Zanim zaczniesz

• Potrzebujesz dostępu do administratora systemu Salesforce.
• Moja domena musi być włączona w organizacji Salesforce.

Odzyskaj adres URL mojej domeny

1. W prawym górnym rogu strony docelowej Salesforce kliknij , a następnie kliknij przycisk Konfiguracja.
2. W polu Szybkie wyszuki wanie wyszukaj domeny i zaznacz je.
3. Zanotuj swój adres URL mojej domeny. Użyjesz go do skonfigurowania adresów URL wywołań zwrotnych. Na przykład Twój adres URL może być https://my-company.my.salesforce.com.

Tworzenie nowej aplikacji klienta zewnętrznego

1. W sekcji Konfiguracja wyszukaj Menedżera aplikacji w polu Szybkie wyszuki wanie i zaznacz go.
2. Kliknij opcję Nowa aplikacja klienta zewnętrznego.

   Wprowadź następujące dane:

   • Nazwa zewnętrznej aplikacji klienta — autoryzacja Webex Salesforce
   • Nazwa API — Webex_Salesforce_Authorization(automatyczne wypełnianie)
   • Kontakt e-mail — Twój adres e-mail administratora
   • Stan dystrybucji — lokalny

3. Kliknij przycisk Utwórz.

Konfigurowanie ustawień OAuth

1. W obszarze API (Włącz ustawienia OAuth) kliknij opcję W łącz OAuth.
2. Skonfiguruj adresy URL wywołań zwrotnych. Zastą [your-domain]p na wartość Salesforce Moja domena i wprowadź każdy adres URL w osobnym wierszu:
   • https://[your-domain].my.salesforce.com/apex/webexsfdcauth
   • https://[your-domain].my.salesforce.com/apex/cisco_webex__webexsfdcauth
3. Dodaj te lunety OAuth do wybranych zakresów OAuth:
   • Pełny dostęp (full)
   • Wykonuj żądania w dowolnym momencie (refresh_token, offline_access)
4. W obszarze Zabez pieczenia zaz nacz opcję Wymagaj klucza potwierdzającego wymianę kodu (PKCE).
5. Kliknij przycisk Utwórz.

Odzyskaj klucz konsumenta i tajemnicę konsumenta

1. W sekcji Konfiguracja wybierz Menedżer aplikacji > Mened żer aplikacji zewnętrznego klienta.
2. Kliknij Webex Salesforce Autoryzacja.
3. Kliknij kartę U stawienia, a następnie otwórz Ustawienia OAuth.
4. Kliknij K lucz konsumencki i sekret.
5. Sprawdź swój adres e-mail pod kątem kodu weryfikacyjnego od Salesforce.
6. Na stronie Z weryfikuj swoją tożsamość wprowadź kod i kliknij Z weryfikuj.
7. Kopiuj i bezpiecznie zapisz klucz konsumenta i tajemnicę konsumenta. Te wartości są potrzebne podczas konfigurowania autoryzacji Salesforce w Control Hub.

Migracja istniejącej aplikacji połączonej

Jeśli masz już Połączoną aplikację do autoryzacji Webex Salesforce, przenieś ją do zewnętrznej aplikacji klienta. Zachowuje to klucz konsumencki, zachowuje ważne istniejące tokeny i przenosi ustawienia OAuth. Oryginalna aplikacja połączona pozostaje po migracji.

1. W konfiguracji wyszukaj Menedżera aplikacji i wybierz go.
2. Znajdź istniejącą aplikację połączoną, kliknij strzałkę w dół po prawej stronie jej wiersza i wybierz opcję Widok.
3. Na stronie Szczegóły aplikacji połączonej kliknij opcję Migracja do zewnętrznej aplikacji klienckiej.
4. Przejrzyj podsumowanie migracji, a następnie kliknij przycisk Migracja.
5. Po zakończeniu migracji Salesforce otwiera nową stronę szczegółów aplikacji klienta zewnętrznego.

Weryfikacja migracji

1. W U stawieniach wybierz polecenie Menedżer aplikacji > Mened żer aplikacji zewnętrznego klienta.
2. Potwierdź, że na liście pojawi się autoryzacja Webex Salesforce.
3. Kliknij aplikację i sprawdź, czy karta Ustawienia wyświetla prawidłowe adresy URL wywołań zwrotnych i zakresy OAuth:
   • Pełny dostęp (full)
   • Wykonuj żądania w dowolnym momencie (refresh_token, offline_access)
4. (Opcjonalnie) Pobierz klucz konsumencki i tajemnicę konsumenta i potwierdź, że są zgodne z oryginalnymi wartościami.

Dezaktywuj oryginalną aplikację Connected (opcjonalnie)

Po sprawdzeniu, czy aplikacja klienta zewnętrznego działa, wykonaj następujące czynności:

1. W sekcji Konfiguracja wybierz Menedżer aplikacji.
2. Znajdź oryginalną aplikację Connected i kliknij strzałkę w dół po prawej stronie jej wiersza.
3. Wybierz Zarządzaj.
4. W obszarze Zasady OAuth ustaw Doz woleni użytkownicy, aby blokowały nowe uprawnienia lub pozostawały aktywne Połączone aplikacje w okresie przejściowym.

Zalecamy zachowanie aktywnej oryginalnej aplikacji Connected przez krótki okres przejściowy, aby integracje działały jeszcze przed jej dezaktywacją.

Gdy nowy pakiet jest dostępny, wykonaj czynności opisane powyżej w sekcji Zainstaluj aplikację Webex w Salesforce. Nie musisz najpierw odinstalować starej wersji i nie stracisz skonfigurowanych ustawień.

Aby zapoznać się z informacjami na temat nowych pakietów instalacyjnych i miejsca ich pobierania, zobacz informacje o wydaniu integracji Webex Salesforce.

Aby włączyć lub wyłączyć historię połączeń:

1. Przejdź do Webex Admin.
2. Przewiń w dół do historii połączeń Webex.
3. Przełącz przełącznik na żądane ustawienie, włączone lub wyłączone.

   Po włączeniu Historia połączeń jest dostępna dla wszystkich użytkowników i profili.

Dla użytkowników CUCM i Broadworks następujące funkcje nie są obsługiwane:

• Odbieranie połączeń przychodzących w globalnym dialerze Salesforce (aplikacja Webex nadal będzie odbierać połączenia przychodzące)
• Wyświetlanie czasu trwania połączeń w oknie dziennika połączeń Salesforce po pomyślnym nawiązaniu połączenia wy chodzącego
• Zakończanie połączeń za pomocą przycisku w oknie dziennika połączeń Salesforce po pomyślnym nawiązaniu połączenia wychodzącego
• Automatyczne wypełnianie czasu trwania połączeń w oknie dziennika połączeń Salesforce po zakończeniu połączenia wychodzącego

W przypadku wszystkich integracji Salesforce należy zwrócić uwagę na następujące ograniczenia:

• Salesforce wprowadza ograniczenie liczby zdarzeń (25 000), które może spowodować niepowodzenie integracji przy intensyw nym użytkowaniu. Pakiety Salesforce są dostępne w celu zwiększenia tego limitu. Aby uzyskać więcej informacji, zobacz https://developer.salesforce.com/docs/atlas.en-us. platform_events.meta/platform_events/platform_event_limits.htm.

• Komponenty narzędzia wywołującego Webex nie są dostępne w aplikacji mobilnej Salesforce.