Bixby Developer Center

This guide assumes familiarity with the following information:

• The basics of the editor (Bixby Home Studio Basics)
• The Command node (Sending a Device Command)
• The Response node (Creating a Bixby Response Using Device Status)

In this guide, you'll learn how to use the Custom Dialog Feature to customize the dialog response for a voice command. This allows you to specify Bixby's responses to users instead of using default responses. The device used in this guide is a SmartThings-enabled air conditioner.

In general, you should try to follow the style and tone of Bixby when creating custom dialog. For more information, see the Dialog Design Pattern Guide.

Example Custom Dialog Response: "Failed to turn it on. Please check the filter status before turning on."

Start creating the action flow for this example by dragging a Start node and a Command node from the action flow nodes sidebar to the editor area. Then, connect the Start node's main port to the Command node's trigger port.

Add Custom Dialog to the Metadata

In order to create and use a custom dialog with your device, you have to add the dialog to the dialogs menu in the metadata sidebar.

1. In the metadata sidebar on the left, click the add icon on the right of Dialogs in the Assets menu.
2. A pop-up appears. Type a dialog name and click SAVE. This example uses the dialog name "airInfo."
3. Select a locale for the custom dialog by clicking an empty box next to one of the listed locales. This example uses the en locale.
4. On the blank line, type in the custom dialog. This example uses "Failed to turn it on. Please check filter status before turning on." To add more custom dialogs, click ADD. The new custom dialog option, airInfo, will appear under Dialogs in the metadata sidebar.

You can now use the custom dialog in your action flow.

Use Custom Dialog

To use custom dialog in your action flow, do the following:

1. Add one Response: Success node and one Response node to the graph.
2. Connect the Command node's success port to the Response: Success node and the failure port to the Response node.
3. Click the Response node that is connected to the Command node's failure port. This opens the Node Configuration menu on the right.
4. Click the SELECT DIALOG button.
5. The Select Dialog pop-up appears. At the top left corner, select Metadata in the menu.
6. Select the airInfo dialog and click SAVE.

Here's the finished action path:

Choose Default Dialog

You must choose a default dialog if you have not entered custom dialog for all locales.

To choose default dialog:

1. In the Dialog tab, click SELECT.

2. The Select Dialog pop-up appears. Choose one of the listed default dialogs and click SAVE.

The default dialog appears to the right of Default Dialog in the Dialog description box. The default dialog also appears in various locales in the Templates section of the Dialog description box.

Test Your Action Flow

To test the action flow, click the Try It button at the top right of the editor window. The flow editor should look like this:

In this test run, the command fails. Bixby then lets the user know of the failure with the custom dialog "Failed to turn it on. Please check filter status before turning on."

Additional Resources

The Node Recommendation feature enables you to get recommendations for next possible nodes, and can make it easier to create a graph.

Video Tutorial: Custom Responses and Prompts

The following video tutorial gives another example of how to use custom responses and confirmations in BHS.