Het instellen van de Salesforce-integratie verbindt je Document360-kennisbank met je Salesforce-console. Zodra deze is opgezet, kunnen supportmedewerkers artikelen zoeken, aanbevelingen krijgen en direct vanuit Salesforce kennis maken. Dit artikel neemt je mee door elke stap van het installatieproces, van het installeren van de Document360-app op Salesforce tot het autoriseren van de verbinding via je Document360-portaal.
Voordat je begint
- Je hebt een Salesforce Lightning-platformaccount nodig. Als je er geen hebt, meld je dan aan voor een gratis proefperiode op de Salesforce-aanmeldpagina. Als je al een account hebt, ga dan naar Installeer de Document360-app op Salesforce.
- Je moet beheerder zijn in zowel je Salesforce-organisatie als je Document360-project.
- De Salesforce-integratie is een aanvullende aankoop. Ga naar Instellingen > extensies in je Document360-portaal en klik op nu kopen onder de Salesforce-tegel voordat je begint.
Hoe de Salesforce-integratie in te stellen
Het opzetten van de integratie omvat vijf fasen. Voltooi ze in volgorde:
- Maak een Salesforce-account aan (sla het over als je er al een hebt)
- Installeer de Document360-app op Salesforce
- Konfigureer de instellingen van App Manager.
- Voeg een Visualforce-pagina toe
- Verleen app-toegang tot gebruikersprofielen
- Autoriseer de integratie vanuit Document360
Maak een Salesforce-account aan
Als je al een Salesforce Lightning-platformaccount hebt, sla dan deze sectie over.
- Ga naar de Salesforce-aanmeldpagina.
- Voer de vereiste gegevens in en klik op Start mijn gratis proefperiode.
- Bezoek de Salesforce-prijspagina om een abonnement te kiezen en aan te schaffen dat bij jouw behoeften past.
- Controleer je geregistreerde e-mailadres op een bericht met je verificatielink, account-URL en gebruikersnaam. Klik in de e-mail op Accountverificatie .
- Voer de verificatiecode in uit de follow-up e-mail en klik op Verifiëren.
De verificatiecode komt in een aparte e-mail binnen dan de oorspronkelijke verificatielink.
Je wordt doorgestuurd naar de Salesforce-startpagina.
Installeer de Document360-app op Salesforce
- Ga naar de Document360-vermelding op AppExchange.
- Klik op Probeer het.
- Log in met je Trailblazer-account.
- Selecteer de omgeving waar je de app wilt installeren:
- Installeren in productie — installeert Document360 in de productieomgeving van je Salesforce-project.
- Installeren in Sandbox — installeert Document360 in de sandboxomgeving van je Salesforce-project.
- Bekijk de installatiedetails en klik op Bevestigen en installeren.
- Voer je Salesforce-gegevens in en klik op Inloggen.
- Selecteer wie toegang moet hebben tot de Document360-app:
- Alleen installeren voor beheerders — beperkt de toegang tot alleen beheerders.
- Installeren voor alle gebruikers — geeft alle gebruikers in jouw organisatie toegang.
- Installeren voor specifieke profielen — beperkt de toegang tot geselecteerde gebruikersprofielen.
Deze selectie bepaalt welke gebruikers in uw Salesforce-organisatie toegang hebben tot de Document360-app. Je kunt de toegang later aanpassen door gebruikersprofielen bij te werken.
- Klik op Installeren.
- Wacht tot de installatie voltooid is, en klik dan op Klaar.
Configureer instellingen en beleidsregels van App Manager
Na installatie van de Document360-app configureer je de OAuth-beleidsregels in Salesforce om te bepalen wie de integratie kan autoriseren.
- Navigeer in je Salesforce-configuratie naar Platform Tools > Apps > App Manager in het linker navigatievenster. Deze stap zorgt voor veilige autorisatie en passende toegangscontrole voor gebruikers die interactie hebben met de Document360-integratie.
- Op de pagina Lightning Experience App Manager vind je Document360 in de appslijst.
- Klik op de pijl naar beneden aan het einde van de Document360-apprij en selecteer Beheren.
- Op de pagina met de details van de verbonden app van Document360 klik je op Beleid bewerken.
- Selecteer in het keuzemenu Toegestane Gebruikers wie de app kan autoriseren om namens hen gegevens te benaderen. Er zijn twee opties:
- Alle gebruikers kunnen zichzelf autoriseren — elke gebruiker in jouw organisatie kan de app individueel autoriseren wanneer dat nodig is. Dit werkt goed voor organisaties met verschillende rollen of afdelingen die de integratie onafhankelijk moeten gebruiken.
- Beheerders goedgekeurd worden vooraf geautoriseerd — beheerders worden automatisch geautoriseerd zonder elke keer het authenticatieproces te doorlopen. Dit is handig wanneer de admin de primaire gebruiker van de integratie is.
Het selecteren van door Beheerders goedgekeurde gebruikers zijn vooraf geautoriseerd is een eenmalige actie. Eenmaal ingesteld hoeft de admin niet opnieuw handmatig te authenticeren.
Voeg een Visualforce-pagina toe in de Salesforce ontwikkelaarsconsole
Je moet een Visualforce-pagina aanmaken in je Salesforce developer console om de Document360-app in je Salesforce-omgeving in te sluiten.
- In het Quick Find-veld linksboven in je Salesforce-setup zoekt u naar Visualforce Pages en selecteert u deze uit de resultaten.
- Klik op Nieuw.
- Voer een label, naam en beschrijving van de pagina in.
- Selecteer de sites Beschikbaar voor Lightning Experience, Experience Builder en het selectievakje mobiele app.
- Plak de volgende code in de Visualforce Markup-sectie :
<apex:page standardController="Case"> <apex:canvasApp applicationName="Document360" namespacePrefix="Document360" height="800" width="750px"/> </apex:page>
Je kunt de hoogte- en breedtewaarden in de markup aanpassen aan je indeling. Bijvoorbeeld: height="800px" width="750px". Noteer de hoogte die je hier hebt ingesteld — die heb je nodig bij het toevoegen van de Visualforce-component aan je Cases-pagina.
- Klik op Opslaan.
Verleen app-toegang tot gebruikersprofielen
De organisatiebeheerder moet toegang verlenen tot de relevante gebruikersprofielen aan de Document360-app. Zonder deze stap zullen gebruikers een foutmelding Onvoldoende Privileges zien bij het openen van het tabblad Kennis.
- Ga naar de Setup-pagina in je Salesforce-omgeving.
- Ga in het linker navigatiepaneel naar Beheer > Gebruikers > Profielen.
- Klik vanuit de profiellijst op het profiel dat is toegewezen aan het team of de persoon die de casepagina en integratie-instellingen beheert.
- Klik op de profielpagina op Bewerken.
- Scroll naar beneden naar het gedeelte Connected App Access .
- Selecteer het selectievakje Document360 .
- Klik op Opslaan.
Herhaal dit voor elk profiel dat toegang nodig heeft tot de Document360-app in Salesforce.
Autoriseer de Salesforce-integratie vanuit je Document360-portaal
De laatste stap is het autoriseren van de verbinding via je Document360-portaal.
- Ga naar je Document360-portaal.
- Ga naar Instellingen in de linker navigatiebalk.
- Ga naar Extensies in het linker navigatievenster.
- Klik op Salesforce onder de Helpdesk-sectie .
Salesforce is een add-on aankoop. Als je het nog niet hebt gekocht, klik dan op Koop nu op de Salesforce-tegel.
- Klik op Verbinden.
- Selecteer uw autorisatietype:
- Live — autoriseert uw productieproject in Salesforce.
- Sandbox — autoriseert je sandbox Salesforce-project.
- Klik in het paneel Toegang toestaan op Toestaan en wacht een paar seconden.
- De Salesforce-tegel toont nu de status als Project verbonden met Salesforce , samen met de Salesforce-account-URL die aan je project is gekoppeld.
- Klik op Details op de Salesforce-tegel om je volledige configuratie-informatie te bekijken.
Om de integratie te verwijderen, klik je op het Verwijderen-icoon op de Salesforce-tegel.
De Salesforce-integratie is nu ingesteld. Je agenten kunnen nu je kennisbank doorzoeken, artikelaanbevelingen krijgen en artikelen direct vanuit de Salesforce console aanmaken. Leer vervolgens hoe je Document360 gebruikt in Salesforce.
Best practices
- Voltooi alle vijf de fasen op volgorde. Elke fase hangt af van de voorgaande. Het overslaan van de App Manager-configuratie kan bijvoorbeeld later tot autorisatiefouten leiden.
- Test in Sandbox voordat je live gaat. Gebruik de Sandbox-omgeving om te controleren of de integratie werkt zoals verwacht voordat je je productieproject in Salesforce aansluit.
- Stel profieltoegang in voordat je autoriseert. Verleen de Document360-app toegang tot alle relevante gebruikersprofielen voordat agenten proberen de integratie te gebruiken, om fouten met Onvoldoende Privileges te voorkomen.
- Noteer de hoogte van je Visualforce-pagina. Wanneer je Document360 toevoegt aan je Cases-pagina, moet de hoogte overeenkomen met of hoger zijn dan de waarde die in je Visualforce-pagina-markup is ingesteld.
- Gebruik door de Admin goedgekeurde gebruikers zijn vooraf geautoriseerd voor een soepelere ervaring. Als je beheerder de primaire gebruiker van de integratie is, verwijdert deze instelling de noodzaak van herhaalde authenticatieprompts.
- Bekijk bij het upgraden van de integratie de Document360- en Salesforce-releasenotities op eventuele API- of featurewijzigingen, test in een staging-omgeving en bevestig daarna de compatibiliteit voordat je naar productie wordt uitgezet.
FAQ
Wat is de technische architectuur van de integratie tussen Document360 en Salesforce?
De integratie maakt gebruik van API's van beide platforms om gegevensoverdracht en synchronisatie tussen Document360 en Salesforce mogelijk te maken.
Hoe wordt documentversiebeheer afgehandeld tijdens synchronisatie?
De integratie volgt wijzigingen in Document360 en werkt bijbehorende records bij in Salesforce om de nauwkeurigheid en consistentie van de gegevens te waarborgen.
Welke stappen zijn er bij het upgraden van de integratie wanneer er nieuwe versies worden uitgebracht?
Bekijk de release notes op eventuele wijzigingen aan API's of functies, test de update in een staging-omgeving en bevestig compatibiliteit voordat je naar productie wordt uitgezet.