tFLOW Documentation - 09b. tBot Guidelines - Overview

In this chapter: 


tBot is a tool that automates downloading, renaming, and routing files. Additionally, tBot allows connections to other production tools and provides seamless integration with existing workflows.

How to install

  1. Download last installer version from

  2. Extract installer from zip file and run it.

  3. Run tBot from Desktop:

  1. On first run, enter instance name:

How to update

There are two ways to update tBot:

  1. Download last installer version from

  2. Click “Update tBot”:

  1. Run tBot from Desktop:

  1. These notifications means that new version of tBot is available:

User interface

tBot main screen contains 5 main zones:

  1. Instance name

  2. Version number

  3. tBot tools and settings

  4. Queue list and settings

  5. Work area with list of files and their statuses

Instance name

Instance name used to identify tBot queues in tFlow production queues list.


Import/Export Configuration

tBot provides interface to transfer configuration between instances.

To export current configuration or part of it you should make steps below:

  1. Click “Settings” -> “Export”

  2. Select queues to export

  3. Edit queue properties before export (changes will not affect for current configuration)

  4. Click “Export” and choose file name for configuration file

  5. Default name for file is configuration.xml.


To import configuration or part of it from configuration file you should make steps below:

  1. Click “Settings” -> “Import”

  2. Choose path to configuration file

  3. Select queues to import. They could be of three types:

    • “New” – this queue do not present in current configuration

    • “Equal” – this queue exist and has the same settings for all parameters.

    • “Error” – this queue exist, but some settings are different. You could compare new parameters (left side) and current parameters (right side) and edit configuration before import.

  4. Click “Import”,  queues will be imported to configuration.

  5. If you select "Migrate?" during the import, tBOT will import all queues with real identities. In this case, jobs in tFLOW will not lose their queues.

Set instance name

To change tBot instance name you should make steps below:

  1. Click “Settings” > “Set instance name”

  2. Enter new instance name

  3. Click “Save”

  4. Instance name in tFlow will be updated on next request to server (Check interval value for Download action)

Configure notifications

tBot can send an email notification if error occurred in process. To configure notifications you should make steps below:

  1. Click “Settings”-> “Configure notifications”

  2. Enter valid email on which tBot will send notification.

  3. Edit Subject and body if you want to receive some special information.

  4. You could set custom values for smtp server. Make steps below to change default smtp server (for default tBot uses

    • Open config file (default location: c:\Program Files (x86)\Turbot\TurbotService.exe.config) in text editor.

    • Edit “TurbotService.Properties.Settings” section:

  1. Click “Send test message” to check configuration and send message

  2. Click “Save” to save notifications configuration


On log screen you could find information messages about tBot activities and errors description

If you need to save log, you will need to do:

  1. Go to the Log screen.
  2. Click "Export Log."
  3. Select the location to save the log.
  4. Save.



tBot able to make integration between third party systems. This integrations based on integration profiles. To manage integration profiles you should make steps below:

  1. Click “Profiles” button on main screen

  2. Select profile from list or create new one

  3. Select source and destinations systems

  4. Fill parameters for destination system connection. For source system connection system will be configured in related queue action

  5. Fill mappings between source system fields and destination system fields

  6. Click “Save” to confirm changes


Send to support

If you have any problems with tBot work or configuration, you could contact support via special form in application. tBot will send an email with technical information to support. To send the email, follow the steps below:

  1. Click on “Help” -> “Send to support”

  1. Fill all fields on form:

    • “Client” – Fill information about your company and contact information for feedback: phone or email

    • “Subject” – Shortly describe your problem

    • “Body” – Give us some details: When problem occurs, what actions you made

  2. Click “Send” button


Queues list

How to add new Queue

  1. Click “Add” button on main screen

  1. Give name to new queue

  2. Add some actions to queue and configure them

  3. Click “Save” button

How to edit Queues

  1. Click “Actions” button on Queue in list

  1. Select “Edit”

  2. You can edit any setting on new screen


How to remove Queues

  1. Click “Actions” button on Queue in list

  2. Select “Delete”

  3. Confirm action or not


How to copy Queues

  1. Click “Actions” button on Queue in list

  2. Select “Duplicate”

  3. Change queue name

Process list

This section provides information about all processes in tBot, their statuses and results.

How to filter processes by status

Select “All” tab to see all process or select specific status to filter process by it.


How to see processes from different queues

Collapse queues list to see processes from all queues, otherwise processes will be shown only for selected queue.


How to restart processes

  1. Select a process from list

  2. Click right-click mouse on it

  3. Select “Restart process” from context menu

How to force complete batch processes

  1. Select a process from list

  2. Click right-click mouse on it

  3. Select “Force batch to complete” from context menu

  4. All files in batch will be processed