Nodes Overview

Nodes are the building blocks of a Flow/Journeys.

In this article, you will learn:

  1. Types of nodes
  2. How to add nodes
  3. What are the configurations available for nodes
  4. How to view Dynamic data

1. Types of nodes#

Nodes are classified into the following types:

NodesDescription
PromptsPrompts can be used when the bot expects a user to respond to the posed question. Click here to learn more.
MessagesMessages can be used when the bot has to display information to the user without expecting any response. Click here to learn more.
ActionActions are non-interactive nodes that can be used to perform a specific task. Click here to learn more.
LogicLogic nodes can be used when the flow must be branched based on the given conditions. Click here to learn more.

After clicking +Create flow, you will be directed to a canvas with a start node from where you will have the flexibility to design a flow.

2. Add nodes#

Nodes can be added in two different ways:

  1. Click the black dot in the centre of a node.

  1. Click any 4 of the icons on the left which represent each category of nodes. Drag and drop the nodes.

2.1 Build a flow#

A flow is built using a series of smaller nodes. Each flow must have a minimum of two nodes configured.

  • Start Trigger: The first node must always be a trigger (click here to learn more). You can configure how to trigger this flow. That is, by means of Intents, Entities, URL Events, or other flows.

  • Add any of the following nodes one by one to continue this flow with logic.

    • Prompts: These nodes expect user inputs- when the input is invalid, fallback messages are displayed. They are interactive/conversational nodes.
    • Messages: Use these nodes to display messages, files, images etc.
    • Actions: Background actions like Database Insert, Search, or executing an API are performed with these nodes.
    • Logic: Conditional branching nodes.
  • Connect all the nodes to complete the flow. Test it on the bot.

3. Configure nodes on different channels#

This option is available for all the nodes that display some information on the bot. For example message and prompt nodes like name node, text node, video node etc. It is used to configure how the information must be produced on different platforms like Website, Alexa, Google Assistant, Voice etc.

  • Click the tools(channel option) symbol available below the node name.

  • Multiple channel options are available for each type of node.

  • Few commonly used configurations are listed below.

3.1 Configure node for a website#

  • Hide Input - When enabled, user input won't be displayed on the bot.
  • Hide Home Button - When enabled and this node is executed in the flow, the user will not be able to click on the home button to restart the flow.
  • Sensitive information - Can be enabled to hide passwords and other personal information from being displayed.
  • Button Auto Width - For Quick replies and multi select, buttons can be configured.
  • Enable Multiple Files - This is used for file-related nodes, which gives the user permission to add more than one file at once.

Enable these options to improve the video viewing experience.

  • Thumbnail - This is the image that will be displayed when the video is not being played.
  • Autoplay - Video will play automatically.
  • Show controls - Controls such as Play/Pause, Forward etc will be displayed.
  • Downloadable - Displayed video can be downloaded to the local system.
  • Muted - Mute the audio until the user unmutes it.
  • Loop - To play the video again once it stops.

3.2 Configure node for a voice bot#

Node-level voice options can be configured for each node specifically. The global voice options that are configured will be applicable for all the nodes and flows for the bot. Whenever a global option and also node level option are defined, for that specific node, the node level option will be given more priority. For example,

  • Global level: You can select an STT/TTS engine globally so that you don’t have to configure it for each node.
  • Node level: You can configure different “recording max duration” for different nodes i.e. 10 seconds for address and 5 seconds for name node.
info

Voice features (and supporting documentation) are constantly getting improved and updated, there may be some issues/feature mis-match. Please get in touch with the team incase of any queries.

Voice bot node options/settings are classified depending upon different uses as below:

  1. Telephony: For settings related to telephony like call forwarding, calling line identity, etc.
  2. Recording: Recording options such as beep sound after a question is asked.
  3. Speech to Text: You can customise a speech recognition software that enables the recognition and translation of spoken language into text.
  4. Text-to-Speech: You can customise the Text-to-Speech (TTS) capabilities to play back text in a spoken voice.
  5. DTMF: Dual-tone multi-frequency (DTMF) is used for touch tones, it is the sound made when pressing a number key. For cases, where we expect background noise and difficulty in correctly identifying the user utterance for numeric inputs, we can use this feature to record user responses.
  6. Conversation: Yellow cloud provides additional conversational options to further customize and elevate the experience on the IVR channel.

note

Most of these options can be configured globally from tools and settings. If they are configured at the node level, node level customisation takes priority over the global level settings.

Telephony related options

FieldsDescription
DisconnectWhen this option is enabled, the call gets disconnected post execution of this node.
Call forwardWhen this is enabled you can enter a number to forward or the SIP. It is used to enable call forwarding to an agent in any specific step. You can either forward the call to an agent's number or forward it to some SIP extension.
Number to forwardThis textbox accepts the number fot the call to be forwarded to ex: Number (+919XXXXXXXXX).
SIP extensionExtension to initiate SIP (Session Initiation Protocol) transfer.
Caller line identityThis field accepts custom caller ID which is sent while forwarding the call to an agent. Note, that this functionality is not supported by all the carriers.
Custom SIP headerThis can be used as an additional parameter that can be passed to an agent while transferring the call to an Agent to pass along bot collected information. You can pass a key-value pair in JSON format which will get passed in the SIP header.

An example of Custom SIP header:

[{“key”:“User-to-User”, “value”:“name=david&product=heater&query=not turning off&priority=high&number=12345”}]

Recording related options

FieldsDescription
Enable recording beepWhen this is enabled, a beep sound will be played after the bot asks a question giving an auditory response to the end-user to respond.
Recording ActionWith the recording management options, you can select to pause/resume/stop recording depending upon different use-cases and conversations. By default, the recording is ON only. Also, in a call, once you STOP the recording (for recording sensitive dialogues), it can’t be resumed back.

STT related options

FieldsDescription
STT engineSelect an engine from the dropdown- Google/Microsoft.
STT modeSelect mode from the dropdown. Microsoft provides "Static", "Streaming" or "Streaming Advanced". Google provides "Static".
STT languageBot Language(ISO code) can be selected from the dropdown. Default- English. Click Microsoft or Google for more information on the languages)
STT engine endpointEndpoint id of the engine selected
Recording max durationThis value is the Max duration for which the bot will wait after asking a question (in any step) even while the user is speaking. For example, after asking “Which city are you from?” and the recording duration value is “5" - the bot records only 5 seconds of user response. This option is necessary to avoid consuming unwanted information and to stay with the conversational flow. If the user mistakenly replies with long paragraphs when a question is asked or if the user's response is getting shadowed with constant background noises, the bot must not process those long inputs. Hence, with this configuration, the bot only takes the necessary response and can quickly process the user response.
Recording silence durationThis value is the Max duration for which the bot will wait after asking a question (in any step) for the user to respond. For example, if recording silence duration is 5 seconds, bot waits for 5 seconds for the response if the user is silent. If the user does not respond anything within 6 seconds, bot Message will be played.
Initial silence durationTo provide more customization on the silence duration parameter, “streaming” and “streaming-advanced” STT modes (of Microsoft STT engine) allow to specifically configure the maximum acceptable silence duration before the user starts speaking. For example, the acceptable initial silence duration for the application number question could be higher (~3/4 seconds) but in the case of a quick conversational binary question, it could be configured to 1 second.
Final silence durationSimilar to the initial silence duration, the final silence duration is indicative of the maximum duration of pause that the bot will wait for once the user has started speaking. For example, for binary/one-word questions like yes/no we could set the final silence duration to ~0.5/1.0 seconds and for address-like fields where taking a pause is intrinsic in conversation, we can set the final silence duration to ~1.5/2.5 seconds.

TTS related options

FieldsDescription
TTS engineSelect the engines from the dropdown- Microsoft Azure, Google Wavenet, Amazon Polly.
Text typeSelect Text/SSML from the dropdown.
TTS languageBot Language(ISO code) can be selected from the dropdown.
PitchPitch value can be any decimal value depending on the base of voice required, 0 is ideal. You can add this for Microsoft if text_type = "text" and for Google for text_type = "text" and "SSML".
Voice IDType the characters of voice ID. You can add this for Microsoft if text_type = "text" and for Google if text_type = "text" and "SSML".
TTS SpeedThis value defines how fast the bot must converse. This value can be 0.9 - 1.5 for the bot to soundly humanly. You can add this for Microsoft if text_type = "text" and for Google if text_type = "text" and "SSML".

DTMF related options

FieldsDescription
Capture DTMFEnable this option if the DTMF is to be collected on the specific node.
Capture voice with DTMF inputWith this enabled, the bot will be able to capture both voice and DTMF for the same question. Example - What is your mobile number? Note - Bot will only capture the one which comes first from the user be it speech response or DTMF response.
DTMF digital lengthEnter the length of characters to be captured. Ex: For an indian phone number, it is 10.
DTMF finish characterCharacter which defines when the bot must stop capturing. Supported finish characters - "*" and "#"
info

Either DTMF digital length or DTMF finish character can be configured. DTMF digit length, DTMF finish character and DTMF timeout are 3 ways in which the bot understands when to stop capturing: 1) Digit Length is useful when you are capturing fixed-length data. Ex: Phone number. 2) Finish character is useful when you don't know the length and that could vary depending upon different states/products. Ex: Model id, application number. A user can define either "*" or "#" to inform that all Digits are added. 3) DTMF timeout is a default inactivity timeout (not open for configuration) and it is set to 10 seconds by default (it overrides digit length and finish character). For example, if the length is 11 and the user has only entered 6 characters, and there are 10 seconds of inactivity, only those will be captured.

Conversation related options

FieldsDescription
Enable acknowledgement messageWhen this is enabled, an acknowledgement kind message (“hmmm” OR “okay”) could be spoken in the conversation immediately. This is a small custom feature built to bring more human touch to the conversation.
Acknowledgement messageEnter a text/SSML message depending upon the configuration under the Text Type field. Note - Keep it short for a better user experience. Ex: "Do you want to confirm?"
Boost phrasesSome user responses can be confusing for the bot to understand. Region specific words, new genz lingos, internet terminologies, trending phrases, abbreviations are trained specially so that the bot understands the exact intention. For example, COVID is a new term that has been used frequently, the phrase COVID must be boosted, otherwise it gets translated to kovind/ go we/ co-wid etc. Ex - you should add the phrases that you expect from the user response like, < I want to take covid vaccine >

note

The rest of the options will be displayed for each of the configured channel. Viber, Telegram, Whatsapp, Google assistant, Alexa, etc.

3.3 Configure node for Google assistant#

  • End Session - Bot session on google assistant comes to an end when this node is reached.

3.4 Configure node for Alexa#

  • End Session - Bot session on Alexa comes to an end when this node is reached.

4. View dynamic data#

Instead of adding information to these nodes manually, you can add objects to the Dynamic data. This option is available on most of the Prompt and Message nodes. You can click on the i next to Fetch from and find the variable data.


What Next?

  • Build a flow and test it.
  • Explore more about the types of nodes in the further sections.