The Settings block marks the beginning of a script and is where block connections start. There can only be one starting block in a script, and it cannot be deleted. It serves as a reference point, making it easier to locate the start in complex scripts with many blocks. The starting block configures parameters that will apply to the entire script.
From a block, you can only draw an arrow to one other block.
¶ Block properties
To access properties, click on the block. A properties window will open on the right.
| Property | Description | |
|---|---|---|
¶ General |
||
¶ Basic |
||
| Title |
The title of the script.
|
|
| Debug Mode |
Enabled upon request from technical support and used for identifying and fixing errors in the script. Once checked, detailed logging of the robot’s actions will be started to provide developers with debugging data. After enabling debug mode, repeat the dialog in which problems occur. All errors that occur during the script execution will be logged on the developer's server.
|
|
| Enable Interruptions |
Check this box to enable the bot interruption mode during dialogs. Read more about interruptions in the Interruptions article.
|
|
¶ Voice |
||
|
||
| Language | The language of speech recognized by the system. List of available languages. | |
| Audio Type | Type of voice messages from the robot. Available options: | |
| Synthesis | Speech synthesis of the specified phrase. | |
| Audio Recordings | Playback of pre-recorded audio files attached to the script blocks. If audio files with voiceover are not attached to some blocks for any reason, the text will be voiced by synthesis. | |
| Voice Type | The type of robot's voice in dialogs with the client during speech synthesis. Depending on the chosen voice, the set of settings may vary. | |
| Speech Rate | The speed of speech. It can range from slow and clear to fast and lively, depending on the context and mood of the dialog. | |
| Pitch | The pitch of the voice. The lower the value, the lower the voice sounds; the higher the value, the higher the voice. | |
| Volume | The volume of the speech. It can range from a quiet whisper to loud and clear pronunciation of words. | |
| Emotion |
The emotional tone of the speech. Possible options:
|
|
| Number of Repeats |
How many times the robot will ask the client again if it does not receive or cannot recognize the answer to its question. To ensure the function works properly, add one or more repeat phrases below in the Repeat Request Phrases block.
|
|
| Export All Texts | Allows you to download all phrases from the script blocks. After clicking the button, a file with phrases in .txt format will be downloaded to your computer. This can be useful when voicing the robot using audio recordings. | |
¶ Files repeat phrases |
||
| Phrase |
Specify a phrase in text or audio that the robot will play in dialog with the customer in case no response is received or cannot be processed. Each phrase must be entered or added to a separate field. Phrase fields are added by the Add button and deleted by the |
|
¶ Phrases asking you to say the next part of a large number (audio records) |
||
| Phrase |
Specify a phrase in text or audio that the robot will play in dialog with the customer in case the number spoken by the customer contains fewer characters than expected. Each phrase must be entered or added to a separate field. Phrase fields are added by the Add button and deleted by the Used for decision arrows with output data type Large Number and Phone Number. |
|
¶ Switch to a specialist |
||
| Activate the switch so that if the robot doesn't know what to do, it can be redirected to the operator. | ||
| Forwarding action | Without action | No forwarding is performed when this value is selected. The robot does not take any action if it does not know how to process the request. |
| Connect a call to a channel | Redirection to the preset transfer direction will be performed. In the field that appearsChannel you need to select the desired channel. Channels for translation are created in the sectionVoice bots → Settings→ Transfers. | |
| Any translation direction | When this value is selected, forwarding will be performed to the specified number with the specified header. In the fields that appear, set up the assignment and support headers. | |
| Operator group (for chat) | With the help of operator groups, you can transfer dialogues with customers to different departments of your company or to different specialists, for example, to the sales department, accounting, technical support. | |
¶ Translation phrases for a specialist |
||
| Phrase |
Specify a text or audio phrase that the robot will play in a dialog with the customer before handing over to the technician. Each phrase must be entered or added in a separate field. Phrase fields are added by the Add button and deleted by the |
|
¶ Active ListeningThis is a voice bot feature that makes the dialog more natural. It inserts synthesized or recorded phrases in response to user speech, mimicking the behavior of a live conversational partner. Read more about active listening in the Active Listening article. To activate the active listening feature, switch the toggle to the active position and set the necessary settings. Active listening will then apply to all Question and Pause script blocks. |
||
| Min. Voicing Interval (ms) | The start of the interval from the start of user speech during which voicing phrases can be triggered. | |
| Max. Voicing Interval (ms) | The end of the interval during which voicing phrases can be triggered. | |
| Voice Phrases |
A list of phrases that will be spoken to the user at random times within the specified interval above. Phrases are spoken in random order. Phrases are added by clicking the Add button and removed by clicking the |
|
¶ Additional |
||
| Bring Words to the Base Form |
Allows converting all words in the client's responses to their base form to facilitate speech recognition. Nouns are converted to singular and nominative case (e.g., manager), verbs are converted to infinitive form (e.g., to call), and adjectives are converted to singular, nominative case, masculine gender (e.g., blue). This function also applies when using keywords.
|
|
| Phonetic Corrector for Calls | Allows correcting minor pronunciation errors, e.g., "pyrvet" → "privet" (hello). | |
| Default Block | The block in the script to which the system directs the robot if it does not receive or cannot recognize the client's response to its question. Selected from Question blocks in the current script. | |
| Background Noises | Background noise that creates the desired atmosphere during the conversation with the client, such as office sounds, street sounds, airport sounds. | |
| Timeout Waiting | The period of time in seconds during which the robot will wait for the client's response to a question. If the client answers the robot's question after the specified time and their answer does not correspond to the given question, the system will apply their answer to the Question block specified as the help block. | |
| Number of Cycles | The maximum number of times the robot can pass through a cycle. A cycle is considered a repeated entry by the user into a specific block. The maximum number of cycles is 100. | |
| Help Block Question | The block to which the system applies the client's response if the client does not answer the question within the specified time and their response does not fit the given question. Selected from Question blocks in the current script. For the functionality to work correctly, there must be outgoing arrows from the block selected as the help block. | |
¶ InterruptionsUsed to allow the client to interrupt the bot's speech in dialogues using specific stop-words. When a stop-word is spoken during the bot's speech, the speech ends, and the system moves to the next stage of the script. In the starting block, stop-words of the scenario level are set. For more details on interruptions, see the Interruptions article. |
||
| Platform Interruptions | Shows the list of platform-level stop-words. | |
| Company Interruptions | Shows the list of company-level stop-words. | |
| Ignore Higher-Level Interruptions | Allows disabling platform-level and company-level interruptions. | |
| +Add | Add stop-words one by one. | |
| +Add List of Interruptions | Add stop-words in bulk. Enter words separated by commas for system recognition. | |
¶ Validation of voice acting The process of checking for the presence of voice files for various types of blocks in the script when saving it. |
||
¶ Variables and templates |
||
¶ VariablesAllows you to create variables and set their values. To do this, click Configure Variables to open the settings window. In this window, click Add to the Name field, enter the name of the variable and its value, then click Save. Each variable is added separately. To change or delete a variable, click |
||
| Name | The name of the variable. In variable names, it is allowed to use: Cyrillic letters, Latin letters, numbers, period (.), underscore (_), hyphen (-), square brackets ([]). It is not recommended to use a space bar. |
|
| Type | The type of the variable. The following types are available: | |
| First name or patronymic |
Values of this type can be the following data:
|
|
| Text data | Text data longer than 100 characters. | |
| Date | Date values in YYYY-MM-DD format, time values in HH format:MM:SS, as well as dates and times in the format YYYY-MM-DDTCHH:MM:SS+00:00. | |
| Time | Time values in HH format:MM:SS. | |
| Date and time | Date and time values in YYYY-MM-DDTCH format:MM:SS+00:00. | |
| Amount in rubles |
An integer that the robot pronounces as the amount in rubles.
|
|
| Abbreviation | The data that the robot spells, for example: "where" the robot pronounces as "g", "d", "e". | |
| Phone number | The data is 11 characters long in the following format: 1 character (country code), 3 characters (city code), 3 characters, 2 characters, 2 characters. The robot pronounces this data by digits of the phone number: "Eight, nine hundred and thirteen, two hundred and forty-six, thirteen, thirteen." | |
| Large number |
Numbers longer than three characters. By default, before synthesis, the values are divided into groups of 3 characters, for example, the number 1,982,147 will be pronounced by the robot as 198, 214, 7.
|
|
| Number | Numbers of any length. The entered number will be voiced in full, e.g. 300545567 — “three hundred million five hundred forty-five thousand five hundred sixty-seven”. | |
| Undefined | Any text data with a length of no more than 100 characters. | |
| Keyword templates | Allows you to set keywords at the script level for branches coming out of the Question block with the Keywords output data type. When adding phrases to the keyword template, each phrase must be added to a separate field; it is not necessary to enclose the phrase in quotation marks. The priority of a keyword is set using the numeric field next to each phrase. If you want the phrase to be recognized regardless of the order of the words, you need to separate the phrase with % symbols. If you want the keyword to be recognized regardless of the ending, you can use the * symbol, which stands for any single character or no characters. |
|
.
button.
in the section Variables. In the window that opens, click