Project

Create a Project

Projects consist of a conversation design’s scripts, settings, and data. To create a project:

  1. Click the 🛠 New Project button.

  2. Add a project title.

  3. Select the channel(s) for which you’re designing your project.*

  4. Click Create Project.

*Note: Channels are only for data-capture purposes at this time, but Voxable will eventually use this data to generate channel-specific previews.

Script

Create a Script

Scripts contain a conversational interaction’s messages, message elements, and contextual data. To create a script:

  1. Click the Create Script button.

  2. Enter a title for the script.

  3. Add a user message.

  4. Press return or enter on your keyboard.

  5. Add a bot message.

  6. Continue to add user and bot messages until you model an entire conversational interaction.

Read more about user messages, bot messages, branches, and contexts below.

User Messages

A user message represents something a user says during the course of a conversational interaction with a bot. User messages can be identified by the user avatar: 👤

Add a User Message

Below the script title is a placeholder for the first user message. The script editor defaults to a user message as the first message in the interaction.* To add a user message:

  1. Click the field to the right of the 👤 avatar.

  2. Type a user message. (User message fields currently support a single plain-text entry.)

  3. Press return or enter on your keyboard.

After you press return or enter you will be prompted to add a bot message. Press return or enter at any time to add a message (user or bot) to the script. You can also use the insert menu below the last message in the script to add another message.

*Note: Scripts alternate user-bot-user-bot and Voxable doesn’t support a bot message as the first message in a script at this time.

Delete a User Message

Click the trash can icon in the lower right corner of a user message to delete it from the script.*

*Note: It’s only possible to delete the last message in a script at this time to ensure message branches align.

Bot Messages

A bot message represents something a bot says during the course of a conversational interaction with a user. Bot messages can be identified by the bot avatar: 🤖

Add a Bot Message

To add a bot message:

  1. Follow the steps to enter a user message.*

  2. Click the field to the right of the 🤖 avatar.

  3. Type a bot message. (Bot message fields currently support a single plain-text entry.)

  4. Press return or enter on your keyboard.

After you press return or enter you will be prompted to add a user message. Press return or enter at any time to add a message (user or bot) to the script. You can also use the inset menu below the last message in the script to add another message.

*Note: Scripts alternate user-bot-user-bot and Voxable doesn’t support a bot message as the first message in a script at this time.

Add SSML Tags

Add Speech Synthesis Markup Language (SSML) to change how a bot message sounds when spoken by a synthesized voice. To add an SSML tag to a bot message:

  1. Highlight the text in a bot message you want to mark up.

  2. Use the list in the pop-up menu to select an SSML tag.

  3. Use the options in the following menu to add SSML tag values.

  4. Click ✅ Done.

Preview a Bot Message

There are two ways to preview how a bot message sounds:

  1. Click the play button in the lower right corner of a bot message.

  2. Press the COMMAND + L keys on your keyboard while editing a bot message.

Branches

Conversational interactions can take various paths. Account for these variations by adding branches within the script. Branches represent different responses a user might have to a bot message.

Below any bot message, there are diamonds and each diamond represents a branch.:

Add a New Branch

To add a new branch:

  1. Click the “add branch” text below a bot message.

  2. Click the field to the right of the of the 👤 avatar.

  3. Type a user message.

  4. Press return or enter on your keyboard.

Switch Branches

To view previously created branches and switch between them in the script:

  1. Open a bot message.

  2. Below the bot message, click on the diamond icon of the branch you’d like to view.

The number of diamonds below any bot message indicates how many branches exist at that point in the script. The highlighted diamond with a line descending from it indicates the branch you’re currently viewing.

Contexts

Track context within the script to visualize the shared understanding that develops between the user and the bot over the course of the conversational interaction.

Context Types & Context Values

Contexts have types and values. The context type describes what the context represents in the script. Each context type can be assigned a name and a color. Context types are shared across every script in a project. Here are a few examples of context types:

  • Authentication: Whether or not the user is logged in to a system

  • Name: The user’s name

  • Time of day: The time that a conversation is taking place

The context value describes the value of a context type at a particular point in the script. Here are some examples of context values for the above context types:

  • Authentication: logged in

  • Name: Samantha

  • Time of day: 1 PM

Add Context to a Message

To add a context to a message:

  1. Open a message.

  2. Click the orange plus sign to the left of the message to open the Context menu.

  3. Click 🎯 Context.

  4. Use the search bar or scroll through the menu and select a predefined context type and value to apply to the message.

Create a New Context Type

If the desired context type or value does not already exist, create a new context type and provide a value for it. To create a new context type:

  1. Open a message.

  2. Click the orange plus sign to the left of the message to open the Context menu.

  3. Click 🎯 Context.

  4. Type your desired context type.

  5. Click the +Create new context button at the bottom of the Context menu.

  6. Type your desired context value.

  7. Click Create Context.

Remove Context from a Message

To remove a context from a message:

  1. Open a message with a context you want to remove.

  2. Click the X icon in the context tag of the context you want to remove.

  3. Click Confirm in the warning modal to remove the context.

  4. The text of the context value will be struck through and its line will be terminated. This indicates that the context is no longer relevant from that point on in the script.

To remove the context from the entire script, follow steps 1-3 with the first instance of that context in the script.

Diagram

View the Diagram

View the structure of the script in diagram view. To view the script’s diagram:

  1. Open the script.

  2. Click the view flow icon in the script header.

  3. Pan and zoom the screen to view the script branches in the diagram.

  4. Hover over a branch until it is highlighted and click to navigate to that portion of the script.

Preview

Preview a Voice Script

Preview the script through simulated voice interaction. To preview the script:

  1. Open the script.

  2. Click the preview script icon in the script header.

  3. Click ▷ Start Preview.

  4. Enable microphone access when prompted.

  5. Speak the prompt as instructed.

  6. Listen to the bot response.* (Make sure your volume is on.)

  7. Continue to speak when prompted until the simulation ends at the end of the script.

  8. Navigate to other branches of the script to continue testing.

*Note: Voice synthesis is fully supported in the Chrome browser only. Use the Chrome browser for the best preview experience. Voxable will eventually generate channel-specific on-device.

Did this answer your question?