Chatlayer Documentation
Get in touchAbout Chatlayer
  • Welcome
  • What's new
  • Send feedback
  • start quickly
    • Leadzy tutorial
      • 0. Introduction
      • 1. New bot, new block
      • 2. Understand your users
      • 3. Collect and display user input
      • 4. Steer the conversation with Conditions
      • 5. Empower your bot with Actions
      • 6. Set up a channel and publish your bot
    • Templates
      • Banking
      • E-Commerce Returns
      • E-Bike Shop
      • E-Scooter Support
      • Feedback
      • Find Nearest Location
      • GPT
      • 🆕Gym
      • Job applications
      • Knowledge base AI template
      • Lead generation
      • 🆕NPS
      • Restaurant
      • Retail
  • navigation
    • Analytics
      • Dashboard
      • Customers
      • Conversations
      • User flow
      • Intents
      • 🆕Funnels [Beta]
    • Bot builder
      • Flows
        • Canvas functionalities
        • Collaborate with team members
        • Manage your flows
        • 🆕[Beta] Export and import flows
      • Bot dialogs view
      • Translations
      • Events
    • NLP
      • Dashboard
      • Intents
      • Expressions
      • Entities
      • Train
      • NLP settings
      • Improve
    • Knowledge base AI
      • Add content to your KBAI
      • Build your KBAI flow
      • Use your KBAI source URL in a button
      • Use tags to limit your KBAI content
      • 🆕Use Tables to store your KBAI questions
      • 🆕Manage handover where KBAI is unsatisfactory
    • History
      • Conversations
      • Execution logs
      • Versions
    • Channels
    • Tables
      • Create a table with records
      • Column types
      • Operate on your records
        • Insert record
        • Update record
        • Retrieve record
        • Delete record
      • API
    • Settings
      • Bot settings
      • Offloading
      • Variables
      • Voice
      • Import/Export
  • build your bot
    • Conversation design
      • Plan your bot
      • Conversation design workflow
    • Flow logic
      • Blocks
        • Message
        • Condition
        • Collect input
        • Action
      • Go-to connections
    • 🆕Emulator
    • Tips & best practices
      • Route your flow depending on the time
      • Improve the Not understood block
        • How to create better not understood messages
        • Not understood counter
        • Not understood Google search
      • Go to previous block
      • Recognizing a returning user
      • Skip introduction message
      • Route your flow depending on the channel
      • Reuse flows
      • Connect two bots to each other
  • understand users
    • Natural language processing (NLP)
      • Basic NLP concepts
      • Detect information with entities
        • Match entities
        • Contextual entities
        • System entities
        • Composite entities
      • NLP best practices
        • Word order and diversity of expressions
      • AI intent booster
      • Train your NLP
      • Context
      • NLP import & export
      • Sentiment analysis
    • Languages
      • Supported languages
      • Make your bot multilingual
      • Change language within the conversation
  • set up channels
    • Add a channel to your bot
    • All channels
      • 🚨Facebook Messenger [Deprecated soon]
        • Facebook Admin Removal
        • Facebook Webview Whitelisting
        • Facebook Messenger API updates for Europe
      • 🚨Google Assistant [Deprecated soon]
      • Webhook
      • Web
        • 🚨Web V1 [Deprecated]
          • Customize web widget
          • Live example web widget
        • 🆕Web V2
          • 🆕From Web V1 to V2
          • 🆕Web V2 methods and options
    • Sinch Conversation API
      • Configure your Sinch Conversation API
      • 🆕 Make the most of RCS with Carousels
      • WhatsApp Business API
  • integrate & code
    • API calls
      • Configure your API integration
      • Advanced API features
      • V1 API Reference
      • Custom integrations 101
    • Code editor
      • [Example] Sending data to Airtable (POST)
      • [Example] Retrieving data from Airtable (GET)
      • [Example] Making SOAP requests
    • App integrations
      • Airtable
      • Freshdesk
      • Freshdesk Messaging
      • 🆕Gmail
      • Intercom
      • Mailgun
      • OpenAI: GPT-3, ChatGPT and GPT-4
      • Salesforce
      • 🆕Slack
      • Topdesk
      • Zendesk Support
      • Zendesk Sunshine (beta)
    • 🆕Expression syntax
    • Human handover & live chat
      • Sinch Contact Pro
      • #Interact
      • Genesys Cloud
      • Offloading Webhook
      • Salesforce Service Cloud
      • Sparkcentral by Hootsuite
      • Zendesk Chat
    • Chatlayer messages specifications
  • Publish
    • Publish your bot
      • Publish a flow
  • Analyze & maintain
    • Analytics definitions
    • Data retention
    • Maintenance
    • Session
    • Track events for analytics
  • VOICE
    • 🆕Send bot response as audio
    • Voicebots
      • Create a voicebot
      • Voicebot-specific actions
      • Test your voicebot
      • From chat to voice
  • access & support
    • Identity & Access
      • Single Sign-On (SAML SSO)
    • Billing & subscription
    • Get in touch
    • Chatlayer glossary
    • SaaS Regions & IP Ranges
    • Status
    • Debug your bot
      • No correct response
      • Collect input not working
      • Video isn't working
Powered by GitBook
On this page
  • Conversation
  • User
  • Returning user
  • User Message
  • 'Not understood' message
  • Button click
  • Channel
  • Language
  • Call
  • Timestamp

Was this helpful?

  1. Analyze & maintain

Analytics definitions

Throughout our analytics, we use several key terms. Here are some important terms explained in more detail.

PreviousPublish a flowNextData retention

Last updated 11 months ago

Was this helpful?

Conversation

A conversation starts when a first message is sent. This message can be sent by the user, or by the bot. 15 minutes of silence or no interaction between a user and a bot closes the conversation. If a new message is sent after 15 minutes, a new conversation is counted.

This definition of a conversation is used both in our billing and our analytics.

You can try out your bot in the "test your bot" window on the bottom right of the platform. These conversations are not counted in your analytics or towards your billing.

In the analytics dashboard you can toggle between viewing the results of your DRAFT or your LIVE conversations (learn more about DRAFT and LIVE ). In billing, both DRAFT and LIVE conversations are counted and shown.

Every channel is a different conversation. If the same user talks to your bot on multiple channels, all of these conversations will be counted as separate conversations in both billing and analytics.

User

A user is anyone who sends at least one message to the bot.

If you're on an asynchronous channel like Facebook or WhatsApp, a user will be identified as the same user throughout their entire conversation history with the bot. This means that every Facebook user talking to the bot will only be counted as one user in the analytics.

If your bot lives on a web widget or custom implementation, by default a user will be counted as a new user every time they refresh the web page and start talking to the bot again. However, some clients configure their web widgets in a way that recognizes a returning user through a Sender ID. This way, returning users are only counted as one user.

Returning user

Users that have a conversation during and before the selected time range in the analytics dashboards are counted as a returning user.

If a user had multiple conversations during the selected time range, but no conversations before that range, they will not be counted as a returning user.

User Message

A user message is every interaction from the user with the bot. This can be a typed expression, but also a button click, a file upload, etc.

'Not understood' message

Button click

Some messages will consist of the user clicking a button. This button can appear in a Button template, Quick Replies, Carousel, List, ...

Channel

Analytics for every channel directly connected to Chatlayer can be viewed separately.

Language

Analytics for every bot language can be viewed separately.

Call

A call is every time a user triggers a specific intent. The total number of calls per intent is the amount of times this specific intent was triggered during a given time range.

Timestamp

The timestamp of the data you see in the analytics dashboards is based on the timezone of your browser.

A message is not understood if it's an expression that is not a match with one of the trained expressions, or the NLP confidence score of this expression is below the defined .

here
NLP threshold