Fragment Status botsessie

Dit fragment wordt gebruikt met acties met de botSessionState-eigenschap, zoals Textbot Exchange en Voicebot Exchange (vanaf hier wordt naar beide acties gewoon verwezen als Exchange). 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.

De eigenschap botSessionState moet worden geconfigureerd met de variabele die de unieke ID bevat voor de conversatie tussen het contact 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 de conversatie begint en geeft deze door aan het script met het eerste antwoord. Het script slaat de ID op in de variabele die is vermeld in de eigenschap botSessionStateVarName (out) van de Exchange-actie. 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.

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()