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 .

The following image shows the updated BMC – Hello dialog structure with multiple nodes:

To update the BMC – Hello dialog

1. Log in to your IBM Cloud account. 
2. Navigate to the IBM Watson Assistant Skills that is configured with  BMC Helix Virtual Agent. 
3. Take a backup of Skills.
4. Click Dialogs, select the BMC – Hello node, and open the JSON editor.

5. 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"
       }
6. (Optional) If you are using a custom dialog:
   1. In "conditions": "#greetings", replace #greetings with the intent name that triggers the greeting dialog.
   2. 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.