Converse

Starts or continues a conversation with a user, using an existing session token.

The Converse action requires the SystemName of your configured conversation system, and a SessionID (session token) for your conversation. You create the session token by using the ManageResources action.

When you want to start a conversation, you can send Converse with only the SystemName and SessionID parameters. In this case, Answer Server runs the conversation task that has the initial state trigger (for example, a default greeting). If you do not have a configured task with the initial state trigger, Answer Server runs the conversation task that has the empty state trigger.

For more information about task triggers, refer to the Answer Server Administration Guide.

After the start of the conversation, you provide user text in the Text parameter. Answer Server processes the user text according to your task configuration, running the appropriate conversation tasks. The action response includes the result of the current task action, which might be a text reply, a request for information, or an acknowledgment, depending on your task configuration.

You continue the conversation by sending further Converse actions with the same SessionID.

Example

http://12.3.4.56:12000/action=Converse&SystemName=MyConversation&SessionID=860028728520387723

This action starts a conversation with session ID 860028728520387723 (previously created by using ManageResources) on the Answer Server accessible by IP 12.3.4.56 and port 12000.

Parameters

Parameter Description Required
SessionID The session token for the conversation session. Yes
SystemName The system that you want to use to converse with the user. Yes
Text The text that the user supplies.  

This action accepts the following standard ACI action parameters.

Parameter Description
ActionID A string to use to identify an ACI action.
EncryptResponse Encrypt the output.
FileName The file to write output to.
ForceTemplateRefresh Forces the server to load the template from disk.
Output Writes output to a file.
ResponseFormat The format of the action output.
Template The template to use for the action output.
TemplateParamCSVs A list of variables to use for the specified template.

Response

You can retrieve the full response XSD by sending the GetResources action with Type set to XSD.


_HP_HTML5_bannerTitle.htm