First steps

We have prepared the interactive tutorial for new users. The tutorial will appear automatically after your first login. After completing the tutorial, you can return to it any time - just click on the left side of menu.

The tutorial will teach you step by step how to use BotEngine features.

In this tutorial, you will:

  • create first story,
  • create first interaction,
  • create and use entity,
  • create references,
  • test your bot.

Create first story

Here you can carry out your specific scenarios. A story contains interactions which are connected with your planned relations.

Story represents scenario between user and bot. You can teach bot how to receive pizza orders, schedule doctor appointments or whatever you choose.

In the first step you will be prompted how to create your first story.

Create first story

After you fill name and description, you need to click the Create button to save changes.

Create first interaction

Interaction represents one of the possible steps in your conversation. It allows you to create a relation between what user says and what bot should do. You can connect interactions with each other and create references to existing ones.

In the second step of our tutorial you will be prompted how to create your first interaction. Below, we have provided an example interaction created for cinema booking application.

Create first interaction

Click here to read more about interactions.

Create entity

Entities are used to extract necessary information from user input queries. They are divided into system entities and user-created entities.

Use entities when you want to recognize repeatable contexts or some variables in user queries, like in this example:

My email is {{sys.email:email}}.

This interaction provides you with the automatic recognition of an e-mail address from the user input message. You can save this information on your external web service or use it to send the e-mail or whatever you choose.

Create entity

When the user invokes this interaction by My email is support@botengine.ai query, JSON response will look like this presented below.

{
  "result": {
    "source": "custom",
    "resolvedQuery": "My email is support@botengine.ai",
    "confidence": 0.7,
    "score": 1,
    "lifespan": 2,
    "incomplete": false,
    "storyId": "592bed47b880ed000778dbaf",
    "interaction": {
      "id": "592e685a6549570006147041",
      "name": "1",
      "action": ""
    },
    "parameters": {
      "name": "support@botengine.ai"
    },
    "contexts": [
      {
        "id": "592e685a6549570006147041",
        "name": "1",
        "parameters": {
          "name": "support@botengine.ai"
        }
      }
    ],
    "fulfillment": []
  }
}

Create first reference

References allow you to use previously created interaction in another point of your conversation. Reference is a shortcut for the existing interaction.

You can see how to use references in the tutorial.

References

Test your story

In the bottom right corner of our application you will find the chat, where you can test all created scenarios. Chat allows you to choose a specific story or test all stories at once.

Test your story

If your input message is correctly recognized, you will see bot’s response. You can also check original JSON response from our query in the top right corner of chat.

Real environment

Once your story is ready, you can integrate it with your application or use our one-click integrations to connect your story with your favorite services.

Read more about integrations:

  • Facebook
  • Slack soon
  • Kik soon
  • LiveChat soon