Phased rollout

 

This version is currently available to SaaS customers only. It will be available to on-premises customers soon.

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

  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.

Important

If you have configured common services as option buttons, they are also displayed in the welcome message.

Was this page helpful? Yes No Submitting... Thank you

Comments