Customizing the Hello dialog node in IBM Watson Assistant Skills to get the Chatbot Welcome message
As an administrator, you must update the BMC – Hello dialog, if you are using:
- The out-of-the-box workspace
- Your own custom dialog
To update the BMC – Hello dialog, you must replace the out-of-the-box IBM Watson Assistant Skills with the updated JSON .
Important
The BMC – Hello dialog is updated from a single node to a multiple node dialog to retrieve the welcome message that you have configured in the chatbot designer.
The following image shows the updated BMC – Hello dialog structure with multiple nodes:
Warning
To avoid errors, do not delete the dialog nodes after adding them.
To update the BMC – Hello dialog
- Log in to your IBM Cloud account.
- Navigate to the IBM Watson Assistant Skills that is configured with BMC Helix Virtual Agent.
- Take a backup of Skills.
Click Dialogs, select the BMC – Hello node, and open the JSON editor.
- Replace the text in the JSON editor with the following JSON code:Watson Assistant Skill JSON
{ "type": "standard", "title": "BMC - Hello", "output": { "text": { "values": [ "" ], "selection_policy": "sequential" }, "action": { "inputMap": { "chatId": "$chatId", "chatbotId": "$chatbot_id", "chatbotProvider": "$chatbot_channel" }, "outputMap": { "status": "${actionResult.output.status}", "option_buttons": "${actionResult.output.optionsText}", "welcomeMessage": "${actionResult.output.text}" }, "actionTypeName": "getWelcomeMessage", "waitForActionExecution": true } }, "context": { "action_deleted": "<? context.remove('action') ?>", "status_deleted": "<? context.remove('status') ?>" }, "metadata": { "_customization": { "mcr": false } }, "conditions": "#greetings", "digress_in": "does_not_return", "dialog_node": "hello", "digress_out": "allow_all", "previous_sibling": "node_1_1507185247030" }, { "type": "standard", "title": "BMC - Hello : Greet with default message", "output": { "generic": [ { "values": [ { "text": "Hi $fullName!" } ], "response_type": "text", "selection_policy": "sequential" } ] }, "parent": "hello", "conditions": "$status==\"Failure\"", "dialog_node": "node_10_1584475748246", "previous_sibling": "node_2_1584475609479" }, { "type": "standard", "title": "BMC - Hello : Greet with configured message", "output": { "text": { "values": [ "$welcomeMessage" ], "selection_policy": "sequential" } }, "parent": "hello", "context": { "sys_options": "$option_buttons", "display_options_always": "true" }, "conditions": "$status == \"Success\"", "dialog_node": "node_2_1584475609479" }
- (Optional) If you are using a custom dialog:
- In "conditions": "#greetings", replace #greetings with the intent name that triggers the greeting dialog.
- In "previous_sibling": "node_1_1507185247030", replace node_1_1507185247030 with the previous sibling node of your dialog.
The user greeting is added in front of the welcome message according to the User Name Presentation configuration in the chatbot general settings UI.
If an end user's full name is Jonnie Boxter, the welcome message displays:
- Hi Jonnie Boxter, if you have configured to display the full name
- Hi Jonnie, if you have configured to display only the first name
- No user name is displayed in the greeting if you have selected None
If the getWelcomeMessage
action returns an error, the user is greeted in the Hi <Full Name> format, in the welcome message.
Important
If you have configured common services as option buttons, they are also displayed in the welcome message.
Comments
Log in or register to comment.