Microsoft Azure 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: Scripts weergeven, Scripts 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 is VoiceBot Exchange en uw script moet beschikken over het telefoonmediatype Een kanaal zoals spraak, e-mail of chat, waarmee een klant communiceert met een beoogde ontvanger..The supported virtual agent action for this provider is Voicebot Conversation and your script must have the phone media type 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 app toevoegen aan Virtual Agent Hub

Vereiste machtigingen: Scripts weergeven, Scripts maken/bewerken

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

1. Open of maak in Studio een script en voeg een virtuele-agentactie toe als het script er nog geen bevat.
2. Dubbelklik op de virtuele agent-actie om Virtual Agent Hub te openen.
3. Klik op Bot toevoegen.

4. Voer een Naam voor virtuele agent (bot) in en klik op Microsoft Azure in de lijst met virtuele-agentproviders.

5. Klik op Volgende.

6. 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.

7. Klik op Volgende.

8. Als u een tekstgebaseerde virtuele agent configureert, selecteer dan Alleen tekstgebaseerd (geen spraakondersteuning) op de pagina Spraak. Neem contact op met uw CXone-accountmanager als u een spraakgebaseerde virtuele agent aan het configureren bent.

9. Klik op Volgende.

10. 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.

11. Klik op Volgende.

12. 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.

13. Klik op Toevoegen.

Configuratiepagina voor Microsoft Azure

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

Veld	Details
Integratieversie	Selecteer de versie van de Virtual Agent Hub die u wilt gebruiken. Met deze optie kunt u een eerdere versie van Virtual Agent Hub gebruiken totdat u klaar bent om over te schakelen naar een nieuw uitgebrachte versie. De beschikbare versies zijn: Versie 1.0.0: Dit is de eerste versie van Virtual Agent Hub. Het aangepaste payloadobject retourneert als customPayload.payload.xxxx. Versie 2.0.0: Deze versie is niet beschikbaar voor deze provider. Versie 3.0.0: deze versie introduceerde StandardBot, die standaardiseert hoe CXone communiceert met virtuele-agentproviders. Het customPayload-object wordt geretourneerd als een matrix, als customPayloadscriptPayloads[n].xxxx. Deze versie is beschikbaar voor alle providers.
Direct Line-geheim	Voer uw Direct Line-authenticatiegeheim in. Een Direct Line-geheim geeft CXone toegang tot elke conversatie met uw Microsoft Azure virtuele agent. U kunt het geheim terugvinden in het Microsoft Azure-portaal.
Eigen account gebruiken voor Azure Tekst-naar-spraak (in plaats van CXone TTS Cloud)	Stel de schuifregelaar in op Aan als u de tekst-naar-spraakservice van Microsoft Azure wilt gebruiken en als u uw eigen account hebt geconfigureerd. Als u CXone Cloud TTS Hub wilt gebruiken of als u geen TTS-account voor Azure hebt geconfigureerd, dan kunt u de schuifregelaar op Uit laten staan. Op de volgende pagina van de configuratiewizard kunt u Cloud TTS Hub configureren.
Spraakservicesleutel	Voer uw spraakservicesleutel in. Deze sleutel vindt u in het Azure-portaal. U kunt dit veld alleen voltooien als u de tekst-naar-spraakservice van Azure hebt gebruikt.
Regio van spraakservice	Voer de regio-ID in van de regio waarvoor uw spraakservicesleutel is gemaakt. U kunt dit veld alleen voltooien als u de tekst-naar-spraakservice van Azure hebt gebruikt.
Naam TTS-stem	Selecteer in de vervolgkeuzelijst de stem voor tekst-naar-spraak Hiermee kunt u teksten invoeren en door een computerstem laten uitspreken. die deze Azure virtuele agent moet gebruiken. U kunt dit veld alleen voltooien als u de tekst-naar-spraakservice van Azure hebt gebruikt.
Timeoutbericht	Voer het bericht in dat de Azure virtuele agent moet gebruiken wanneer een contact een time-out heeft. Het standaardbericht is: Ben u er nog?
DTMF-uitbraakpatroon	Voer de tekens in die de virtuele agent tijdens een oproep dwingen over te gaan naar de DTMFBreakout -vertakking van het Studio-script. Vul dit veld alléén in voor een spraakgebaseerde virtuele agent.
Welkomstintentie	Voer de ID in van de Azure-welkomstintentie De betekenis of de bedoeling van wat een klant zegt of typt; datgene wat de klant wil communiceren of bereiken. die deze virtuele agent moet gebruiken.
Timeout-intentie	Voer de ID in van de Azure-timeoutintentie die deze virtuele agent moet gebruiken.
Eigen account voor LUIS-app gebruiken om met LUIS Prediction te werken	Zet deze optie Aan als u een account voor de LUIS-app hebt en de LUIS-voorspelling voor intenties De betekenis of de bedoeling van wat een klant zegt of typt; datgene wat de klant wil communiceren of bereiken. wilt gebruiken met uw Azure-bot. Als u de LUIS-intentievoorspelling niet wilt gebruiken met deze Azure virtuele agent, laat u de optie Uit staan. LUIS maakt deel uit van Microsoft Azure Cognitive Service for Language en biedt natuurlijke taalfuncties voor uw virtuele conversatieagents. Raadpleeg voor meer informatie de online Help voor Microsoft Azure Cognitive Service for Language.
LUIS App-ID	Voer de ID van uw LUIS-app in. Dit veld is alleen zichtbaar als de optie Eigen account voor LUIS-app gebruiken om met LUIS Prediction te werken op Aan is gezet.
LUIS Prediction-sleutel	Voer de sleutel in voor de LUIS-app die u met deze Microsoft Azure virtuele agent gebruikt. Dit veld is alleen zichtbaar als de optie Eigen account voor LUIS-app gebruiken om met LUIS Prediction te werken op Aan is gezet.
LUIS Prediction-eindpunt	Voer het eindpunt in voor de Luis-app die u met deze Microsoft Azure-bot gebruikt. Dit veld is alleen zichtbaar als de optie Eigen account voor LUIS-app gebruiken om met LUIS Prediction te werken op Aan is gezet.

TTS van Azure configureren

Vereiste machtigingen: Scripts weergeven, Scripts maken/bewerken

Als u de tekst-naar-spraak van Azure wilt gebruiken met deze virtuele agent, dan moet u al uw eigen Microsoft-account geconfigureerd hebben.

1. Voeg in Virtual Agent Hub een nieuwe configuratie-app toe en configureer deze volgens de stappen in Een app toevoegen aan Virtual Agent Hub op deze pagina.
2. Stel het veld Eigen account voor Azure-tekst-naar-spraak-aanroep gebruiken in op Ja om de service in te schakelen.
3. Voer uw Spraakservicesleutel in. Deze sleutel vindt u in het Azure-portaal.
4. Voer de regio-ID in van de regio waarvoor uw Spraakservicesleutel is gemaakt in het veld Spraakserviceregio.
5. Selecteer de stem en de taal die deze virtuele agent moet gebruiken uit de vervolgkeuzelijst Naam TTS-stem.
6. Ga terug naar Een app toevoegen aan Virtual Agent Hub op deze pagina om het toevoegen van de configuratieapp te voltooien.

Spraakintegratieopties configureren

Vereiste machtigingen: Scripts weergeven, Scripts maken/bewerken

Voor Azure virtuele agents kunt u de Azure-tekst-naar-spraakservice gebruiken, of CXone Cloud TTS Hub.

1. Voeg in Virtual Agent Hub een nieuwe configuratie-app toe en configureer deze volgens de stappen in de sectie Een app toevoegen aanVirtual Agent Hub  op deze pagina.

2. Klik op Volgende op de configuratiepagina.

3. Selecteer de optie voor het soort spraakverbinding dat u gebruikt met uw virtuele agent op de pagina Spraak onder Opties voor spraakintegratie.

   Meer informatie over de velden in deze stap

   Veld

   Details

   Opties voor spraakintegratie

   Selecteer het soort spraakintegratie dat u gebruikt met deze virtuele agent: Turn by Turn-bediening (CXone-spraakbotgateway): Selecteer deze optie als uw scriptie elke beurt van de conversatie met de virtuele agent regelt. Uw script moet de Voicebot Exchange-acties gebruiken. SIP-integratie (backchannel): Selecteer deze optie als u een SIP-backchannelverbinding gebruikt met uw virtuele agent. Neem contact op met uw CXone-accountmanager voor assistentie bij de installatie. Aangepaste telefonie (gRPC, DirectLine Voice, enz.): Selecteer deze optie als u een andere telefonieoptie gebruikt om verbinding te maken met uw virtuele agent. Neem contact op met uw CXone-accountmanager voor assistentie bij de installatie.

4. Als u Gebruik CXone Cloud TTS niet kunt selecteren in het formulier, klikt u op Terug om terug te gaan naar de Configuratiepagina. Schuif de schuifregelaar naar Uit in Uw eigen account gebruiken voor Azure-tekst-naar-spraak. U kunt nu Cloud TTS Hub inschakelen op de pagina Spraak.

5. Selecteer een TTS-leverancier als u gebruikmaakt van Cloud TTS Hub. Als u de TTS-service van de provider van de virtuele agent gebuikt, is dit veld niet zichtbaar en kunt u deze stap overslaan.

6. Selecteer onder Transcriptieopties de optie voor de transcriptieservice die u wilt gebruiken.

   Meer informatie over de velden in deze stap

   Veld

   Details

   Transcriptie-opties

   Selecteer de service die u wilt gebruiken voor transcriptie: Transcriptie van botaccount gebruiken: Selecteer deze optie als u de transcriptieservice van uw virtuele-agentprovider wilt gebruiken. De audio van uitingen van het contact wordt naar de provider verzonden voordat het wordt getranscribeerd. Gebruik CXone-transcriptieprofiel: Selecteer deze optie als u een CXone-transcriptieprofiel wilt gebruiken. Raadpleeg de helppagina van CXone Turn-by-Turn Transcription voor meer informatie.

7. Als u ervoor kiest om een CXone-transcriptieprofiel te gebruiken, klik dan op Transcriptieprofiel om het profiel te selecteren dat u wilt gebruiken. Klik op Nieuw Turn by Turn transcriptieprofiel toevoegen om een nieuw profiel te maken.
8. Klik op Volgende.
9. Ga terug naar de sectie Een app toevoegen aan Virtual Agent Hub  op deze pagina om het toevoegen van de configuratie-app te voltooien.

De Microsoft Azure-app aan een actie toewijzen

Vereiste machtigingen: Scripts weergeven, Scripts 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 Virtual 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 Virtual 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.

Het transcriptieprofiel wijzigen

Vereiste machtigingen: Scripts weergeven, Scripts maken/bewerken

Met een transcriptieprofiel kunt u een andere transcriptieservice gebruiken dan de service die de virtuele-agentprovider aanbiedt. Elke virtuele agent kan maar één transcriptieprofiel hebben. U hoeft de stappen in deze sectie alleen uit te voeren als u met een spraakgebaseerde virtuele agent werkt en het transcriptieprofiel moet wijzigen.

1. Open of maak in Studio een script en voeg een virtuele-agentactie toe als het script er nog geen bevat.
2. Dubbelklik op de virtuele agent-actie om Virtual Agent Hub te openen.
3. Ga naar de lijst met configuratie-apps voor virtuele agents links van de Virtual Agent Hub-pagina en klik op degene die u wilt wijzigen.
4. Ga naar het midden van de pagina Eigenschappen voor de virtuele-agentapp en klik op het tabblad Spraak.

5. Selecteer onder Transcriptieopties CXone-transcriptieprofiel gebruiker, als u dat nog niet had gedaan.

6. Selecteer het Turn by Turn-transcriptieprofiel dat deze virtuele-agentintegratie moet gebruiken. Als de gewenste optie er niet is, kunt u deze toevoegen.

7. Klik op Opslaan.
8. Test uw transcriptieservice met de microfoonoptie in de sectie Test op de pagina Eigenschappen van uw virtuele-agentapp.

De virtuele agentbot testen

Vereiste machtigingen: Scripts weergeven, Scripts 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 Virtual 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.
• Testen hoe de virtuele agent DTMF Toetstonen die worden gegenereerd wanneer iemand op een toets van de telefoon drukt of tikt.-toetstonen verwerkt.

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

1. Open of maak in Studio een script en voeg een virtuele-agentactie toe als het script er nog geen bevat.
2. Dubbelklik op de virtuele agent-actie om Virtual Agent Hub te openen.
3. Klik hier om de configuratie-app voor de virtuele agent die u wilt testen te selecteren in de lijst aan de linkerkant.

4. 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.

5. 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.

6. 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.
   DTMF-invoer	Selecteer deze optie om te testen hoe uw spraakgebaseerde virtuele agent reageert op DTMF Toetstonen die worden gegenereerd wanneer iemand op een toets van de telefoon drukt of tikt.-toetstonen. Voer DTMF-tekens in en klik op Invoerwaarde om de reactie van de virtuele agent op die tekens te zien.

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

8. 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 Virtual 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 Virtual 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.
9. Test de virtuele agent grondig na elke wijziging in uw scripts of configuratie-instellingen.
10. Wanneer u klaar bent met testen, klikt u op Sluiten.