Salesforce Einstein integreren

Voordat u de taken op deze pagina uitvoert, moet u zeker weten dat aan de vereisten voor de integratie is voldaan.

Een script aanmaken

Vereiste machtigingen: Studioscript weergeven, maken/bewerken

U hebt ten minste één Studio-script nodig om interacties naar uw virtuele agent te routeren. Volg de scriptrichtlijnen en -vereisten. De ondersteunde virtuele-agentactie voor deze provider si Textbot Exchange en uw script moet beschikken over het digitale mediatype Een kanaal zoals spraak, e-mail of chat, waarmee een klant communiceert met een beoogde ontvanger..

Raadpleeg de secties Basiselementen en Technische referentiegids in de online Help voor meer informatie over Studio-scripts.

Als uw virtuele agent klaar is voor productie, wijs dan het script toe aan één of meer contactpunten.

Een Certificaat en Sleutels genereren

U gebruikt het certificaat en de sleutels tijdens het instelproces van de integratie. Om deze taak te voltooien moet u OpenSSL geïnstalleerd hebben.

1. Blader naar de directory waarin u de bestanden wilt maken aan de hand van een opdrachtregelwerkbalk.
2. Typ de opdracht openssl en druk op Enter.
3. Typ een voor een de volgende opdrachten. Druk na elke opdracht op Enter: 
   • openssl genrsa -out private-key.pem 3072
   • openssl rsa -in private-key.pem -pubout -out public-key.pem
   • openssl req -new -x509 -key private-key.pem -out cert.der -days 360
4. Controleer de gespecificeerde directory om te verifiëren dat u de volgende bestanden hebt: 
   • cert.der
   • private-key-pem
   • public-key.pem

Een Verbonden Salesforce-app maken en configureren

Volg deze stappen om een verbonden app te maken in Salesforce Lightning. Met verbonden apps kunt u Salesforce integreren met externe applicaties zoals CXone.

1. Log in bij Salesforce met een account met beheerdersmachtigingen.
2. Maak een verbonden app: 
   1. Ga naar Configuratie en zoek naar App-manager in de snelle zoekbalk aan de linkerzijde van de pagina.
   2. Klik in de App-manager op Nieuwe verbonden app.
   3. Voltooi de sectie Basisinformatie op de pagina Verbonden apps beheren.
   4. Selecteer onder API (OAuth-instellingen inschakelen), OAuth-instellingen inschakelen.
   5. Selecteer Digitale handtekeningen inschakelen, klik op Bestand kiezen en upload het certificaat dat is gemaakt toen u de JWT genereerde.
   6. Voeg de volgende scopes toe uit de lijst geselecteerde OAuth-scopes: 
      • Open RUST-API-materialen verbinden (chatter_api)
      • Open Chatbotdiensten (chatbot_api)
      • Verzoeken op elk moment uitvoeren (refresh_token, offline_access)
   7. Klik op Opslaan.
3. Configureer OAuth-beleidsregels en voeg een beheerdersprofiel toe aan de app die u zojuist hebt gemaakt: 
   1. Klik onder Platformtools in het menu aan de linkerzijde van de pagina op Apps > Verbonden apps > Verbonden apps beheren.
   2. Selecteer de app die u hebt gemaakt.
   3. Klik op Beleidsregels bewerken.
   4. Selecteer onder OAuth-beleidsregels de door beheerder goedgekeurde gebruikers die vooraf geautoriseerd zijn uit de vervolgkeuzelijst Toegestane gebruikers.
   5. Selecteer uit de vervolgkeuzelijst IP ontspanning IP-restricties ontspannen.
   6. Sla de wijzigingen op.
   7. Blader op dezelfde pagina omlaag naar Profielen en voeg een Systeembeheerderprofiel toe.
4. Schakel Verbruikerdetails beheren in om de sleutels te ontvangen: 
   1. Klik onder Platformtools in het menu aan de linkerzijde van de pagina op Apps > Verbonden apps > Verbonden apps beheren.
   2. Klik in de vervolgkeuzelijst voor de app Authenticatie beheren op Weergeven.
   3. Klik onder API (OAuth-instellingen inschakelen) op Verbruikerdetails beheren. Salesforce verstuurt een e-mail met een verificatiecode naar het e-mailadres dat wordt gebruikt in uw Salesforce-account.
   4. Voer de code in in het venster Verifieer uw identiteit.
   5. Kopieer de sleutels die onder Verbruikerdetails verschijnen.

Salesforce Einstein met de Verbonden app verbinden

Nadat u de Verbonden app in Salesforce hebt gemaakt, moet u deze verbinden met Salesforce Einstein.

1. Selecteer in Salesforce Einstein Overzicht uit de vervolgkeuzelijst in de linkerbovenhoek van de pagina.
2. Klik onder Verbindingen op Toevoegen.
3. Selecteer op het venster Verbinding toevoegen API uit de vervolgkeuzelijst Verbinding.
4. Voer een Integratienaam in.
5. Selecteer de naam van de Verbonden app die u in de vorige taak hebt gemaakt.
6. Maak een opmerking van de URL die onder de basis-URL van Runtime wordt weergegeven. U hebt deze informatie in een latere taak nodig.
7. Klik op Opslaan.

Een JWT Bearer-token genereren

U moet een JSON-webtoken (JWT) genereren voor gebruik in uw integratie. Deze stappen omschrijven één methode van de tokengeneratie. Als u een andere methode liever gebruikt, pas die dan toe met de parameters die in de volgende stappen worden gedefinieerd.

1. Open uw webbrowser en ga naar de jwt.io-website .
2. Selecteer uit de vervolgkeuzelijst Algoritme RS256.
3. Voer in het veld Payload de volgende gegevens in JSON in: 
   • iss: Voer de OAuth-client_id in voor de verbonden app waarvoor u het certificaat hebt gemaakt.
   • aud: De authorisatieserver is de beoogde doelgroep. Gebruik één van de volgende URL's: 

     • https://login.salesforce.com

     • https://test.salesforce.com

     • https://site.force.com/customers (bij implementatie voor een Experience Cloud-site)

   • sub: De gebruikersnaam van de Salesforce Agent-gebruiker die het token genereert als u een Experience Cloud-site implementeert. Voor achterwaartse compatibiliteit kunt u in plaats daarvan principe (prn) gebruiken. Als zowel sub als prn zijn inbegrepen, dan wordt prn gebruikt.

   • exp: De vervaltijd van de JWT. Voer de tijd in als het aantal seconden van 1970-01-01T00:00:00Z UTC. De tijd die gebruikt wordt kan nauwkeurig zijn binnen drie minuten van de daadwerkelijke vervaltijd.

4. Plak de inhoud van de bestanden public-key.pem en private-key.pem in de velden onder Handtekening verifiëren. Dit zijn de twee bestanden die u hebt gedownload toen u het certificaat maakte.
5. Klik op JWT delen om de JWT naar uw klembord te kopiëren.

Met Postman testen

Nadat u uw token hebt gegenereerd, kunt u Postman gebruiken om de functionaliteit van de autorisatie te testen als u dat wilt. Als u ervoor kiest dit te doen, gebruik dan de volgende informatie in uw verzoek:

• Werkwoord: POST
• URL: https://login.salesforce.com/services/oauth2/token
• Body: Voeg de volgende sleutel/waarde-paren toe: 

  • "grant_type" : "urn:ietf:params:oauth:grant-type:jwt-bearer"

  • "assertion" : "{your bearer token}"

Wanneer het autorisatietoken ontvangt, stuur dan een POST-verzoek naar de virtuele agent van Einstein om te testen of deze reageert. Gebruik de URL voor uw instantie van Salesforce. Een voorbeeld van het verzoek wordt weergegeven in de volgende afbeelding.

Een app toevoegen aan Virtuele Agent Hub

Vereiste machtigingen: Automatisering & AI > Automatisering & AI starten Studioscript weergeven, maken/bewerken

Door een configuratie-app toe te voegen aan Virtuele Agent Hub kunt verbinding maken tussen CXone en uw virtuele-agentprovider.

1. Klik in CXone op de app-kiezer en selecteerOverige > Automatisering & AI en klik daarna op Virtuele Agent Hub. U kunt ook dubbelklikken op de virtuele-agentactie die u in uw Studio-script gebruikt om Virtuele Agent Hub te starten.
2. Klik op Bot toevoegen.

3. Voer een Naam voor virtuele agent (bot) in en klik op Salesforce Einstein in de lijst met virtuele-agentproviders.

4. Klik op Volgende.

5. Vul de velden in het configuratieformulier in en klik op Volgende. Details over dit formulier vindt u in de sectie Details configuratiepagina op deze pagina.

6. Klik op Volgende.

7. Selecteer Alleen tekstgebaseerd (geen spraakondersteuning) op de pagina Spraak.

8. Klik op Volgende.

9. Ga naar de pagina Transcriptie en stel in of u de transcriptie van het gesprek en de intentiegegevens wilt vastleggen.

   Meer informatie over de velden in deze stap

   Optie	Details
   Geen transcriptie- of intentiegegevens vastleggen of archiveren	Selecteer deze optie als u geen conversatietranscriptie of intentie- De betekenis of de bedoeling van wat een klant zegt of typt; datgene wat de klant wil communiceren of bereiken.informatie wilt vastleggen.
   Alleen intentie-informatie vastleggen en archiveren	Selecteer deze optie als u alleen intentie-informatie wilt vastleggen. Vastgelegde data worden standaard alleen opgeslagen voor de duur van de interactie. Deze optie vereist aangepaste scripts.
   Vastleggen en archiveren van transcriptie- en intentie-informatie	Selecteer deze optie als u zowel transcriptie- als intentie-informatie wilt vastleggen. Vastgelegde data worden standaard alleen opgeslagen voor de duur van de interactie. Deze optie vereist aangepaste scripts.

10. Klik op Volgende.

11. Op de pagina Testen en toevoegen kunt u de verbinding van de bot testen door audio- of tekstprompts te sturen. Als uw testberichten niet werken, klikt u op Terug om terug te keren naar de configuratiepagina en de instellingen te controleren. Mogelijk moet u ook de configuratie in de beheerconsole van uw virtuele-agentprovider controleren.

12. Klik op Toevoegen.

Configuratiepagina voor Salesforce Einstein

Gebruik de informatie in de volgende tabel bij het voltooien van de Configuratiepagina. U ziet deze pagina wanneer u een app toevoegt in Virtuele Agent Hub

De Salesforce Einstein-app aan een actie toewijzen

Vereiste machtigingen: Studioscript weergeven, maken/bewerken

Wanneer de virtuele-agentapp De betekenis of de bedoeling van wat een klant zegt of typt; datgene wat de klant wil communiceren of bereiken. ingesteld en geconfigureerd is in Virtuele Agent Hub, moet u deze toewijzen aan de virtuele-agentacties in uw script. Dit verbindt de actie en het script met uw virtuele-agentprovider.

1. Open in Studio het script dat u wilt bewerken.

2. Als u dit nog niet hebt gedaan, klikt u op het tabblad Tools, vouwt u de categorie Automatisering en AI uit en voegt u de virtuele agent-actie toe die u wilt gebruiken. Let erop dat u de actie op de juiste plek in uw script zet. Als u de gewenste actie niet ziet, controleert u of het scriptmediatype klopt. Als u bijvoorbeeld een script maakt voor een spraakgebaseerde virtuele agent, moet ook het telefoonscript gebruiken.

3. Dubbelklik op de actie om Virtuele Agent Hub te openen.

   Afbeelding weergeven

   
4. Zoek in de linkerkolom de virtuele agent die u wilt toewijzen aan de actie en klik op het vinkje dat ernaast staat.
5. Klik op Sluiten.

De verbinding van uw virtuele agent testen

Vereiste machtigingen: Automatisering & AI > Automatisering & AI starten Studioscript weergeven, maken/bewerken

U kunt veel aspecten van uw virtuele agent testen om er zeker van te zijn dat alles werkt zoals bedoeld. U kunt tests uitvoeren vanaf de pagina Eigenschappen van de virtuele-agentapp in Virtuele Agent Hub. Bij het testen kunt u:

• Controleer of de virtuele-agentapp correct is geconfigureerd om te communiceren met de virtuele-agentprovider.
• Aangepaste payload-JSON toevoegen om de afhandeling van aangepaste payloadgegevens door de virtuele agent te testen.
• Een welkomstintentiegebeurtenis triggeren om te testen hoe de virtuele agent een conversatie begint.
• Een aangepaste intentiegebeurtenis triggeren om alle aangepaste gebeurtenissen die u voor uw virtuele agent hebt gemaakt te testen.
• Een timeoutgebeurtenis triggeren om te testen hoe de virtuele agent reageert wanneer het contact een timeout krijgt.

De volgende afbeelding toont een voorbeeld van de pagina Eigenschappen voor een virtuele-agentapp in Virtuele Agent Hub. Het toont de tabbladen Configuratie en Spraak en het paneel Test.

1. Klik in CXone op de app-kiezer en selecteerOverige > Automatisering & AI en klik daarna op Virtuele Agent Hub. U kunt ook dubbelklikken op de virtuele-agentactie die u in uw Studio-script gebruikt om Virtuele Agent Hub te starten.
2. Klik hier om de configuratie-app voor de virtuele agent die u wilt testen te selecteren in de lijst aan de linkerkant.

3. Typ in het Test-paneel een testbericht in het veld Typ een bericht en druk op Enter om dit te verzenden. U kunt ook op het microfoonpictogram klikken en in de microfoon van uw computer spreken.

4. Klik op Starten met welkomstintentie om een testgesprek vanaf het begin te starten. De virtuele agent stuurt een respons met het standaard welkomstbericht. U kunt testberichten invoeren.

5. Klik op Meer opties om andere aspecten van uw virtuele agent te testen.

   Meer informatie over de velden in deze stap

   Veld	Details
   Aangepaste payload-JSON toevoegen	Selecteer deze optie om het verzenden van aangepaste payload-JSON naar uw virtuele agent te testen. Voer de aangepaste payload in bij het tekstvak Aangepaste payload-JSON toevoegen op de pagina Testen en toevoegen. Druk na elke regel op Enter. Stuur een testbericht wanneer u klaar bent om de aangepaste payload te testen. Wanneer u klaar bent met het testen van aangepaste payloads, klikt u op Sluiten in het paneel Aangepaste payload-JSON toevoegen.
   Trigger Welcome Intent Event	Selecteer deze optie om de standaard welkomstintentie De betekenis of de bedoeling van wat een klant zegt of typt; datgene wat de klant wil communiceren of bereiken. te testen. De virtuele agent verstuurt het welkomstbericht. Voer een bericht in als reactie.
   Aangepaste intentie-gebeurtenis activeren	Selecteer deze optie om een aangepaste intentie-gebeurtenis te testen. Typ de Gebeurtenisnaam in het popup-venster en klik op Trigger. De virtuele agent stuurt het bericht voor de intentie die u hebt ingevoerd. Verzend een reactie om de intentie te testen.
   Trigger Timeout Event	Selecteer deze optie om de standaard timeout-intentie te bekijken. De virtuele agent stuurt het geconfigureerde time-outantwoordbericht.

6. Klik op Resetten om de test opnieuw te starten.

7. Als u wijzigingen wilt aanbrengen op basis van de resultaten van uw tests, kunt u het volgende doen:

   • De Studio-scripts voor de virtuele agent aanpassen.
   • De configuratie-instellingen van de virtuele-agentapp aanpassen in Virtuele Agent Hub.
   • De configuratie-instellingen van de virtuele agent aanpassen in de console van de provider. Klik op de grote vierkante knop op de pagina Eigenschappen van de app in Virtuele Agent Hub. Het voorbeeld aan het begin van deze sectie toont de Google Dialogflow CX-app met de knop van de provider. Het pictogram geeft aan dat de link een externe site opent.
8. Test de virtuele agent grondig na elke wijziging in uw scripts of configuratie-instellingen.
9. Wanneer u klaar bent met testen, klikt u op Sluiten.