Fragment Status botsessie

Het fragment Bot Session State is vereist in uw script wanneer u acties gebruikt die de eigenschap botSessionState hebben. Dit omvat acties zoals Textbot Exchange en Voicebot Exchange (vanaf hier worden beide acties eenvoudigweg Exchangegenoemd). De botSessionState-eigenschap moet correct zijn geconfigureerd om uw virtuele agents Een softwareapplicatie die klantinteracties afhandelt in plaats van een live (menselijke) agent. goed te laten werken. Om dit te doen, moet u dit fragment in uw script maken en de acties correct configureren, zoals in de volgende secties wordt getoond.

De eigenschap botSessionState moet worden geconfigureerd met de variabele die de unieke identificatie bevat voor het gesprek tussen de contactpersoon en de virtuele agent. Deze wordt automatisch toegewezen door de provider van de virtuele agent. Met de ID wordt voorkomen dat er een nieuwe sessie wordt gemaakt bij elke beurt in de conversatie en hiermee kan de virtuele agent context tussen beurten behouden.

De provider maakt de identificatie aan wanneer het gesprek begint en geeft deze samen met het eerste antwoord door aan het script. Het script slaat de identificatie op in de variabele die wordt genoemd in de eigenschap botSessionStateVarName (out) van de actie Exchange.. Ten slotte geeft het script de ID van de eigenschap botSessionStateVarName (out) van de vorige beurt door aan de eigenschap botSessionState.

Uw script mag nooit schrijven naar deze eigenschap of de bijbehorende variabele. Uw script moet correct zijn geconfigureerd om de status-ID van de botsessie te gebruiken.

Scriptconfiguratie

Wanneer u een Exchange-actie gebruikt, zijn minstens twee instanties van de actie vereist in uw script. De eigenschap botSessionState in elk van de Exchange-acties moet anders worden geconfigureerd:

• Het eerste exemplaar van de Exchange-actie bevindt zich direct na de Begin-actie aan het begin van het script. Configureer dit als volgt:
  • botSessionState: dit moet leeg zijn.
  • botSessionStateVarName (out): configureer dit met de naam van de variabele waar het script de ID moet opslaan.
• De tweede Exchange-actie bevindt zich later in het script. Configureer dit als volgt:
  • botSessionState: configureer dit met de variabele die wordt gebruikt in botSessionStateVarName (out), in het eerste exemplaar van de Exchange-actie. De variabele moet de status-ID van de botsessie in JSON-indeling bevatten.
  • botSessionStateVarName (out): configureer dit met de naam van de variabele waar het script de ID moet opslaan.
• De derde en eventuele latere exemplaren van de Exchange-actie zijn optioneel. Als uw script deze exemplaren bevat, configureert u deze als volgt:
  • botSessionState: configureer dit met de variabele die wordt gebruikt in botSessionStateVarName (out), in het vorige exemplaar van de Exchange-actie. De variabele moet de status-ID van de botsessie in JSON-indeling bevatten. De status-ID van de botsessie wijzigt meestal niet tussen beurten. Als deze echter wel wijzigt, moet de actie zo worden geconfigureerd dat de wijziging wordt vastgelegd.
  • botSessionStateVarName (out): configureer dit met de naam van de variabele waar het script de ID moet opslaan.

Deze configuratie is vereist voor alle virtuele agents.

Controleer of de botSessionState-eigenschap correct is ingesteld

U kunt een scripttracering gebruiken om te bevestigen dat deze eigenschap correct is ingesteld.

1. Voer een scripttracering uit op een interactie tussen de virtuele agent en een contactpersoon. U kunt een continue tracering gebruiken of een tracering van een specifieke ANI of DNISvastleggen (alleen voor spraakinteracties).
2. Klik in het traceervenster op de regel die overeenkomt met de eerste Virtual Agent Hub-actie (Voicebot Exchange of Textbot Exchange).
3. Controleer in de lijst Variabelen de variabele botSessionState. De waarde moet null (leeg) zijn.
4. Klik in het traceringsvenster op de volgende regel in de tracering na de eerste Virtual Agent Hub-actie.
5. Let op de waarde van de variabele botSessionState.
6. Klik in het traceringsvenster op de lijn in de tracering die overeenkomt met een daaropvolgende Virtual Agent Hub-actie.
7. Controleer de waarde van de variabele botSessionState. Het moet hetzelfde zijn als in stap 5.

Botsessie status-ID converteren naar JSON

De inhoud van de variabele die wordt gebruikt in de botSessionStateVarName (out)-eigenschap, moet worden geconverteerd in JSON en moet worden doorgegeven aan de botSessionState-eigenschap van de tweede Exchange-actie in uw script. Om dit te doen, kunt u een code in een Snippet-actie opnemen of de eigenschap rechtstreeks configureren. Beide benaderingen zijn acceptabel. Het maken van een variabele in een Snippet voor het geconverteerde object heeft echter het voordeel dat het eenvoudiger zichtbaar is waar het converteren plaatsvindt.

Snippet-actie gebruiken

1. Configureer de botSessionStateVarName (out)-eigenschap van de Exchange-actie met de naam van de variabele om de identificatiecode van de sessiestatus vast te leggen. Bijvoorbeeld, botSessionState.

2. Voeg de volgende regel toe aan een Snippet en plaats deze voor de Exchange-actie in uw script:

   ASSIGN botSessionStateOut = botSessionStateOut.asJSON()

   Gebruik de naam van de variabele die u gebruikt in uw script.

3. Configureer de botSessionState-eigenschap in de Exchange-actie met de naam van de variabele die u hebt gebruikt in de ASSIGN-verklaring. Bijvoorbeeld, botSessionStateOut.

Converteren in de eigenschap

Wanneer u de variabele converteert in de botSessionState-eigenschap, gebruikt u de botSessionStateVarName (out)-variabele met de asJSON()-functie. Bijvoorbeeld:

• botSessionStateVarName (out): botSessionState
• botSessionState: botSessionState.asJSON()

Contacten overbrengen van de ene virtuele agent naar de andere

Om de overdracht van contacten tussen virtuele agenten in te stellen, moet u de sessiestatus-ID's van de bot correct instellen. Elke virtuele agent moet een eigen, unieke botsessiestatus-ID hebben. Hierdoor kunnen individuele virtuele agenten de context van het gesprek waaraan ze deelnemen, behouden.

• Virtuele agent 1: Stel de sessiestatusvariabelen van de bot in zoals eerder op deze pagina beschreven.

• Virtuele agent 2: Op dezelfde manier ingesteld, met een andere variabele in botSessionStateVarName (out) om de sessiestatus-ID van de bot vast te houden. Zorg ervoor dat de eigenschap botSessionState leeg is bij de eerste aanroep van deze virtuele agent.  De eerste beurt in het gesprek retourneert een unieke botsessiestatus-ID aan de variabele in botSessionStateVarName (out).
• Alle volgende virtuele agents: Stel dezelfde instellingen in als voor virtuele agent 2, met een unieke variabele voor de sessiestatus-ID van de bot.