Analytics dashboard

The Teneo Analytics Reference Dashboard is an example page that can be used as a reference or starting point to develop web-based analytics dashboards for Teneo. It looks like this:

Analytics Reference Dashboard

The dashboard contains a login form that allows you to login using your Teneo credentials. After you are logged in, the following charts are shown:

  • A bar chart with the sessions per day
  • A pie chart with the most triggered flows
  • A clickable word tree, based on words that appear most frequently in user inputs
  • A sankey diagram that shows the session travel paths

To draw the diagrams, the dashboard uses Google Charts.

The dashboard is created as a single html file with minimal styling that can be downloaded and opened in a browser.

Prerequisites

Before you can use the dashboard you need to have the following:

A published solution with data

Conversations that you have with your bot in Try out are not stored in your bot's data repository. Before you can use the dashboard, you should publish your bot and generate data by interacting with your bot online. Also make sure that you start the Teneo server by logging into Teneo Studio.

Teneo Inquire URL

The Teneo Inquire URL looks like this:

https://[your_team_name].data.teneo.ai/

You should replace [your team name] with the name of your team. You can find it in the top right corner when you login to your environment in the browser.

Log Data Source (LDS)

Additionally you need the name of the Log Data Source of your solution. You can find it by opening the bots page in your browser. The LDS is the last part of the Engine URL of your published solution.

Log Data Source Name

For example, if the Engine URL of your solution is url is:

https://longberry-xxxxx.bots.teneo.ai/longberry_baristas_5jz1h5hxjb3j0931gx7qxwbns2

Then your LDS name would be longberry_baristas_5jz1h5hxjb3j0931gx7qxwbns2

Opening the dashboard

You can use the dashboard by opening the InquireReferenceDashboard.html file directly in your browser. However, you will need to pass on the Teneo Inquire URL and the Log Data Source name. You can do that in 2 ways:

  1. by editing the html file, or
  2. by providing the details as url parameters

Both options are be outlined below.

Option 1: edit the html file

  • Download the latest version of the dashboard from here by clicking the Source code (zip) on github
    • Unzip the downloaded file
  • Open the file InquireReferenceDashbaord.html in a text editor and edit the following lines:
    • Line 85: replace https://your_team_name.data.teneo.ai/ with the Teneo Inquire URL of your solution
    • Line 86: replace your_lds_here with the LDS name of your solution
  • Save your changes
  • Open file InquireReferenceDashbaord.html in your browser

Option 2: provide url parameters

  • Download the latest version of the dashboard from here by clicking the Source code (zip) on github
    • Unzip the downloaded file
  • Open the file InquireReferenceDashbaord.html in your browser
  • Add the following url parameters at the end of url ?lds=your_lds_name&server=your_teneo_inquire_url
    • Make sure you replace your_lds_name and your_teneo_inquire_url with the appropriate values
  • Hit enter or reload the page in the browser

After you login, you should see the graphs generated.

Was this page helpful?