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 necessary state of a script.
You can work with script snapshots on the Bots page (Bots – Bots).
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 the 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 following 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. For 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.
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 will be able to restore the script to that state.
Copying a script
With snapshots you can copy scripts. For this you need to create (or select a previously created) a snapshot of the script state that you want to copy, and then restore it as a new script. The new script will contain the same blocks, links, variables and stop words that the snapshot contains.
To copy a script do the following:
- Create a new snapshot of the script or select one you created earlier.
- Click on the history link for the necessary script.
A dialog window will open with a list of all snapshots you have created for this script.
3. Select the snapshot of the script state you want to restore as a new script and click the Restore to new script button.
The system will create a new script with the contents of the selected snapshot. The name of the new script will be the same as the name of the selected snapshot.
When you copy scripts, the status of the copy process is displayed on the Copying scripts page.
On the side menu click Bots – Copying Scripts.
To see the progress of the copy process expand the line with the name of the snapshot.
The copying process includes 4 stages:
- Copying audio files – this stage is relevant if the bot uses audio files instead of speech synthesis in messages
- Copying the snapshot schema with updated identifiers – the snapshot schema is copied
- Saving the scheme in the database – the snapshot scheme is saved in the system
- Copying Twin Al agents – this step is relevant if the snapshot contains NLU agents
When the system copies a script, it executes the above steps one after the other.
Each step has the following statuses:
- Queued – process is waiting to be executed
- In Progress – process is in progress
- Error – process ends with an error (in this case it is recommended to copy the script again. If the error occurs again, you need to send a request to the technical support).
- Completed – process is complete
The copying process is complete if all the steps have the Completed status. Until that you will not be able to use the new script.
4. On the Bots page click the 
button to open the script.
5. After that click the Save button at the top of the script editor.
If the script contains an error, then the appropriate message will be displayed. If the error is minor, it is recommended to correct the script and click Save again. If the error is serious and you cannot fix it, it is recommended to copy the script again.