Your First Solution

In a few minutes, you will be able to say 'Hello!' to your first solution both in Teneo and online! Let us get started.

Log in to Teneo Studio

First, you need to log in to Studio. The Studio will open in the tab 'My Work'. This gives you quick access to the things you’re working on. As you have not yet created anything, there will be nothing displayed under this tab.

Create a solution

Building a bot in Teneo means building a solution. A solution is a container for all knowledge, conversational logic, and additional resources that make up your bot.

This is what you need to do to create a solution:

  1. Select 'Solutions' in the menu on the left.
  2. Click the 'New' button in the upper right corner. This opens a dialog box.
  3. Fill in a name for your solution, for example My First Solution.
  4. Make sure the solution language for this first bot is English. This will be the mother tongue of your bot.
  5. Under 'Solution Content', choose 'Create from Template' and select the latest version of 'Teneo Dialogue Resources English' from the list. This will boost your bot with lots of pre-built flows. The bot will then, right out of the box, understand and respond to greetings, meta-requests (like 'Can you repeat that?'), feedback (like 'Great!' or 'You are funny') and conversational small talk.
  6. Click 'OK'. It may take a couple of minutes for your solution to be created. You will be notified when it’s done.

Assign Teneo Lexical Resources

Teneo comes with pre-built Lexical Resources (TLRs). The TLRs help your bot to understand a specific language, its words, synonyms, and expressions.

Now, let's specify which TLRs to use for your bot. This is what you need to do:

  1. Open your solution by double-clicking its name in the Solutions window.
  2. Click on the tab 'SOLUTION' in the upper left corner.
  3. Select 'Resources' in the purple bar on the left.
  4. Make sure the 'Lexical' tab at the top of the window is selected.
  5. Select 'Edit' in the upper right corner.
  6. Click 'Assign Lexical Resource' in the upper left corner, and select Teneo Lexical Resources English in the drop-down.
  7. Click 'Save' in the upper right corner.

Now your solution contains all that is needed for your bot to have its first conversation.

Hello World!

Now it is time to talk to your bot. The 'Try Out' panel in the main solution window allows you to test your bot and chat with it.

  1. If you are still in the Resources window, click on the arrow in the top left to go to the main solution window (the 'HOME' tab).
  2. If the Try Out panel is not visible, make it appear by clicking the 'Try Out' button on the right side of the window.

    Because you have just assigned the Lexical Resources, there will be a message at the bottom of the Try Out panel that says 'A reload of the engine is required to apply your recent changes'. Click Reload now to get rid of that message.

  3. Say Hello to your bot. The input field is at the bottom of the panel.
  4. Perhaps you can try some other small talk questions too, like:
    • How are you?
    • My name is John
    • What is my name?
    • I like you

Make your bot available online and talk to it

At the beginning of this page, we said that you would be able to say 'Hello' to your bot online. To achieve this, you must first publish your solution. Publishing a solution means that it will be accessible online (via HTTPS) and once published you can connect your bot to various channels such as Slack, Microsoft Teams, and many more!

To publish your solution, follow these steps:

  1. Find the 'Solution' window and 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'.
  4. You might see a warning Publish to 'Default env' stopped with warnings.
    warning when trying to publish
    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 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 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. Go ahead and try some small talk, like:
    • Hello
    • How are you?
    • My name is John
    • What is my name?
    • I like you

The chat widget that you just tested is known as Teneo Web Chat. This widget can be embedded in websites and supports rich media such as buttons, cards, quick replies, and much more!

It is important to know that when publishing your solution a snapshot of your solution is created. This means that if you update your solution in Teneo, and you wish for your published solution to match the updated version in Teneo, you must republish. To republish follow steps 1-3 above, but instead of choosing ‘Publish’ choose ‘Republish’.

If you want to try out 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 try out your bot.

Summary

Great job, you've created your very first solution and come one step closer to becoming a Teneo ninja! Let's take a quick recap on what we did in this section:

  • Created a 'Solution' that holds all the conversational logic of the bot.
  • Extended the bot with 'Teneo Lexical Resources' (TLRs) which will help the bot understand a specific language and its words, synonyms, and expressions.
  • Explored 'Try Out', which allows you to interact and test the bot directly from Teneo.
  • Published a first solution, making it available online.
  • Interacted with the published bot through the Teneo Web Chat front end.

What's next?

Now that you have created your first solution, open it and create your first flow.

Was this page helpful?