Ennen kuin seuraat määritysvaiheita, sinun on ensin mentävä julkaisutietoihin ja ladattava Webex App Salesforce Package -paketin uusin versio.

Vaatimukset

Salesforce Enterprise Edition

Tämä integraatio edellyttää vähintään Salesforce Enterprise Edition -versiota. Lisätietoja on osoitteessa Salesforce-editiot .

Oma verkkotunnukseni Salesforce orgissa

Sinun on otettava My Domain käyttöön organisaatiossasi, jos haluat käyttää Lightning-komponentteja. Katso lisätietoja My Domain Salesforce -dokumentaatiosta.

Käyttäjän käyttöoikeus Control Hubissa

Sinun on määritettävä käyttäjien käyttöoikeudet integraatioihin organisaatiossasi.

• Ilman Pro Packia- Kun käytössäsi on perus Control Hub, voit sallia tai kieltää kaikkien käyttäjien pääsyn kaikkiin integraatioihin.

• Pro Packin avulla-With Pro Pack, sinulla on edistyneet toiminnot, joilla voit hallita käyttäjien pääsyä integraatioihin.

Lisätietoja on osoitteessa Configure User Access to Integrations .

Puhelut

• Webex Calling on täysin tuettu saapuville ja lähteville puheluille, jotta puhelujen hallinta voidaan toteuttaa Salesforcessa.

• Webexissä (Unified CM) soittamista tuetaan osittain. Ainoastaan lähtevät puhelut avaavat Salesforce-ponnahdusikkunan. Kun kyseessä on saapuva puhelu, Webex-sovellus soi, mutta Salesforce ei voi siepata puhelua, joten ponnahdusikkunaa ei tule näkyviin.

Jos käytät Webex for Salesforce -versiota 1.18 tai aikaisempaa versiota, sinun on määritettävä Salesforce-valtuutus, ennen kuin voit työskennellä Webex Calling -palvelun kanssa Salesforcessa. Seuraa tämän artikkelin osioita, niin pääset alkuun ja toimimaan.

Nämä menettelyt koskevat asiakkaita, jotka käyttävät Webexin Salesforce-integraation versiota 1.18 ja sitä vanhempia versioita. Katso päivitetyt ohjeet versioita 1.19 ja uudempia versioita varten: Määritä Salesforce-valtuutus (1.19 ja uudempi) Asenna ja hallinnoi -välilehdellä.

1. Luo yhdistetty sovellus

Uuden liitetyn sovelluksen luominen:

1. Etsi Asetukset-sivulla App Manager ja valitse sitten Uusi liitetty sovellus.

   

2. Kirjoita Connected App Name, esimerkiksi MyExampleApp.
3. Anna Yhteyshenkilön sähköpostiosoite .
4. Tarkista Enable OAuth Settings.
5. Määritä sijoittaja Callback URL (päivitämme tämän myöhemmin), esimerkiksi https://localhost/placeholder.

   

6. Vieritä alaspäin ja valitse seuraavat OAuth-aluekokonaisuudet:
   • Täysi pääsy (full)
   • Suorita pyyntöjä milloin tahansa (refresh_token, offline_access).

   

   Suorita pyynnöt milloin tahansa -alueen avulla Named Credentials voi päivittää käyttöoikeustunnuksesi, kun istunto päättyy.

7. Selaa sivun alareunaan ja valitse Tallenna ja valitse sitten Jatka.
8. Seuraavalla sivulla selaa kohtaan API (Enable OAuth Settings) ja valitse Manage Consumer Details.

   

   Sinun on ehkä tunnistauduttava uudelleen Salesforceen.

9. Merkitse muistiin Consumer Key ja Consumer Secret.

   

2. Luo auth-palveluntarjoaja

Seuraavaksi sinun on luotava todennuspalveluntarjoaja, joka helpottaa todennusta Salesforce-organisaatiosi kanssa.

Auth-palveluntarjoajan luominen:

1. Kohdassa Setup, etsi Auth ja valitse Auth. Tarjoajat. Napsauta New.

   

2. Valitse Salesforce Provider Type.
3. Kirjoita Auth-palveluntarjoajan nimi, esimerkiksi ApexMDTAPI.
4. Liitä sisään Kuluttajaavain ja Kuluttajasalaisuus , jotka tallensit Connected-sovelluksen määrityksen yhteydessä.
5. Kirjoita seuraavat laajuudet osoitteeseen Default Scopes, full refresh_token offline_access.
6. Jätä kaikki muu tyhjäksi ja napsauta Tallenna.

   

7. Kopioi Callback URL Salesforce Configuration -osiosta.

   

8. Muokkaa Connected App -sovellusta ja korvaa paikanvaraaja URL-osoite Callback URL-osoitteella , jonka kopioit yllä olevasta Salesforce-konfiguraatiosta .

   

9. Tallenna yhdistetty sovellus.

   Voit joutua odottamaan jopa 10 minuuttia, jotta asetukset tulevat voimaan ja leviävät koko Salesforcen infrastruktuuriin.

3. Luo nimetty valtakirja

Tämän jälkeen sinun on luotava nimetty valtakirja.

Voit luoda nimetyn valtakirjan:

1. Etsi Setup-sivulla Named ja valitse Named Credentials. Valitse New Legacy.

   

2. Syötä seuraava arvo kohdalle Label, ApexMDTAPI.
3. Kirjoita URL-osoitteeseen organisaatiosi instanssin URL-osoite, esimerkiksi https://na1.salesforce.com, tai jos käytät Oma verkkotunnus, täysin pätevä Oma verkkotunnus verkkotunnus, esimerkiksi https://mycompany.my.salesforce.com.
4. Valitse Identity Type-kohtaan Named Principal.
5. Valitse Authentication Protocol -kohdassa OAuth 2.0.
6. Valitse Authentication Provider-kohdasta aiemmin luomaasi auth-palveluntarjoajaa.
7. For Scope, enter, full refresh_token offline_access.
8. Ota käyttöön Start Authentication Flow on Save.

   

9. Ota Callout Options -kohdassa käyttöön Allow Merge Fields in HTTP Body ja napsauta sitten Save.

   

10. Sinua pyydetään kirjautumaan sisään organisaatiollesi. Kun olet kirjautunut sisään, näyttöön tulee Allow Access -valintaikkuna. Napsauta Allow.
11. Tämän jälkeen sinut ohjataan uudelleen Named Credential -näyttöön ja Authenticated Status ilmoittaa Authenticated as your-email@domain.com.

4. Luo sivustosi Webexin hallintanäytössä

Jatka lopuksi seuraavaan aiheeseen Kutsuminen -välilehdellä, Luo sivusto kutsua varten, jäljempänä.

Noudata yllä olevia nimeämiskäytäntöjä sivuston määrityksessä.

Kun kyseessä on Webex for Salesforce -integraatioiden versio 1.19 tai uudempi, noudata tämän artikkelin ohjeita poistaaksesi kaikki olemassa olevat Webex Connected App for -valtuudet, nimetyt tunnistetiedot ja auth-palveluntarjoajat ja luo sitten uusi Webex Connected App for Salesforce -valtuus.

Nämä menettelyt koskevat asiakkaita, jotka käyttävät Webex Salesforce -integraation versiota 1.19 tai uudempaa versiota. Versioita koskevat ohjeet 1.18 ja aikaisemmat versiot, katso Salesforce-valtuutuksen määrittäminen (1.18 ja uudemmat versiot) Asenna ja hallinnoi -välilehdellä.

Poista kaikki olemassa olevat Webex Connected -sovellukset, nimetyt tunnistetiedot ja auth-palveluntarjoajat.

Jos olet aiemmin luonut Webex Connected App -valtuudet, nimetyn valtakirjan tai auth-palveluntarjoajan, ne on poistettava ennen jatkamista. Muussa tapauksessa jatka osoitteeseen Create a new Webex Connected App alla.

Poista nykyinen Webex Connected -sovellus:

1. Valitse Salesforce-laskeutumissivun oikeassa yläkulmassa hammasratas-kuvake ja valitse Setup.
2. Kirjoita Quick Find -tekstiruutuun App Manager ja valitse se luettelosta.
3. Siirry luettelossa Webex Connected App -sovelluksen kohdalle, napsauta merkinnän oikealla puolella olevaa alaspäin osoittavaa nuolikuvaketta ja valitse View.
4. Valitse Poista ja valitse sitten Poista uudelleen, kun sinua pyydetään vahvistamaan.

Poista kaikki olemassa olevat Webex Named Credentials -valtuudet:

1. Kirjoita Quick Find -tekstiruutuun Named Credentials ja valitse se luettelosta.
2. 2. Napsauta Webexin nimettyjen valtakirjojen merkinnän oikealla puolella olevaa alasvetonuolta ja valitse Poista.
3. 3. Valitse Poista uudelleen, kun sinua pyydetään vahvistamaan.

Poista kaikki olemassa olevat Webex Auth Providers -palvelimet:

1. Kirjoita Quick Find -tekstiruutuun Auth. Providers ja valitse se luettelosta.
2. Valitse Webex-auth-palveluntarjoajan merkinnän alussa oleva Del -linkki.
3. Valitse OK , kun sinua pyydetään vahvistamaan.

Jatka seuraavaan osioon luodaksesi uuden Webex Connected App for Salesforce -valtuutuksen.

Luo uusi Webex Connected App for Salesforce -valtuutus.

Uuden Webex Connected App for Salesforce -valtuutuksen luominen:

1. Valitse Salesforce-laskeutumissivun oikeassa yläkulmassa hammasratas-kuvake ja valitse Setup.
2. Hae verkkotunnuksesi URL-osoite: osoitteessa Quick Find, etsi ja valitse Domains ja tallenna URL-osoite osoitteesta My Domain.

1. Kirjoita Quick Find -tekstiruutuun App Manager ja valitse se luettelosta.
2. Kirjoita Connected App Name, esimerkiksi Webex Salesforce Authorization.
3. Kirjoita sähköpostiosoite Yhteydenottosähköposti.
4. Tarkista Enable OAuth Settings.
5. Kirjoita kaksi takaisinsoitto-URL-osoitetta käyttäen aiemmin hakemaasi URL-osoitetta, yksi per rivi, ja lisää /apex/ webexsfdcauth ja /apex/ cisco_webex__webexsfdcauth loppuliitteiksi. Esimerkiksi:

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

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

6. Valitse seuraavat laajuudet Available OAuth Scopes -luettelosta osoitteessa Selected OAuth Scopes:
   • Täysi pääsy (full)
   • Suorita pyyntöjä milloin tahansa (refresh_token, offline_access).
7. Poista valinta Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows.
8. Tallenna Connected App ja merkitse muistiin luotu Consumer Key ja Consumer Secret myöhempää käyttöä varten.

Kun uusi paketti on saatavilla, noudata ohjeita kohdassa Asenna Webex-sovellus Salesforceen. Sinun ei tarvitse poistaa vanhaa versiota ensin, etkä menetä määritettyjä asetuksia.

Lisätietoja uusista asennuspaketeista ja siitä, mistä ne voi ladata, on osoitteessa Webex Salesforce -integraation julkaisutiedot.

Puheluhistorian ottaminen käyttöön tai poistaminen käytöstä:

1. Siirry Webex Admin.
2. Selaa alaspäin osoitteeseen Webex-puheluhistoria.
3. Käännä vaihtokytkin haluttuun asetukseen, joko käyttöön tai pois käytöstä.

   Kun tämä on käytössä, soittohistoria on kaikkien käyttäjien ja profiilien käytettävissä.

CUCM- ja Broadworks-käyttäjien osalta seuraavia toimintoja ei tueta:

• Saapuvien puhelujen vastaanottaminen Salesforcen globaalissa soittopalvelussa (Webex App vastaanottaa edelleen saapuvia puheluita).
• Puhelun keston tarkasteleminen Salesforce-puheluloki-ikkunassa lähtevän puhelun onnistuneen soittamisen jälkeen.
• Puhelujen lopettaminen Salesforce-puheluloki-ikkunan painikkeella lähtevän puhelun onnistuneen soittamisen jälkeen.
• Puhelun keston automaattinen lisääminen Salesforce-puheluloki-ikkunaan lähtevän puhelun lopettamisen jälkeen.

Huomaa kaikkien Salesforce-integraatioiden osalta seuraava rajoitus:

• Salesforce asettaa tapahtumien lukumäärälle rajoituksen (25 000), joka voi aiheuttaa integraatioiden epäonnistumisen kovassa käytössä. Salesforce-paketteja on saatavilla tämän rajan nostamiseksi. Lisätietoja on osoitteessa https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_event_limits.htm.

Käyttämällä Webex Webinars Import Webinar Data -määrityspaneelia valtuutetut Salesforce-käyttäjät voivat tuoda Webexin webinaarien kutsutut, rekisteröidyt ja osallistujat suoraan Salesforce-objekteihin, kuten liidit ja yhteystiedot.

Tuo webinaaritiedot -määritysliittymä on käytettävissä Webex Admin -sivulla:

Kun webinaarien tuonti on otettu käyttöön, valtuutetut käyttäjät voivat tuoda Webexin webinaaritietoja käyttämällä Webex Webinars -widgettiä:

Määritä Webex-verkkoseminaarin käyttöoikeudet Salesforce-käyttäjille.

Ennen kuin käyttäjät voivat käyttää Webexin webinaarien tuontitoimintoja, jokaiselle käyttäjälle on annettava Webex Import Admin -oikeus.

Voit määrittää käyttäjälle käyttöoikeuksia:

1. Siirry osoitteeseen Integroi Salesforce Webex-sovellukseen.
2. Valitse artikkelin alareunassa oleva Hallitse -välilehti ja laajenna sitten . Tarjoa pääsy:

   

3. Seuraa ohjeita lisätäksesi Webex Import Admin -oikeudet Salesforce-käyttäjätiliisi.

Webex-verkkoseminaarin aika-alueen näytön määrittäminen

Voit määrittää näytettävien Webex-verkkokeskustelujen aikaväliä:

1. Napsauta Salesforce Apps -painiketta, kirjoita hakukenttään Webex ja valitse sitten Webex Admin:

   

2. Etsi Webex Webinars -paneeli ja syötä niiden päivien määrä, joilta haluat näyttää aiemmat ja tulevat webinaarit etusivun Webex webinars -widgetissä:

   

Jatka Webex-verkkoseminaarin tuontikenttäsovitusten määrittämistä.

Webex-verkkoseminaarin tuontikenttien määrittäminen

Webex-verkkoseminaarin tuontiasetusten avulla määrittelet Salesforce-objektien ja Webinar-objektin kenttien väliset yhdistelmät. Voit esimerkiksi yhdistää Salesforce Contact -objektin etu- ja sukunimen webinaariin kutsuttavien, rekisteröityneiden ja osallistujien rinnakkaisiin kenttien nimiin: firstName ja lastName.

Webex-verkkoseminaarin tuontiasetusten määrittäminen:

1. Selaa Webex Admin -sivulla alaspäin Tuo webinaaritiedot -paneeliin:

   

2. Valitse Salesforce-objekti Object -pudotusvalikosta:

   

   Kohteeseen voit valita seuraavista vakiomuotoisista Salesforce-objekteista kaikkien käytettävissä olevien määritettyjen Mukautettujen -objektien lisäksi:

   • Yhteystiedot
   • Johtaa

   Valitse Insert New Records for every Webinar (Lisää uudet tietueet jokaista webinaaria varten) -vaihtoehto, jos haluat, että kaikki tuodut webinaarin osallistujat luodaan uusina objektitietueina, ellei heitä ole jo tuotu samaan webinaariin (valitun pääavaimen perusteella). Olemassa olevia tietueita ei päivitetä, vaikka ensisijainen avain olisikin sama, ellei niitä tuoda samaan Webex-verkkoseminaariin.

   Voit yhdistää nämä vakioobjektit Salesforce-kampanjoihin seuraavasti:

   • Kampanjan jäsenet: Tuodut liidit ja kontaktit ovat saatavilla kohteena olevan Salesforce-kampanjan Kampanjan jäsenet -osiossa, joka on Salesforcen vakio-ominaisuus. (Saatavilla versiossa 1.16 ja uudemmissa versioissa)
   • Webex Webinaari Kampanjan jäsenet: Tuodut liidit ja yhteystiedot ovat käytettävissä kohteena olevan Salesforce-kampanjan Webex Webinaari Kampanjan jäsenet -osiossa, joka on mukautettu Webex-ominaisuus.
   • Sekä kampanjan jäsenet että Webex-verkkoseminaari Kampanjan jäsenet: Tuodut liidit ja kontaktit ovat saatavilla osoitteessa sekä Salesforce-kampanjan sisällä. (Saatavilla versiossa 1.16 ja uudemmissa versioissa)

   Mikä tahansa muu Mukautettu -kohde, jonka valitset luettelosta, tuodaan kohteena olevan Salesforce-kampanjan Webex Webinaari-kampanjan jäsenet -osioon.

3. Valitse Ensisijainen avain -valintakäyttöliittymässä yksilöllinen kenttä ensisijaiseksi avaimeksi ja siirrä se oikealla nuolinäppäimellä Valitut -luetteloon:

   

   Valitse Ensisijainen avain-kenttään käytettävissä oleva kenttä, joka on yksilöllinen jokaisessa tietueessa. Sinulla voi esimerkiksi olla useita yhteystietoja, joiden etunimi on Mark, mutta jokaisella yhteystiedolla on oma sähköpostiosoite.

4. Valitse Data field mapping -käyttöliittymässä valitsemasi Salesforce-objektin kenttä ja määritä se webinaariobjektin vastaavaan kenttään. Käytä + Uusi kenttä -painiketta lisäkenttien lisäämiseen tarpeen mukaan.

   Kaikki Salesforce-objektien kentät on yhdistettävä vastaaviin webinaarikenttiin edellä esitetyllä tavalla.

   Ainoastaan Webexin webinaarien rekisteröintilomakkeiden vakiokysymykset voidaan yhdistää Salesforcen kenttiin. Mukautettuja Webex-verkkoseminaarin kysymyksiä ei tueta.

5. Voit poistaa lisäämiäsi kenttiä käyttämällä kentän vieressä oikealla olevaa roskakorikuvaketta.
6. Napsauta Tallenna , kun olet valmis, ja kun olet tarkistanut ensisijaisen avaimen, napsauta Tallenna vahvistusikkunassa:

   

   Liitännät näkyvät päivitetyssä paneelissa:

   

   Voit poistaa objektien yhdistämisiä roskakorikuvakkeella, joka näyttää ylimääräisen vahvistusikkunan, tai muokata olemassa olevia yhdistämisiä kynäkuvakkeella.

   Voit aina palata tänne ja muuttaa pääavainta, mutta tämä ei päivitä järjestelmään jo tuotujen tietueiden pääavainta . Tämä voi johtaa kaksoiskappaleisiin, joten muokkaa ensisijaisia avaimia varovasti.

Kun olet määrittänyt webinaarikenttien yhdistämiset, valitse, kenellä on pääsy webinaaritietojen tuontitoimintoihin.

Ota webinaaritietojen tuonti käyttöön Salesforce-käyttäjillesi.

Kun webinaarikenttien yhdistämiset on määritetty, voit valita, kenellä on pääsy webinaaritietojen tuontiominaisuuteen. Vaihtoehtoina ovat yleinen käyttöoikeus jokaiselle käyttäjätilille, jolla on oikeat käyttöoikeudet, yksittäiset käyttäjätilit ja käyttäjät, jotka ovat tiettyjen Salesforce-profiilien jäseniä.

Ota webinaaritietojen tuonti käyttöön kaikille käyttäjille

Jos haluat ottaa webinaaritietojen tuonnin käyttöön kaikille Salesforce-organisaatiossasi oleville henkilöille, vaihda Enable webinar import for all Profiles/Users (Ota webinaarituonti käyttöön kaikille profiileille/käyttäjille) Enabled(Käytössä) -asetukseksi:

Ota webinaaritietojen tuonti käyttöön valituille käyttäjille tai profiileille.

Voit ottaa webinaaritietojen tuonnin käyttöön valituille yksittäisille käyttäjille tai tietyille käyttäjäjoukoille, jotka vastaavat tiettyä Salesforce-käyttäjäprofiilia.

Webinaaritietojen tuonnin salliminen valituille käyttäjille tai profiileille:

1. Varmista, että Enable webinar import for all Profiles/Users on Disabled:

   

2. Valitse Enable webinar import only for these Profiles/Users (Ota webinaarituonti käyttöön vain näille profiileille/käyttäjille) -pudotusvalikosta joko profiili tai käyttäjä:

   

   • Voit lisätä profiilin valitsemalla Profile, napsauttamalla hakutekstiruutua ja valitsemalla Salesforce-roolin avattavasta luettelosta. Lisää rooli valitsemalla Lisää:

     

   • Jos haluat lisätä yksittäisen käyttäjän, valitse Käyttäjä ja kirjoita käyttäjänimi tekstiruutuun. Lisää käyttäjä valitsemalla Lisää:

     

   Voit poistaa käyttäjän tai profiilin napsauttamalla merkinnän vieressä olevaa roskakorikuvaketta.