Dialogs

---

In the toolbar, click Analytics > Dialogs to go to the dialogs page. Here you can view the dialog list and apply filters using the search block.

Filters

Filters are applied together. Suggested options will depend on the values of the previously applied filters.

You can filter dialogs by:

Date and time

When setting the period, you can select time After or Before the selected date, or else Between two dates. Selecting Any will display sessions and phrases for the entire period.

• Conversation start date and time — the default period is 1 day from the current date.
• Conversation end date and time — the default period is 1 day from the current date.
• Message date and time — the default period is 2 weeks before the current date.

ID

The top 5 results with the maximum number of messages will be displayed when selecting filters by IDs.

• Session ID
• Campaign ID
• Channel ID
• Client name — filters sessions and phrases by the specified client name. The telephone number is indicated for the telephone channel.

Message parameters

Client messages include files, images, and all client’s phrases except /start.
Empty messages are /start messages and all system events except fileEvent.
Empty sessions are sessions consisting of empty messages only.

Filter	Description	Flags
Message text	Filters sessions and phrases by the specified text in messages from the client.	Contains Does not contain Equal to
Bot message	Filters sessions and phrases by the specified text in messages from the bot.	Contains Does not contain Equal to
Message tags	Filters sessions and phrases based on message tags.	No tag Any tag Any of the selected Does not contain Not important — tags are not displayed
Comment	Filters sessions and phrases by comment text in phrases.	Contains Does not contain Equal to
Hide empty messages	Hides all empty sessions and empty messages from the Sessions and Phrases reports.	Yes No
Message type	Filters sessions and phrases by message type: client messages or events.	—
Channel type	Filters sessions and phrases by the specified channel type.	—
Message intent	Filters sessions and phrases by the specified intent in the dialog.	—
Message class	Filters sessions and phrases by the specified message class in the dialog.	—
Message state	Filters sessions and phrases by the specified state in the dialog.	—
With errors	Shows only sessions and phrases with unhandled script errors.	Yes No Not important

Class is a state in which the processing of a client’s message starts while state is a state in which the bot generates the response. If there are transitions between states, the class and the state may not match.

State sequence

With the Route filter, you can sort sessions, phrases, and routes by the specified state sequence. When configuring the filter, use:

• > — to specify several states;
• * — to substitute characters or states.

Dialog parameters

Filter	Description	Flags
Dialog result	Filters sessions and phrases by the dialog result set in the script.	Empty — dialogs without results Not empty — dialogs with any result Contains — dialogs that contain any of the selected results Does not contain — dialogs that do not contain any of the selected results Not important — all dialogs are displayed
Conversation tags	Filters sessions and phrases by the dialog tags.	No tag Any tag Any of the selected Does not contain Not important — tags are not displayed
Conversation initiator	Filters sessions and phrases by the dialog initiator.	Client Bot Any
Transfer to agent	Filters sessions and phrases by the presence or absence of a transfer to an agent.	All dialogs With transfer to agent Without transfer to agent — will also display dialogs that were transferred to the agent but where no reply was received
Session data	Filters sessions and phrases by the data added using the $analytics.setSessionData method. Applied filters are combined according to the logical conjunction.	Any value Contains Does not contain Equals Does not equal
Hide empty sessions	Hides all empty sessions and empty messages in them from the Sessions and Phrases reports.	Yes No
Client message count	Filters sessions and phrases by the specified number of client messages in the dialog.	—
Downloaded fields	Enables custom fields for data export.	—

Text campaigns

If you create text campaigns in the project, you can filter dialogs by campaign IDs and results.

• Text campaign ID — displays dialogs which started when the campaigns with the specified IDs were launched.
• Text campaign result — filters dialogs by the results which were assigned to campaigns. The filter includes the following flags:
  • Not important — all dialogs started with campaigns.
  • Empty — dialogs started with campaigns which were not assigned a result.
  • Not empty — dialogs started with campaigns which were assigned a result.
  • Contains — dialogs with the specified campaign results.
  • Does not contain — dialogs without the specified campaign results.

Displaying the result

Sessions

Filtered sessions are displayed as a table with the following columns:

• Start — conversation start date and time.

• Bot name — bot name or ID.

• Count — the number of client messages. The starting message does not count.

• User ID/Call type — client ID or call type.

  Click on the user ID to open the dialog details.

• Session result — session result for conversations with chatbots and in telephone channels.

• Last phrase — the last client phrase.

• Duration — conversation duration from the beginning of the dialog to the last client phrase.

Message statuses

If your bot is connected to Telegram, Viber, or VK, you will see message statuses in the dialog details. The following message statuses are supported:

• SENT
• NOT_SENT
• DELIVERED
• NOT_DELIVERED
• READ

The SENT status is only available in Telegram and VK and the READ status is in Viber and VK.

Phrases

To display the Answer and Markup fields, enable the Show answers and Show form toggles.

Filtered phrases are displayed as a table with the following columns:

• Question — the client phrase.
• Class — the name of the state where the processing of a client’s message started.
• State — the name of the state where the bot generated the response.
• Answer — the bot’s answer.
• Markup:
  • Tags — add tags for the selected phrase.
  • Comment — leave a comment on the selected phrase.
  • Task — create a task to improve the project.
  • Intents — add the selected phrase to a new or existing intent.

Graphics

Here filtered sessions and phrases are displayed as graphs. You can use statistical graphs to visually assess bot usage dynamics.

Routes

The Routes tab displays all state sequences the client reached within one session.

Information about the routes reached allows you to understand at what step clients stop interacting with the bot. Based on such information, you can improve your script and then compare the conversion rate.

Routes are displayed as a table with the following columns:

• Route — the client route from the first state to the last, including nested states.
• Result — the dialog result set in the script.
• Sessions — the number of sessions in which the client moved along a certain route.

Only the first 20 states of the route will be displayed when clicking a certain route. To view all states comprising the route, download a route report.

Export logs

You can download a dialog or phrase logs report as an .xlsx table.

• Click Sessions > Session log to start downloading the session result report.
• Click Phrases > Message log to start downloading the message report.
• Click Routes > Route log to start downloading the route report.

The generated report results depend on the filters applied. To download the full report, reset the filters you applied earlier.