Ďakujeme za vašu spätnú väzbu.

Pred pokračovaním sa uistite, že spĺňate nasledujúce predpoklady:

• Používateľ vykonávajúci nastavenie musí byť správcom organizácie Salesforce, v ktorej má byť integrácia nainštalovaná.
• Táto integrácia vyžaduje minimálnu verziu Salesforce Enterprise Edition. Ďalšie informácie nájdete v časti Salesforce Editions.
• Organizácia musí mať Webex nakonfigurovaný so správnymi licenciami pre požadované funkcie vrátane odosielania správ, stretnutí a volaní.
• Všetci používatelia používajúci integráciu musia mať prístup Salesforce a požadované licencie Salesforce.
• Všetci používatelia musia mať požadované licencie Webex, aby mohli používať špecifické funkcie Webex, ako napríklad Salesforce Webex Meetings a Webex Calling z neho.

  CUCM a Broadworks sú podporované čiastočnou funkčnosťou. Ďalšie podrobnosti nájdete v časti Obmedzenia volania v sekcii Volanie.

• Táto integrácia je k dispozícii pre Salesforce Lightning.

  Ak chcete používať komponenty Lightning, musíte nasadiť Moja domé na vo svojej organizácii. Ďalšie informácie nájdete v téme Moja doména Salesforce.

• Musíte nakonfigurovať prístup používateľov k integráciám vo vašej organizácii.
  • Bez balíka Pro Pack — Ak máte základné ovládacie centrum, môžete všetkým svojim používateľom povoliť alebo zakázať prístup ku všetkým integráciám.
  • S balíkom Pro Pack — S balí kom Pro Pack máte pokročilé funkcie na správu prístupu používateľov k integráciám.

  Ďalšie informácie nájdete v téme Konfigurácia prístupu používateľov k integráci ám.

Pre verzie integrácie Webex Salesforce neskôr ako 1.14 môžete aktualiz ovať pomocou služby Salesforce Exchange.

Inštalácia integrácie Webex pomocou služby Salesforce Exchange:

1. Prejdite do aplikácie Webex App for Salesforce v aplikácii AppExchange.
2. Vyberte položku Získať teraz.
3. Vyberte pripojenú organiz áciu, do ktorej chcete nainštalovať integráciu.
4. Nainštalujte aplikáciu iba pre správcov.
5. Pokračujte s Autorizovať integráciu Webex na karte In štalácia a správa .

Predtým, ako budete postupovať podľa krokov konfigurácie, musíte najprv prejsť na poznámky k vydaniu a stiahnuť najnovšiu verziu balíka Webex App Salesforce Package.

Požiadavky

Podniková edícia Salesforce

Táto integrácia vyžaduje minimálnu verziu Salesforce Enterprise Edition. Ďalšie informácie nájdete v časti Salesforce Editions.

Moja doména v Salesforce org

Ak chcete používať komponenty Lightning, musíte nasadiť Moja domé na vo svojej organizácii. Ďalšie informácie nájdete v dokumentácii My Domain Salesforce.

Prístup používateľa v Control Hub

Musíte nakonfigurovať prístup používateľov k integráciám vo vašej organizácii.

• Bez balíka Pro Pack — Ak máte základné ovládacie centrum, môžete všetkým svojim používateľom povoliť alebo zakázať prístup ku všetkým integráciám.

• S balíkom Pro Pack — S balí kom Pro Pack máte pokročilé funkcie na správu prístupu používateľov k integráciám.

Ďalšie informácie nájdete v téme Konfigurácia prístupu používateľov k integráci ám.

Volanie

• Webex Callingje plne podporovaný pre prichádzajúce a odchádzajúce hovory pre riadenie hovorov v Salesforce.

• Volanie vo Webex (Unified CM) je čiastočne podporované. Iba odchádzajúce hovory otvárajú kontextové okno prihlasovania do Salesforce. V prípade prichádzajúcich hovorov zazvoní aplikácia Webex, ale Salesforce nemôže hovor zachytiť, takže kontextové okno protokolovania sa nezobrazuje.

Ak pracujete s Webex pre Salesforce vo verzii 1.18 alebo staršej, musíte nakonfigurovať autorizáciu Salesforce predtým, ako budete môcť pracovať v Salesforce. Webex Calling

Vytvorenie pripojenej aplikácie

1. V časti Nastavenie vyhľadajte aplikáciu External Client App.

   

2. V časti Externé klientske aplikácie vyberte položku Nastavenia.
3. Zapnite možnosť Pov oliť vytváranie pripojených aplikácií. Ak je už tlačidlo Nová pripojená aplikácia povolené, môžete pokračovať a vytvoriť novú pripojenú aplikáciu.

   

4. Ak chcete vytvoriť novú pripojenú aplikáciu, kliknite na položku Nová pripojená aplik ácia a zadajte požadované podrobnosti.

   

5. Zadajte názov pripojenej aplikácie, napríklad MyExample App.
6. Zadajte kontaktnú e-mailovú adresu.
7. Začiarknite políčko Povoli ť nastavenia OAuth.
8. Zadajte zástupnú adresu URL spätného volania (aktualizujeme to neskôr), napr. https://localhost/placeholder

   

9. Prejdite nadol a vyberte nasledujúce rozsahy OAuth:
   • Plný prístup (plný)
   • Vykonávať požiadavky kedykoľvek (refresh_token,offline_access)

   

   Rozsah Vykonávanie požiadaviek kedykoľvek umožňuje pomenovaným poverením obnoviť prístupový token po uplynutí platnosti relácie.

10. Prejdite do spodnej časti stránky a kliknite na položku Uložiť a potom kliknite na tlačidlo Pok račovať.
11. Na ďalšej stránke prejdite na rozhranie API (Povoliť nastavenia OAuth) a kliknite na položku Spravovať podrobnosti o spotrebiteľovi.

    

    Možno budete musieť opätovnú autentifikáciu pomocou Salesforce.

12. Zaznamenajte si spotrebiteľský kľúč a spotrebit eľské tajomstvo.

    

Vytvorte poskytovateľa autorizácie

Potom vytvorte poskytovateľa autentifikácie, ktorý uľahčí autentifikáciu s vašou organizáciou Salesforce.

1. V časti Nastavenie vyhľadajte položku Auth a vyberte položku Auth. Poskytovatelia. Kliknite na polož ku Nov ý.

   

2. Ako typ poskytovateľa vyberte položku Salesforce.
3. Zadajte názov poskytovateľa Auth, napríklad Ap exMDTapi.
4. Prilepte Spotrebit eľský kľúč a spotrebiteľské tajom stvo, ktoré ste uložili pri konfigurácii pripojenej aplikácie.
5. Zadajte úplné refresh_token offline_access v predvolenom rozsahu.
6. Všetko ostatné nechajte prázdne a kliknite na položku Uložiť.

   

7. Skopírujte adresu URL spätného vol ania z časti Kon figurácia Salesforce.

   

8. Upravte svoju pripojenú aplikáciu a nahraďte adresu zástupného symbolu adresou URL spätného vol ania, ktorú ste skop írovali z vyššie uvedenej konfigurácie Salesforce.

   

9. Uložte svoju pripojenú aplikáciu.

   Môže trvať až 10 minút, kým nastavenia nadobudnú účinnosť a rozšíria sa po celej infraštruktúre Salesforce.

Vytvorenie pomenovaného poverenia

1. V časti Nastavenie vyhľadajte položku Nomen ované a vyberte položku N omenované poverenia. Kliknite na polož ku Nové dedič stvo.

   

2. Zadajte ApexMDT api v štítku.
3. Zadajte adresu URL inštancie vašej organizácie do adresy URL adresy, napríklad https://na1.salesforce.com; alebo ak používate Moja domé na, plne kvalifikovaný názov Moja domé na, napríklad https://mycompany.my.salesforce.com.
4. V časti Typ identity vyberte položku N ázov hlavný.
5. V časti Protokol overovania vyberte položku OAuth 2.0.
6. V časti Poskytovateľ autentifik ácie vyberte poskytovateľa autorizácie, ktorý ste vytvorili predtým.
7. Zadajte úplnú refresh_token offline_access časť Rozsah.
8. Začiarknite políčko vedľa položky S pustiť tok overovania pri uložení.

   

9. V časti Možnosti odvolania za čiarknite políčko vedľa položky Povoliť zlúčenie polí v tele HTTP a potom kliknite na položku Uložiť.

   

10. Prihláste sa do svojej organizácie. Po prihlásení kliknite na polož ku Povoli ť prístup.
11. Na obrazovke N omenované prihlas ovacie údaje označ uje Stav ove rený ako your-email@domain.com.

Vytvorte si stránku na obrazovke správcu Webex

Pokračujte v položke Vytvorenie lokality pre volanie v se kci i Volanie.

V prípade integrácií Webex pre Salesforce vo verzii 1.19 a novších postupujte podľa pokynov v tomto článku a odstráňte všetky existujúce aplikácie Webex Connected pre autorizácie, pomenované poverenia a poskytovateľov autorizácie a potom vytvor te novú Webex Connected App pre autorizáciu Salesforce.

Odstráňte všetky existujúce aplikácie Webex Connected, pomenované poverenia a poskytovateľov autorizácie

Ak ste už predtým vytvorili autorizácie aplikácie Webex Connected App, pomenované poverenia alebo poskytovateľ autor izácie, musíte ich pred pokračovaním odstrániť. V opačnom prípade pokračujte v položke Vytvorenie novej aplikácie Webex Connected nižšie.

Odstráňte svoju existujúcu aplikáciu Webex Connected:

1. V pravom hornom rohu vstupnej stránky Salesforce kliknite na a potom vyberte položku Nastavenie.
2. Do texto vého po ľa Rýchle vyhľadávanie zad ajte Správca aplik ácií a vyberte ho zo zoznamu.
3. V zozname prejdite na aplikáciu Webex Connected, kliknite na ikonu šípky nadol napravo od položky a potom vyberte položku Zobraziť.
4. Vyberte polož ku Odstrá niť a potom znova vyberte možnosť Odstrá niť, keď sa zobrazí výzva na potvrdenie.

Odstráňte všetky existujúce poverenia Webex s názvom:

1. Do texto vého poľa Rýchle vyhľadávanie zad ajte Nomen ované poverenia a potom ich vyberte zo zoznamu.
2. Kliknite na šípku nadol napravo od položky poverení s názvom Webex a potom kliknite na položku Odstrániť.
3. Po zobrazení vý z vy na potvrdenie znova kliknite na položku Odstrániť.

Odstráňte všetkých existujúcich poskytovateľov Webex Auth:

1. Do textového poľa R ýchle vyhľadávanie zadajte Auth. Poskytovatelia, potom ho vyberte zo zoznamu.
2. Vyberte odkaz Del na začiatku záznamu poskytovateľa autorizácie Webex.
3. Keď sa zobrazí výzva na potvrdenie, kliknite na tlačidlo OK.

Pokračujte do ďalšej časti a vytvorte novú Webex Connected App pre autorizáciu Salesforce .

Vytvorenie novej aplikácie Webex Connected pre autorizáciu Salesforce

Vytvorenie novej Webex Connected App pre autorizáciu Salesforce:

1. V pravom hornom rohu vstupnej stránky Salesforce kliknite na a potom vyberte položku Nastavenie.
2. Načítajte adresu URL dom ény: v časti Rýchle vyhľad ávanie vyhľadajte a vyberte položku Domény a uložte adresu URL z časti Moja domé na.
3. V časti Nastavenie vyhľadajte aplikáciu External Client App.

   

4. V časti Externé klientske aplikácie vyberte položku Nastavenia.
5. Zapnite možnosť Pov oliť vytváranie pripojených aplikácií. Ak je už tlačidlo Nová pripojená aplikácia povolené, môžete pokračovať a vytvoriť novú pripojenú aplikáciu.

   

6. Ak chcete vytvoriť novú pripojenú aplikáciu, kliknite na položku Nová pripojená aplik ácia a zadajte požadované podrobnosti.

   

7. V texto vom poli R ýchle vyhľadávanie zadajte Správca aplik ácií a vyberte ho zo zoznamu.
8. Zadajte názov pripojenej aplikácie, napríklad Webex Salesforce Authorization.
9. Zadajte e-mailovú adresu pre Kontaktný e-mail.
10. Začiarknite políčko Povoli ť nastavenia OAuth.
11. Zadajte dve adresy URL spätného volania pomocou adresy URL, ktorú ste načítali predtým, jednu na riadok a pridaním prípony /apex/ webexsfdcautha /apex/ cisco_webex__webexsfdcauthako prípony. Napríklad:

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

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

12. Vyberte nasledujúce rozsahy zo zoznamu Dostupné rozsahy OAuth v časti Vybrané rozsahy OAuth:
    • Plný prístup (plný)
    • Vykonávať požiadavky kedykoľvek (refresh_token,offline_access)
13. Zrušte začiarknutie políčka pre rozšírenie Request Proof Key for Code Exchange (PKCE) pre podporované autoriz ačné toky.
14. Kliknite na polož ku Uložiť.
15. Skopírujte a bezpečne uložte spotrebiteľský kľúč a spotrebiteľské tajomstvo. Tieto hodnoty potrebujete pri konfigurácii autorizácie Salesforce v Control Hub.

Pre integráciu Webex pre Salesforce vo verzii 1.22 a novšej konfigurujte autorizáciu Salesforce pomocou aplikácie External Client App. Ak už máte pripojenú aplikáciu pre autorizáciu Webex Salesforce, môžete ju migrovať do externej klientskej aplikácie a zachovať jej spotrebiteľský kľúč.

Skôr ako začnete

• Potrebujete prístup správcu systému Salesforce.
• Moja domé na musí byť povolená vo vašom Salesforce org.

Obnoviť adresu URL mojej domény

1. V pravom hornom rohu vstupnej stránky Salesforce kliknite na a potom kliknite na položku Nastavenie.
2. V poli R ýchle vyhľad ávanie vyhľadajte položku Domény a vyberte ju.
3. Zaznamenajte si svoju adresu URL mojej dom ény. Použijete ho na konfiguráciu adries URL spätného volania. Napríklad vaša adresa URL môže byť https://my-company.my.salesforce.com.

Vytvorenie novej externej klientskej aplikácie

1. V časti Nastavenie vyhľadajte S právca aplik ácií v poli Rýchle vyhľad ávanie a vyberte ho.
2. Kliknite na položku Nová aplikácia externého klienta.

   Zadajte nasledujúce podrobnosti:

   • Názov externej klientskej aplikácie — Webex Salesforce autorizácia
   • Názov API — Webex_Salesforce_Authorization(automaticky vyplnené)
   • Kontaktný e-mail — Vaša e-mail ová adresa správcu
   • Štát distribúcie — miestny

3. Kliknite na polož ku Vytv oriť.

Konfigurácia nastavení OAuth

1. V časti API (Povoliť nastavenia OAuth) kliknite na položku Povoliť OA uth.
2. Nakonfigurujte adresy URL spätného volania. Nahra [your-domain]ďte hodnotou Salesforce My Domain a zadajte každú adresu URL do samostatného riadku:
   • https://[your-domain].my.salesforce.com/apex/webexsfdcauth
   • https://[your-domain].my.salesforce.com/apex/cisco_webex__webexsfdcauth
3. Pridajte tieto rozsahy OAuth do vybran ých rozsahu OAuth:
   • Plný prístup (full)
   • Vykonávanie požiadaviek kedykoľvek (refresh_token, offline_access)
4. V časti Zab ezpeč enie ponechajte začiarknutú možnosť Required Proof Key for Code Exchange (PKCE).
5. Kliknite na polož ku Vytv oriť.

Získajte spotrebiteľský kľúč a spotrebiteľské tajomstvo

1. V časti Nastavenie vyberte položky S právca aplik ácií > Správca aplikácií externého klienta.
2. Kliknite na položku Webex Salesforce Autorizácia.
3. Kliknite na kartu Nastavenia a potom otvorte nastavenia OAuth.
4. Kliknite na S potrebiteľský kľúč a tajom stvo.
5. Skontrolujte svoj e-mail, či nie je overovací kód od spoločnosti Salesforce.
6. Na stránke Overte svoju totož nosť zadajte kód a kliknite na tlačidlo O veriť.
7. Skopírujte a bezpečne uložte spotrebiteľský kľúč a spotrebiteľské tajomstvo. Tieto hodnoty potrebujete pri konfigurácii autorizácie Salesforce v Control Hub.

Migrácia existujúcej pripojenej aplikácie

Ak už máte pripojenú aplikáciu pre autorizáciu Webex Salesforce, migrujte ju do externej klientskej aplikácie. Tým sa zachová spotrebiteľský kľúč, zostáva platnosť existujúcich tokenov a prenesie nastavenia OAuth. Pôvodná pripojená aplikácia zostane aj po migrácii.

1. V časti Nastavenie vyhľad ajte App Manager a vyberte ho.
2. Nájdite existujúcu pripojenú aplikáciu, kliknite na šípku nadol napravo od riadka a vyberte polož ku Zobraziť.
3. Na stránke Podrobnosti o pripojenej aplikácii kliknite na položku Migrovať do externej klientskej aplikácie.
4. Skontrolujte súhrn migrácie a potom kliknite na položku Mi grovať.
5. Po dokončení migrácie Salesforce otvorí novú stránku s podrobnosťami o aplikácii External Client App.

Overte migráciu

1. V časti Nastavenie vyberte položky S právca aplik ácií > Správca aplikácií externého klienta.
2. Skontrolujte, či sa v zozname zobrazí autorizácia Webex Salesforce.
3. Kliknite na aplikáciu a skontrolujte, či sa na karte Nastavenia zobraz ujú správne adresy URL spätného volania a rozsahy OAuth:
   • Plný prístup (full)
   • Vykonávanie požiadaviek kedykoľvek (refresh_token, offline_access)
4. (Voliteľné) Získajte spotrebiteľský kľúč a spotrebiteľské tajomstvo a potvrďte, že zodpovedajú pôvodným hodnotám.

Deaktivujte pôvodnú pripojenú aplikáciu (voliteľné)

Po overení, či aplikácia Externý klient funguje, postupujte takto:

1. V časti Nastavenie vyberte položku S právca aplikácií.
2. Nájdite pôvodnú pripojenú aplikáciu a kliknite na šípku nadol napravo od jej riadka.
3. Vyberte polož ku Sprav ovať.
4. V časti Pravidlá OAuth nastavte Povolení používatelia tak, aby blokovali nové autorizácie alebo nechali pripojenú aplikáciu aktívnu počas prechodného obdobia.

Odporúčame ponechať pôvodnú pripojenú aplikáciu aktívnu počas krátkeho prechodného obdobia, aby integrácie fungovali ešte predtým, ako ju deaktivujete.

Keď je k dispozícii nový balík, postupujte podľa pokynov v časti In štalácia aplikácie Webex v aplikácii Salesforce vyššie. Starú verziu nemusíte najskôr odinštalovať a nestratíte nakonfigurované nastavenia.

Informácie o nových inštalačných balíkoch a o tom, kde ich stiahnuť, nájdete v poznámkach k vydaniu integrácie Webex Salesforce.

Ak chcete povoliť alebo zakázať históriu hovorov:

1. Prejdite na Webex Admin.
2. Prejdite nadol na polož ku História hovorov Webex.
3. Prepnite prepínač na požadované nastavenie, buď povolené alebo zakázané.

   Ak je povolená, História hovorov je k dispozícii všetkým používateľom a profilom.

Pre používateľov CUCM a Broadworks nie sú podporované nasledujúce funkcie:

• Prijímanie prichádzajúcich hovorov v globálnom dialeri Salesforce (aplikácia Webex bude stále prijímať prichádzajúce hovory)
• Zobrazenie trvania hovorov v okne denníka hovorov Salesforce po úspešnom uskutočnení odchádzajú ceho hovoru
• Ukončenie hovorov pomocou tlačidla v okne denníka hovorov Salesforce po úspešnom uskutočnení odchádzajúceho hovoru
• Automatické vyplnenie trvania hovorov v okne denníka hovorov Salesforce po ukončení odchádzajúceho hovoru

Pri všetkých integráciách Salesforce si všimnite nasledujúce obmedzenie:

• Salesforce uplatňuje obmedzenie počtu udalostí (25 000), ktoré môže spôsobiť zlyhanie integrácií pri intenz ívnom používaní. Balíky Salesforce sú k dispozícii na zvýšenie tohto limitu. Ďalšie informácie nájdete na stránke https://developer.salesforce.com/docs/atlas.en-us. platform_events.meta/platform_events/platform_event_limits.htm.

• Komponenty nástroja na volanie Webex nie sú k dispozícii v mobilnej aplikácii Salesforce.