Congratulations! You are about to discover what Teneo is all about and the core concepts behind it. The 'Getting Started' section will get you started with the Teneo platform. Its subsections will provide you with step-by-step instructions for building intelligent chatbots in Teneo.

Once you are done, we will show you more in the following sections:

*   [Build Your Bot](/article/build), where you can learn more about building flows.
*   [Deploy Your Bot](/article/deploy), where you can learn about publishing your bot and more.
*   [Analyze Your Bot](/article/analyze) using Teneo Query Language (TQL) and analyze your data.
*   [Optimize Your Bot](/article/optimize) and triggers to make your bot more efficient.
*   [Reference Documentation](https://documentation.artificial-solutions.com/latest/#/), updated together with the newest releases.
*   [Forum](https://community.teneo.ai/), where you can ask questions to a Teneo Developer.


P0 - Teneo in 10 minutes

## My Teneo

You've just requested access and gotten your hands on your fresh Teneo Developers account. If you haven't logged in yet, [please log in using your sign-up credentials](/manage/environment).

Once logged in, you are greeted with My Teneo. My Teneo is divided into three main areas.

*   On the [Environment](/manage/environment) page, you can access your Teneo environment and see the status of your environment.
*   The [Bots](/manage/bots) page allows you to quickly see which chatbots are in your environment.
*   Finally, in the [Teams](/manage/team) page, you can invite your colleagues to your team.

When your environment is ready, the status will change to 'Running', and you will be able to download Studio Desktop. 

![manage environment](//images.ctfassets.net/2vbtnveccz5s/6mSiSRmYSVNfJT426TAHKq/7debebbf58015720a6d90483b59c9f0f/manage_environment.png)


P1 - Teneo in 10 minutes

## Your first step into Teneo Studio

Now that you've opened Teneo Studio, it's time to get to work. Let us start with entering Studio:

1.  Fill in your username and password. The login credentials are the same as for the team console.
2.  Click 'Login'.

Once logged in you will be greeted by the main solution window. Here, you'll find the solutions you have recently worked on and the solutions you own.

3.  Click on the 'Solutions' link in the sidebar to get into the solutions view.

In this view, you can see all the solutions available to you in this environment. A solution can be thought of as a container where all the bot's knowledge is stored.

As you can see, there's already a solution called 'Longberry Baristas' available to you. Each team gets this pre-built solution which can act as a reference solution when you're building your own bot. Let us take a look inside:

4.  Select the solution.
5.  Click on 'Open' above the solutions field.

![1-login](//videos.ctfassets.net/2vbtnveccz5s/6yLeIVi7j74Lckd12d8mTB/e081a3172dc1690791068cdc7bbb6d0e/1-login.mp4)

In this section, you can find meta-information about the solution, such as when it was built, when it was last updated, and when it was last published.

P2 - Teneo in 10 minutes

## Publish your bot on Teneo Web Chat
There are multiple ways of interacting with a chat bot, such as through an app, on a website, or in your car. In order to make your bot available anywhere, you will need to publish it.

Before publishing the bot, let's make sure it is working as intended by having a conversation with it in Tryout:

1.  To the right in the explorer window, you'll find Tryout.
2.  Chat away!  
Perhaps you could try a conversation like this:
*   `Hello!`
*   `I would like to order a flat white`
*   `John`
*   `Goodbye`

Now, let's publish the Longberry baristas solution so that we can have a chat with it through [Teneo Web Chat](/resource/channels/teneo-web-chat).

1.  To enter the backstage view, click the ‘Solution’ button in the upper left corner.
2.  Select the 'Publish' button. This will take you to the publish page for your bot.
3.  Click the 'Manage' button and, in the drop-down, choose 'Publish' under 'Latest'.
4.  You might see the warning **Publish to** ***'Default env'*** **stopped with warnings** appear.  
    ![publish-error-2](//images.ctfassets.net/2vbtnveccz5s/4cKJX4IlsMoh0EVpfOgjB/aa21f0b677b48651c572f209323764cf/publish-error-2.png?classes=w40)

This is nothing to worry about; the warning is shown when you publish your solution for the first time or when you have made certain global changes. To proceed, just check the checkbox 'Perform full application deployment on try again' and click the 'Try again' button.

Congratulations, you have just made your first solution available online! The next step is to interact with it. There are two ways to interact with a newly published solution: you can either interact with it through a test page or through a chat widget. We are going to show you how to try out your bot through the chat widget, Teneo Web Chat.

1.  Once published, click on the blue 'Open' icon. This will open the Teneo Web Chat in a new browser tab.  

!!! Teneo Web Chat is also available in the [Bots section](/manage/bots) in your team console. You need to publish the bot from Teneo Studio before using it.

2.  Click on the blue icon in the bottom right corner to open up the Teneo Web Chat window.
3.  Have a conversation like the one you had previously in Tryout.

![2-publish](//videos.ctfassets.net/2vbtnveccz5s/5qInlDodzAcgw1AYCPTKlX/79995e3cb87684f71f8eadf4d62155d6/2-publish.mp4)

The chat widget that you just tested is known as [Teneo Web Chat](/resource/channels/teneo-web-chat). This widget can be embedded in websites and supports rich media such as buttons, cards, quick replies, and much more!

!!! If you want to Tryout your published solution via the test page, click ‘Open’ in the publication confirmation pop-up. If you have already closed it, you can click the URL shown in the ‘Publish’ window instead. This will open a test page where you can Tryout your bot.


P4 - Teneo in 10 minutes

## Your first step into a flow

Currently, the 'User wants to order a coffee' flow grabs the coffee type when we mention it in the first input. Unfortunately, this is not currently the case with names. Our goal with the next few steps is to fix that.

Before:

> **User:** I want to order one flat white, my name is John.  
> **Bot:** Ok, what name shall I note for the order?
> 
> **User:** I just told you, my name is John!  
> **Bot:** Thanks for your order, John. Your flat white will be ready for pickup in 5 minutes.

After:

> **User:** I want to order one flat white, my name is John.  
> **Bot:** Thanks for your order, John. Your flat white will be ready for pickup in 5 minutes.

Now let us explore how these conversations are possible!

Start with going back to Teneo Studio and edit the 'User wants to order a coffee' flow, and the option to store the name in the first input while ordering coffee.

1.  Open the flow 'User wants to order a coffee'. This is located inside the 'Flows' folder.
2.  Click on 'Edit' in the top left corner in the flow window. This will bring you into the edit mode of the flow.
3.  Select the Plus icon below 'Order a coffee', followed up with 'After Match' and 'Entity'.
4.  In the panel on the right, scroll down to 'After Match', and paste in the following entity: `PERSON`. This entity will help the bot recognize and capture when a name is mentioned by a user.
5.  Click on 'Add variable mapping' below the entity name.
6.  Now use the drop-down menu below to determine the source 'sPerson' and the target 'userNameForOrder'. This transfers the value from the source and transfers it to the target.

![3-add entity](//videos.ctfassets.net/2vbtnveccz5s/50Kp59Hfzrbfb0iP0gQbnK/597a7f6d18f54783c0574a440e83b777/3-add_entity.mp4)

Now it's time to specify when the output should be skipped:

1.  Select the 'Ask for name' node, this will open the output configuration panel to the right.
2.  In the middle of the output configuration panel, you will find the 'Skip Conditions' field. Click on 'Add' to create a skip condition.
3.  Paste `userNameForOrder` into the 'Skip Conditions' field. This will be evaluated to true if the variable is set and to false if the variable is empty.
4.  Now use the drop-down menu beside 'Skip to' to determine how the flow processing should go on. In this case, it should be 'Get user name'.
5.  Hit 'Save'.

![4-skip condition](//videos.ctfassets.net/2vbtnveccz5s/39C2EHZ15diTfvHWfRUDA1/9954e28a0e81c647e1b56759963c730c/4-skip_condition.mp4)

P5 - Teneo in 10 minutes

## Republish and test your flow

Now that we have updated the flow we need to republish to make the changes available online.

1.  Head back to the Solution window and click 'Solution' in the top left corner.
2.  Select the 'Publish' button, this will take you to the publish page for your bot.
3.  Click the 'Manage' button and in the drop-down choose 'Publish' under 'Latest'.
4.  Once published, click on the blue 'Open' icon. This will open the Teneo Web Chat in a new browser tab.
5.  Click on the blue circle in the bottom right corner to open up the Teneo Web Chat window.
6.  Let us test if the changes we've made work. Open up Teneo Web Chat and paste in the following line: `I want to order one flat white, my name is John.`

![5-republish](//videos.ctfassets.net/2vbtnveccz5s/7JLaJF37SsVOED1uTciZJq/30b492944c5e63cef26c2d6658b37cde/5-republish.mp4)

Congratulations! You have now experienced a small glimpse of what Teneo is capable of.

P6 - Teneo in 10 minutes

Hero - Getting started

Getting started

Congratulations! You are about to discover what Teneo is all about and the core concepts behind it. The 'Getting Started' section will get you started with the Teneo platform. Its subsections will provide you with step-by-step instructions for building intelligent chatbots in Teneo.

Once you are done, we will show you more in the following sections:

*   [Build Your Bot](/article/build), where you can learn more about building flows.
*   [Deploy Your Bot](/article/deploy), where you can learn about publishing your bot and more.
*   [Analyze Your Bot](/article/analyze) using Teneo Query Language (TQL) and analyze your data.
*   [Optimize Your Bot](/article/optimize) and triggers to make your bot more efficient.
*   [Reference Documentation](https://documentation.artificial-solutions.com/latest/#/), updated together with the newest releases.
*   [Forum](https://community.teneo.ai/), where you can ask questions to a Teneo Developer.

Studio Web - P0 - Teneo in 10 minutes

## My Teneo

You've just requested access and gotten your hands on your fresh Teneo developers account. If you haven't logged in yet, [please log in using your sign-up credentials](/manage/environment).

Once logged in, you are greeted with My Teneo. My Teneo is divided into three main areas.

*   On the [Environment](/manage/environment) page, you can access your Teneo environment and see the status of your environment.
*   The [Bots](/manage/bots) page allows you to quickly see which chatbots are in your environment.
*   Finally, in the [Teams](/manage/team) page, you can invite your colleagues to your team.

When your environment is ready, the status will change to 'Running'. A download and a Studio browser link will appear.

![manage environment](//images.ctfassets.net/2vbtnveccz5s/6mSiSRmYSVNfJT426TAHKq/7debebbf58015720a6d90483b59c9f0f/manage_environment.png)

Follow the setup instructions for the Studio Web client.


Studio Web - P1 - Teneo in 10 minutes

## Your first step into Teneo Studio Web

Now that you've opened Teneo Studio Web, it's time to get to work. Let us start with entering Studio:

1.  Fill in your username and password. The login credentials are the same as for the team console.
2.  Click 'Login'.

Once logged in you will be greeted by the main solution window. In this view, you can see all the solutions available to you in this environment. A solution can be thought of as a container where all the bot's knowledge is stored.

As you can see, there's already a solution called 'Longberry Baristas' available to you. Each team gets this pre-built solution which can act as a reference solution when you're building your own bot. Let us take a look inside:

3.  Select the solution to open it.

![login-to-studio-web](//videos.ctfassets.net/2vbtnveccz5s/4VZ4GCxpetqrRR9FZefFWT/f5dedb0884e678574e96d165f201e17e/login-to-studio-web.mp4)

In this section, you can find meta-information about the solution, such as when it was built, when it was last updated, and who the last editor was.

Once your solution is open you will be greeted with the Solution Dashboard page where you can see an overview over your solution properties, together with an explanation on each of the elements inside Teneo.

Studio Web - P2 - Teneo in 10 minutes

## Your first conversation
Being able to have a conversation with your chatbot is a crucial part of the development process to ensure that everything is working as intended. Luckily, you don't have to go far to test your chatbot in Teneo; let us use 'Tryout' to order a coffee!

1.  To the right in the explorer window, you'll find Tryout.
2.  Chat away!  
Perhaps you could try a conversation like this:
*   `Hello!`
*   `I would like to order a cappuccino`
*   `John`
*   `Goodbye`

![teneo-in-ten-tryout](//videos.ctfassets.net/2vbtnveccz5s/3Wv1XmtLNyRR9Y98JnHDf7/32bb7a6909463311e42534bba85fc8ce/teneo-in-ten-tryout.mp4)

Studio Web - P3 - Teneo in 10 minutes

## Your first step into a flow

Currently, the 'User wants to order a coffee' flow grabs the coffee type when we mention it in the first input. Unfortunately, this is not currently the case with names. Our goal with the next few steps is to fix that.

Before:

> **User:** I want to order one flat white, my name is John.  
> **Bot:** Ok, what name shall I note for the order?
> 
> **User:** I just told you, my name is John!  
> **Bot:** Thanks for your order, John. Your flat white will be ready for pickup in 5 minutes.

After:

> **User:** I want to order one flat white, my name is John.  
> **Bot:** Thanks for your order, John. Your flat white will be ready for pickup in 5 minutes.

Now let us explore how these conversations are possible!

Start with going back to Teneo and edit that flow, and the option to store the name in the first input while ordering coffee.

1.  Navigate to 'Solution Structure'. 
2.  Open the flow 'User wants to order a coffee'. This is located inside the 'Flows' folder.
3.  Click on 'Edit' in the top left corner in the flow window. This will bring you into the edit mode of the flow.
4.  Select the Plus icon below 'Order a coffee', followed by 'After Match' and 'Entity'.
5.  In the panel on the right, scroll down to 'After Match', and paste in the following entity: `PERSON`.
6.  Click on 'Add Mapping' below the entity name.
7.  Now use the drop-down menu below to determine the source 'sPerson' and the target 'userNameForOrder'. This transfers the value from the source and merges it to the target.

![add-after-match-studio-web](//videos.ctfassets.net/2vbtnveccz5s/4cp33XA2M8q7SksluWgboU/b543ce179afe58675cee604489b45524/add-after-match-studio-web.mp4)

Now it's time to create an additional path when the user name is mentioned, to specify when the output should be skipped:

1.  Navigate to the Plus icon located under the 'User responds with coffee type'.
2.  Hover over the Plus icon and drag it to the last node, 'Summarize order'. This will create an additional path to be taken when the user name is mentioned together with an Junction.
4.  Click on the Plus icon above 'Ask for name' followed by 'Match' and 'TLML Syntax'.
5.  Paste in the following condition `!{userNameForOrder}` into the Syntax Condition editor. This will be evaluated to true if the variable is set and to false if the variable is empty.
6.  Hit 'Save'.

![save-new-flow-studio-web](//videos.ctfassets.net/2vbtnveccz5s/6iiI0D3MqpqSXA6QaqwCb/8f74ec2ca01df6cd2c4cd7b18a3bccd2/save-new-flow-studio-web.mp4)

Studio Web - P5 - Teneo in 10 minutes

## Test your flow again

Now that we have updated the flow we can test it again.

1. Let us test if the changes we've made work. Click on the Tryout icon to start a new conversation with your bot. 
2. Paste in the following line: `I want to order one flat white, my name is John.`

![finale-studio-web-in-10minutes](//videos.ctfassets.net/2vbtnveccz5s/6yssCbwCOTdnoExJb3vYO0/3da9a32fd35874854fe2b2d71db829ad/finale-studio-web-in-10minutes.mp4)

Congratulations! You have now experienced a small glimpse of what Teneo is capable of.

Studio Web - P6 - Teneo in 10 minutes 

Teneo in 10 minutes

Getting Started - Teneo in 10 minutes

Analyze your bot

Analyze Log Data

Analyzing sessions

Augmenters

Concepts

Extract values with Augmenters

How To

Metadata

Running custom queries

Counting coffees with Metadata

Reference

Teneo Query Language Cookbook

Teneo Query Language Reference Guide

Teneo Query Language Syntax Overview

Teneo Query Language

Data hierarchy

Event

Property

Session

Transaction

How to

Explore session statistics

Find stuck flows

Generate session logs

Locate and view a session

Make use of skip constraints

Make use of sub queries

Query variables

Troubleshoot the Safetynet

Use relative dates in queries

Query Syntax

Command

Constraint

Meta-parameter

Selection

Transformer

Build your bot

Bot design

Best practices

Data footprint

Encrypting user data in sessions

Flow checklist

Plan your bot

Starting a new Teneo project

Writing good answers

Writing good examples

Conversations

Context restrictions

Flow stack

Greeting message

Listeners

Safetynet

Trigger Ordering

Create a custom order group

Handle ambiguous inputs

Make your bot pro-active

Share information between flows

Use listeners

Flows

Bulk Import

Entities

Junctions

Outputs

Sub-Flows

Transitions

Intent triggers

Variables

Add a script to your flow

Branch at the beginning of a flow

Use TLML Syntax Match

Use a Sub-Flow

Use Bulk Import

Language Understanding

Annotations

Attached scripts

Language conditions

Language objects

Languages

Lexical resources

Libraries

Linguistic Modeling Language

Localization

Match requirements

Used words

Combine Match requirements

Create a solution in your language

Create your own language objects

Find language objects and entities

Localize a bot

Normalize the user's spelling

Optimize language conditions

Recognize plural and singular

Store what the user said

Advanced Condition Coding

Annotations Reference

Condition Syntax Reference

DateTime Handler Reference

DateTime Handler

Engine Scripting API Reference

Input Processing Path

Language Object Reference

Prebuilt Entities

Scripting

Engine scripting API

Groovy basics

Integration manager

Resource file manager

Scripts

Add a Groovy class

Add an integration

Add files to your solution

Annotate user inputs

Anonymize user data

Define a scripted context

Populate output parameters

Store input parameters

Test your bot

Run automated tests

Test your bot with Botium

Dialog Tester

Deploy your bot

Engine API

Versioning and Publishing

Publish your bot

Version Flags

Work with Version Flags

SDK's

Android

JavaScript

Node.js

After Match

Extract Entities

Class Manager

Introduction to transitions

Introduction to entities

Deal with Follow-ups

Dialogue and Context Model

Getting started with Teneo

Handle interruptions

Skip conditions

Flows and match requirements

Entities and After Match

Your First Flow

Your First Solution

Optimize your bot

Optimize classes

Improve the balance

Review Inputs

Refine your bot

Debug your bot in Tryout

Use data to improve your bot

Use Teneo's improvement tips

Troubleshooting

My flow doesn't trigger

My flow behaves unexpectedly

I see warnings in Tryout

Suggestions

root

Table of Contents