This field type is used with the Assisted Service product and will only be present if the relevant version of that template has been installed. Note that the field also requires the Assisted Service article to be added to the "Assisted Service Article" property in the subsite settings.
The field creates or modifies an existing Assisted Service interaction with the variables provided by the field type.
If you are currently assisting a user the interaction is created/updated for them. If no user is being assisted, an interaction starts, the assisting banner is launched, and a user can be searched for.
Properties#
Label | Description | Type Name |
---|---|---|
Service | The name of the service that will be logged in the interaction. This can also be set by the variables function | SERVICE |
Channel | The name of the channel that will be logged in the interaction. This can also be set by the variables function | CHANNEL |
Interaction variables function | An optional JavaScript function that is executed server-side to pass additional variables to the interaction workflow and to dynamically set the Service and Channel. See below for an example | ACTIONFUNC |
Example#
When this action executes (on page submission) the values of the Service and Channel properties are passed to the Assisted Service product and will be reflected in the assisting banner:
The interaction log is also updated. In this example the user "Leo" was being assisted by "TIMG", the form field set the channel to "Phone" and the service to "Benefits". The timestamp is the time that the form was submitted:
{
"pos": [1, 2],
"acl": [],
"event": {
"private": false,
"description": "Started contact interaction for Benefits via Phone.",
"formData": {
"data": {
"CHANNEL": "Phone",
"ASSISTEDUSER": "Leo",
"SERVICE": "Benefits"
},
"formName": "COMPLETEINTERACTION",
"typeName": "FORM_COMPLETEINTERACTION",
"formDefinitionType": "FORMDEFINITIONEX"
},
"event": "STARTWORKFLOW",
"userRole": "user",
"userId": "TIMG"
},
"fpos": [1, 2],
"timestamp": 1610628293093
}
Variables Function#
To dynamically set the value of the channel or service, return values for
function(helper, processor, props, context, value) {
value = value || {};
value.additionalVariable = "abc123";
value.form_CHANNEL = "This channel";
value.form_SERVICE = helper.getFieldValue("SERVICE");
return value;
}