Skip to content

Create your first bot with Tock Studio

The best way to try Tock is probably to create a first conversational bot using Tock Studio (the graphical user interface provided with the platform).

By connecting to the Tock demonstration platform, it is possible to both design and test a conversational assistant in a few minutes, without having to write code.

What you will build

  • An application and a connector on the Tock demo platform

  • A story: user sentence / bot answer, testable through the Tock Studio interface

  • An assistant who answers, when you say “hello”! 🙂

What you need

  • About 5 to 15 minutes (reading the additional notes)

  • A GitHub account, to connect to the demo platform

Connect to the demo platform

Open to access the Tock demonstration platform.

Important: this platform is not supposed to host bots in production. This is merely a sandbox instance, in order to try the Tock solution without installing it.

A login dialog invites you to connect with GitHub. Only your account ID will be read from GitHub.

Create a Tock application

When accessing the demo platform for the first time, a wizard helps to create the first application:

  • Enter a name for the application

  • Select a language - other languages can be added later

  • Validate to create the application

The just-created application is now visible from the menu: Settings > Language Understanding.

Once the first application has been created, you can create others using Create New Application.

Add a connector

To interact with the bot (through a communication channel), a connector must be used. Numerous connectors are provided with Tock: Messenger, WhatsApp, Google Assistant and Google Home, Twitter, Alexa, Business Chat, Teams, Slack, Rocket.Chat… It is even possible to implement your own connectors to integrate with more channels.

In this tutorial, you will configure a connector for Slack - the collaborative and instant messaging platform. It will be possible to try the bot using the Tock Studio interface - no need to use Slack or get an account.

Create the first connector for your application:

  • Go to Settings > Configurations

  • Create a new Configuration

  • Select the connector type Slack

  • Enter anything e.g. token in Token fields (for the moment)

  • Create

Note that an API Key is automatically generated for the application, once the first connector is created. This key is required to connect to the bot API, in order to leverage the WebHook or WebSocket modes.

Clicking on Display test configurations, you can see another Test configuration has been created. This connector is used when the bot is tested directly through the Tock Studio interface. It allows to try the bot without having Slack, for instance.

Create a story

A conversational bot receives and understands user sentences, using natural-language techniques to identify an intent and possibly entities.

Example: from the sentence “What will the weather be like tomorrow?”, the Tock NLU (Natural Language Understanding) engine should detect a “weather” intent and a “tomorrow” date/time entity precising the question (like a kind of intent variable/parameter).

In order to detect intents and entities, sentences must first be added and qualifieds. The Tock NLU menu allows to manage intents and entities, qualify sentences and supervise the bot training: the more qualified sentences, the more relevant is the bot.

Nevertheless, let’s leave intents and entities for now…

The Tock Stories mode allows to create intents automatically in a few minutes, as well as the expected answers. You will now create a first template of a conversation, using the Tock Studio graphical tools:

  • Go to Stories & Answers > New Story

  • Enter a new user sentence - for instance “hello”

A form now opens to configure the new story creation, the intent, the type of response, etc.

  • In the Add new Answer field, enter the answer - for instance “what a nice day!”

  • End with Create Story

Test the bot

It is time to try the bot and its first story!

  • Go to Test > Test the Bot

  • Say “hello”, the bot answers

Please check that the correct application and language are selected (in case there are more than one) when testing: they are visible in the top-right corner of the interface.

Improve the understanding

By entering various sentences through the Test the bot interface, you can see it does not understand much your phrases - even with sentences very similar to the one at story creation.

The conversational model and the Tock NLU engine must be trained and improved by progressively adding user qualified sentences to feed underlying algorithms and give more and more relevant results.

Although first tries can be deceiving, several qualified sentences (one or two dozens if necessary) usually make a difference and the bot gets more relevant.

  • Go to Language Understanding > Inbox

Here you can see the previously entered sentences, and more interestingly how the bot qualified them. For each sentence, Tock shows the detected intent, the language, as well as the scores (given by the algorithms according to their level of confidence for the sentence).

  • Choose several sentences, for each one: select the correct intent then Validate

  • Return to Test > Test the Bot

  • Check the bot now understands these sentences correctly, as well as slightly-different ones you have never entered!

To go a little further with Tock stories, you could create more stories and test them directly from Tock Studio.

Each bot response comes from the intent detected/triggered, without another form of navigation than the thread of YOUR sentences. Conversational is magic: natural language is the navigation, users are not forced to use traditional links and menus anymore (contrary to Websites and mobile apps).

For curious users, let’s have a word about managing numerous stories and the possible impact on understanding.

If you take time and create many stories, you may experience unintended effects with how work NLU models and algorithms. As an example, numerous intents and entities can make detection difficult (or more random). A general recommendation is to create bots, dedicated to a limited functional perimeter. It makes it easier to train each bot and focus on the model for its own domain. Qualifying a lot of sentences generally improves the bot understanding, however too many sentences (or too similar) can over-train the model for an intent, resulting in degraded performance.

As a conclusion, remember the design and maintenance of conversational models is complex, it requires training (the bot, as well as people building it), qualifying and adapting the models on a regular basis to user needs and language.


You have just created your first conversational application with Tock.

With a few minutes and no particular knowledge or skill, more importantly without writing or deploying code, you have been able to create a simple conversational workflow and test it online.


In the following sections, you will learn to:

To learn more about Tock Studio and about Tock’s features and deployment modes, you can also browse the more complete user guide.