General Information
On the side menu, click Bots – Bots. As a result, the Bots page will open. This page contains a list of all scripts that you can use to make calls, send messages and chat with your clients using the Twin platform.
You can create scripts manually and copy them between your company accounts.
At the top of the page, there is a button to create new scripts and a link to copy scripts to your affiliated companies.
You can copy scripts to affiliated companies only if your company is a reseller.
Below there is a field for searching scripts on the list.
To find a necessary script, enter its name or ID in the search field. The system will automatically display results that match the specified criteria.
In the center of the page, there is a list of scripts. The list contains the following information:
- ID – script ID (the system generates it automatically when a script is created)
Name – script name. You enter a name for a script when you create it. By name you can easily find a necessary script on the list. - History – a link used to display a window with snapshots of the script
In the right part of the page, there are buttons that are used to perform the following actions:
| Button | Description |
|---|---|
| View and edit script in the editor |
| Save a snapshot of the script |
| Delete script |
About Script Snapshots
As you work on a script, you make changes to it. Using a snapshot, you can save the current state of the script at any time, so that you can return to it later.
A snapshot is a complete copy of a script. It includes all blocks, links, stop words, and variables that are contained in the script.
For each script you work with, you can create an unlimited number of snapshots. This allows you to copy scripts, undo changes and return to the desired state of a script.
You can work with script snapshots on the Scenarios page (Scenarios – Scenarios).
For each scenario, there is the Snapshot button in the Actions field. Using this button, you can manage snapshots of this script.
Saving the Current State of a Script
To save the current state of a script, do the following:
Enter a name for the snapshot in the window that opens.
- Click the Snapshot button for the necessary script.
- Enter a name for a snapshot.
It is recommended to use simple and concise words and phrases for snapshot names. Later this will help you remember why you saved a certain script state. For example, we could recommend you to use the followng names: "basic version of the script" or "version with a male voice."
3. To create the snapshot, click Save.
The current state of the script will be saved in the system.
Restoring a Previous State of a Script
While working on a script, you may need to revert to a previous state of this script (previously saved snapshot). Restoring a saved state will undo any changes you have made to the script since the snapshot has been taken. To do this, follow these steps:
- Click on the History link for the necessary script.
A dialog window will open with a list of all the snapshots you have created for this script.
2. Select a snapshot of the script state you want to restore and then click the Restore to current button.
Снапшот будет восстановлен в текущем сценарии. Все изменения, которые вы внесли в сценарий после создания этого снапшота, будут отменены. При этом все снапшоты, которые вы создали для этого сценария, останутся в системе.
The selected snapshot will be restored. Any changes you have made to the script since this snapshot was created will be cancelled. All snapshots that you created for this scenario will remain in the system.
Восстановление снапшота в текущий сценарий не приводит к удалению других снапшотов. После возврата сценария к одному из его сохраненных состояний вы в любой момент можете перевести его в другое сохраненное состояние. Например, на рисунке выше для сценария "Вопрос клиенту" было создано 2 снапшота. После восстановления в текущий сценарий снапшота с названием Базовая версия снапшот Базовая версия 2 будет доступен, и при необходимости вы сможете его восстановить.
Restoring a snapshot does not delete other snapshots. Once a script is restored to one of its saved states, you can restore it to a different saved state at any time. For example, in figure above, 2 snapshots were created for the script. After restoring the Basic version snapshot, the snapshot called Version with a voice will still be available and you wil be able to restore the script to that state.
Copying a Script
С помощью снапшотов можно копировать сценарии. Для этого сначала нужно создать (или выбрать созданный ранее) снапшот того состояния сценария, которое вы хотите скопировать, а затем восстановить его в виде нового сценария. Новый сценарий будет содержать те же самые блоки, связи, переменные и стоп-слова, которые содержит снапшот.
Чтобы скопировать сценарий, выполните следующее:
- Создайте снапшот сценария или выберите созданный ранее.
- Нажмите на элемент управления с названием История в строке нужного сценария.
Откроется окно со списком всех снапшотов, которые вы создали для этого сценария.
3. Выберите снапшот того состояния сценария, которое вы хотите восстановить в виде нового сценария, и нажмите кнопку Восстановить в новый.
Система создаст новый сценарий с содержимым выбранного снапшота. Новый сценарий получит имя выбранного снапшота.
При копировании сценариев на странице Копирование скриптов отображается состояние процесса копирования.
Перейдите в раздел Сценарии – Копирование скриптов).
Чтобы ознакомиться с ходом копирования, разверните строку с названием снапшота.
Процесс копирования включает 4 этапа:
- Копирование аудиофайлов – этот этап актуален, если в сообщениях бота вместо синтеза речи используются аудиофайлы.
- Копирование схемы c обновлением идентификаторов – копируется схема снапшота.
- Сохранение схемы в БД – скопированная схема сохраняется в системе.
- Копирование агентов Twin Al – этот этап актуален, если копируемый снапшот содержит NLU-агенты (подробнее о том, что такое NLU-агент, можно узнать в этом разделе).
При копировании сценария система выполняет указанные выше этапы последовательно один за другим.
Каждый этап копирования имеет следующие статусы:
- В очереди – этап ожидает выполнения.
- В процессе – этап выполняется.
- Ошибка – выполнение этапа завершилось ошибкой (в этом случае рекомендуется скопировать сценарий повторно. Если ошибка возникнет снова, нужно отправить запрос в техническую поддержку).
- Завершено – выполнение этапа завершено.
Копирование сценария можно считать законченным, если все указанные этапы имеют статус Завершено. Пока процесс копирования не будет завершен, воспользоваться новым скриптом не получится.
4. На станице Сценарии нажмите кнопку 
, чтобы открыть скопированный сценарий.
5. После этого нажмите кнопку Сохранить на верхней панели редактора сценариев.
Если в сценарии содержится ошибка, то отобразится соответствующее сообщение. Если ошибка незначительная, рекомендуется внести исправления в сценарий и повторно нажать кнопку Сохранить. Если ошибку устранить сложно, то рекомендуется скопировать сценарий повторно.