An event is a user action that you consider important (for example, making an order, registering, paying a subscription, visiting a page with tariffs, visiting a product page, etc.)
You can send an event with any name into our system. Events beginning with the dollar symbol are system reserved names. The heading of each event below is its name in the Dashly interface, and the system name is the key the event is available under in the API and SDKs.
Attributes are event properties. Their names are given exactly as they are written
to the event: some of them have no $ prefix and contain spaces.
General:
Communication:
AI agent:
Quiz:
Demo:
CRM:
E-commerce:
For any site type.
System name: $session_start.
User visited the site.
| Attribute | Description |
|---|---|
$referrer |
Referrer (source) |
$referrer_domain |
Referrer (source), domain only |
$browser |
Browser |
$os |
Operating system |
$device |
Device |
$ip |
User’s IP address |
$resolution |
User’s device display resolution |
$device_type |
Device type (pc, mobile, tablet) |
System name: $page_visited.
User opened a page of the site.
| Attribute | Description |
|---|---|
title |
Page title (title tag) |
H1 |
Contents of the h1 tag |
breadcrumbs |
Page breadcrumbs |
URL |
Page URL |
System name: $utm_hit.
UTM tags were detected for the user.
| Attribute | Description |
|---|---|
$utm_source |
UTM Source |
$utm_campaign |
UTM Campaign |
$utm_medium |
UTM Medium |
$utm_content |
UTM Content |
$utm_term |
UTM Term |
System name: $registered.
User created a new account in the personal dashboard.
| Attribute | Description |
|---|---|
$name |
User name |
$email |
User email |
System name: $authorized.
User signed in to the personal dashboard.
| Attribute | Description |
|---|---|
$name |
User name |
$email |
User email |
System name: $conversation_part_group_closed.
One question inside a conversation was marked as resolved.
| Attribute | Description |
|---|---|
$conversation_id |
Conversation ID |
System name: $double_opt_in_confirmed.
User followed the link in the email to confirm their email address.
| Attribute | Description |
|---|---|
$email |
User email |
System name: $double_opt_in_send.
User was sent a double opt-in email to confirm their email address.
| Attribute | Description |
|---|---|
$email |
User email |
System name: $email_changed.
User's email was recorded or changed.
| Attribute | Description |
|---|---|
old_value |
Previous value |
new_value |
New value |
System name: $name_changed.
User's name was recorded or changed.
| Attribute | Description |
|---|---|
old_value |
Previous value |
new_value |
New value |
System name: $phone_changed.
User's phone number was recorded or changed.
| Attribute | Description |
|---|---|
old_value |
Previous value |
new_value |
New value |
System name: $user_status_changed.
User status was recalculated and changed: visitor → engaged → lead → user → customer. Recorded only when the value actually became different; attributes carry the previous and new value and what triggered the recalculation.
| Attribute | Description |
|---|---|
old_value |
Previous value |
new_value |
New value |
trigger_event |
Event that triggered the status recalculation |
System name: $leave_site_attempt.
User moved the cursor toward the browser edge.
| Attribute | Description |
|---|---|
URL |
Page URL |
System name: $logout.
User signed out of the personal dashboard.
System name: $user_banned.
User is blocked in the service. After being blocked, the user cannot write in chat.
System name: $user_unbanned.
User is unblocked in the service (can write in chat again).
System name: $user_merged.
Two users were merged into one — automatically via integrations/import, or manually.
System name: $filled_facebook_lead_ad.
User filled in a Facebook lead form.
System name: $form_sended.
User submitted any form on the site.
System name: $input_filled.
User filled an input field in a form on the site.
System name: $push_subscribed.
User subscribed to Web Push notifications.
System name: $push_unsubscribed.
User unsubscribed from Web Push notifications.
System name: $goal_completed.
User reached a defined goal.
System name: $allowed_data_processing_policy.
User gave consent to processing of their data per the data processing policy.
System name: $allowed_phone_collection.
User gave consent to processing of their phone number per the data processing policy.
System name: $allowed_email_collection.
User gave consent to processing of their email per the data processing policy.
| Attribute | Description |
|---|---|
$email |
User email |
System name: $allowed_cookie_processing_policy.
User consented to the use of cookie files.
Events, connected to manual and auto-messages.
System name: $conversation_user_started.
User started a conversation in chat.
| Attribute | Description |
|---|---|
$body |
Message text (first 255 symbols) |
$conversation_id |
Conversation ID |
System name: $start_screen_opened.
User opened the start screen of the chat widget.
| Attribute | Description |
|---|---|
URL |
Page URL |
System name: $conversation_screen_opened.
User opened the chat conversation screen.
| Attribute | Description |
|---|---|
URL |
Page URL |
System name: $message_sended.
A message was sent to the user.
| Attribute | Description |
|---|---|
$message_id |
Message ID |
$message_type |
Contains auto for auto-messages or manual for manual messages |
$message_name |
Message name (only auto-messages) |
$type |
Contains message type (popup_chat, popup_big, popup_small, email) |
System name: $message_read.
User read the message.
| Attribute | Description |
|---|---|
$message_id |
Message ID |
$message_type |
Contains auto for auto-messages or manual for manual messages |
$message_name |
Message name (only auto-messages) |
$type |
Contains message type (popup_chat, popup_big, popup_small, email) |
System name: $message_replied.
User replied to the message.
| Attribute | Description |
|---|---|
$message_id |
Message ID |
$message_type |
Contains auto for auto-messages or manual for manual messages |
$message_name |
Message name (only auto-messages) |
$type |
Contains message type (popup_chat, popup_big, popup_small, email) |
System name: $message_clicked.
User clicked a link in the message.
| Attribute | Description |
|---|---|
$message_id |
Message ID |
$message_type |
Contains auto for auto-messages or manual for manual messages |
$message_name |
Message name (only auto-messages) |
$type |
Contains message type (popup_chat, popup_big, popup_small, email) |
System name: $message_unsubscribed.
User unsubscribed from the email newsletter.
| Attribute | Description |
|---|---|
$message_id |
Message ID |
$message_type |
Contains auto for auto-messages or manual for manual messages |
$message_name |
Message name (only auto-messages) |
$type |
Contains message type (popup_chat, popup_big, popup_small, email) |
System name: $message_control_group.
User fell into the control group of a triggered message, for comparison with the target group.
System name: $message_spam.
User sent an email to spam.
| Attribute | Description |
|---|---|
$message_id |
Message ID |
$message_type |
Contains auto for auto-messages or manual for manual messages |
$message_name |
Message name (only auto-messages) |
System name: $message_bounced.
Bounced – the email was not delivered to the user.
| Attribute | Description |
|---|---|
$email |
User email |
System name: $email_quarantined.
The user's email was temporarily excluded from sending — no emails are delivered to it until the quarantine is lifted.
| Attribute | Description |
|---|---|
$email |
User email |
System name: $email_quarantine_released.
The user's email is available for sending again.
| Attribute | Description |
|---|---|
$email |
User email |
System name: $email_invalidated_by_soft_bounce.
Emails to the user's address repeatedly failed to arrive; the address is marked invalid and sending to it stops.
| Attribute | Description |
|---|---|
$email |
User email |
System name: $chat_bot_sent.
User was sent the lead bot's first message.
| Attribute | Description |
|---|---|
$bot_name |
Lead bot name |
$bot_id |
Lead bot ID |
System name: $chat_bot_read.
User read the lead bot's first message.
| Attribute | Description |
|---|---|
$bot_name |
Lead bot name |
$bot_id |
Lead bot ID |
System name: $chat_bot_replied.
User replied to the lead bot's first message.
| Attribute | Description |
|---|---|
$bot_name |
Lead bot name |
$bot_id |
Lead bot ID |
System name: $chat_bot_interrupted.
User interrupted the conversation with the lead bot.
| Attribute | Description |
|---|---|
$bot_name |
Lead bot name |
$bot_id |
Lead bot ID |
System name: $chat_bot_finished.
User finished the conversation with the lead bot.
| Attribute | Description |
|---|---|
$bot_name |
Lead bot name |
$bot_id |
Lead bot ID |
System name: $telegram_shared_contact.
User shared their contact in the Telegram bot: tapped a button in Telegram that requests contact details.
| Attribute | Description |
|---|---|
Contact |
Contact details the user shared |
System name: $max_shared_contact.
User sent their contact details from the Max messenger.
| Attribute | Description |
|---|---|
Contact |
Contact details the user shared |
System name: $zoom_meeting_joined.
User joined a meeting in Zoom.
System name: $clicked_chat_header_icon_facebook.
User clicked the Facebook icon in the chat widget header to switch to Facebook Messenger as the communication channel.
| Attribute | Description |
|---|---|
URL |
Page URL |
System name: $clicked_chat_header_icon_telegram.
User clicked the Telegram icon in the chat widget header to switch to Telegram as the communication channel.
| Attribute | Description |
|---|---|
URL |
Page URL |
System name: $clicked_chat_header_icon_whatsapp.
User clicked the WhatsApp icon in the chat widget header to switch to WhatsApp as the communication channel.
| Attribute | Description |
|---|---|
URL |
Page URL |
System name: $clicked_chat_header_icon_instagram.
User clicked the Instagram icon in the chat widget header to switch to Instagram as the communication channel.
| Attribute | Description |
|---|---|
URL |
Page URL |
System name: $clicked_chat_header_icon_vk.
User clicked the VK icon in the chat widget header to switch to VKontakte as the communication channel.
| Attribute | Description |
|---|---|
URL |
Page URL |
System name: $clicked_chat_header_icon_viber.
User clicked the Viber icon in the chat widget header to switch to Viber as the communication channel.
| Attribute | Description |
|---|---|
URL |
Page URL |
System name: $clicked_chat_header_icon_max.
User clicked the Max icon in the chat widget header to switch to Max as the communication channel.
| Attribute | Description |
|---|---|
URL |
Page URL |
AI agent events: conversations, lead qualification, and handoff to a manager.
System name: $ai_qualification_started.
The AI-SDR agent started asking questions to qualify the user.
| Attribute | Description |
|---|---|
$conversation_id |
Conversation ID |
Conversation link |
Conversation link |
System name: $ai_qualification_finished.
The AI-SDR agent finished asking qualification questions.
| Attribute | Description |
|---|---|
$conversation_id |
Conversation ID |
Conversation link |
Conversation link |
System name: $ai_conversation_analysis_created.
AI analysis of the conversation was created.
| Attribute | Description |
|---|---|
$conversation_id |
Conversation ID |
System name: $ai_conversation_summary_created.
AI summary of the conversation was created.
| Attribute | Description |
|---|---|
$conversation_id |
Conversation ID |
System name: $ai_user_summary_created.
AI summary of the user was created.
System name: $lead_tier_detected.
User was assigned or had their lead tier (priority level) updated.
| Attribute | Description |
|---|---|
$lead_tier |
Lead tier |
System name: $escalate_to_manager.
The AI agent handed the conversation off to a manager and exited it.
| Attribute | Description |
|---|---|
$conversation_id |
Conversation ID |
Conversation link |
Conversation link |
Manager's name |
Manager's name |
System name: $mention_manager.
The AI agent invited a manager to join the conversation.
| Attribute | Description |
|---|---|
$conversation_id |
Conversation ID |
Conversation link |
Conversation link |
Manager's name |
Manager's name |
Quiz events.
System name: $quiz_visited.
User opened the quiz page.
System name: $quiz_started.
User started answering the quiz questions.
System name: $quiz_finished.
User finished answering the quiz questions.
Product demo request events.
System name: $demo_form_read.
User opened the request form on the site.
| Attribute | Description |
|---|---|
URL |
Page URL |
System name: $demo_form_completed.
User submitted the request form on the site.
| Attribute | Description |
|---|---|
$name |
User name |
$phone |
User phone |
$email |
User email |
$demo_request_page |
Page the request was submitted from |
$accepted_terms |
Consent to the terms of use |
$accepted_privacy_policy |
Consent to the privacy policy |
$is_subscribed_to_newsletter |
Consent to subscribe to the newsletter |
Lead qualification, meeting, and CRM sales funnel events.
System name: $mql.
Lead is qualified as marketing-qualified.
| Attribute | Description |
|---|---|
Dialogue link |
Link to the conversation where the lead was qualified |
System name: $not_mql.
Lead is qualified as not marketing-qualified.
| Attribute | Description |
|---|---|
Dialogue link |
Link to the conversation where the lead was qualified |
System name: $lead_qualified.
Lead qualification completed.
| Attribute | Description |
|---|---|
Is MQL / Is not MQL |
Qualification result: MQL or not MQL |
System name: $meeting_scheduled.
User booked a meeting with the sales team.
| Attribute | Description |
|---|---|
Source |
Where the meeting was booked from |
Meeting service |
Service the meeting was booked in |
$meeting_link |
Online meeting link |
$booking_manager_name |
Name of the manager the meeting is assigned to |
$booking_slot_datetime |
Meeting date and time |
System name: $meeting_rescheduled.
User rescheduled a meeting with the sales team.
| Attribute | Description |
|---|---|
Source |
Where the meeting was booked from |
Meeting service |
Service the meeting was booked in |
$meeting_link |
Online meeting link |
$booking_manager_name |
Name of the manager the meeting is assigned to |
$booking_slot_datetime |
Meeting date and time |
System name: $meeting_cancelled.
User cancelled a meeting with the sales team.
| Attribute | Description |
|---|---|
Source |
Where the meeting was booked from |
Meeting service |
Service the meeting was booked in |
$meeting_link |
Online meeting link |
$booking_manager_name |
Name of the manager the meeting is assigned to |
$booking_slot_datetime |
Meeting date and time |
System name: $calendly_invitee_created.
User booked a meeting via the Calendly widget.
System name: $calendly_invitee_rescheduled.
User rescheduled a meeting booked via the Calendly widget.
System name: $calendly_invitee_canceled.
User cancelled a meeting booked via the Calendly widget.
System name: $crm_contact_established.
Data from CRM: contact with the lead was established.
| Attribute | Description |
|---|---|
Contact channel |
Channel through which contact was established |
System name: $crm_qualified.
Data from CRM: lead was qualified.
| Attribute | Description |
|---|---|
Is MQL / Is not MQL |
Qualification result: MQL or not MQL |
System name: $crm_meeting_scheduled.
Data from CRM: a meeting with the lead was scheduled.
| Attribute | Description |
|---|---|
$booking_manager_name |
Name of the manager the meeting is assigned to |
$booking_slot_datetime |
Meeting date and time |
System name: $crm_meeting_completed.
Data from CRM: the meeting with the lead took place.
| Attribute | Description |
|---|---|
$booking_manager_name |
Name of the manager the meeting is assigned to |
$booking_slot_datetime |
Meeting date and time |
System name: $crm_meeting.
Data from CRM: the meeting with the lead was completed.
System name: $crm_opportunity.
Data from CRM: a sales opportunity exists.
System name: $crm_invoice_sent.
Data from CRM: an invoice was sent to the lead.
| Attribute | Description |
|---|---|
$budget |
Deal budget |
System name: $crm_paid.
Data from CRM: the deal was paid.
| Attribute | Description |
|---|---|
$budget |
Deal budget |
System name: $crm_lost.
Data from CRM: the deal was lost.
| Attribute | Description |
|---|---|
Reason |
Reason the deal was lost |
System name: $crm_lead_delivered.
Data from CRM: lead delivered to CRM.
| Attribute | Description |
|---|---|
CRM stage |
Deal stage in CRM |
E-commerce specific events.
System name: $order_started.
User moved to the first step of the checkout process.
System name: $order_completed.
User completed all checkout steps, an order was created in the store system.
| Attribute | Description |
|---|---|
$order_id |
Order ID (inner) |
$order_id_human |
Order ID (human. Visible to customer) |
$order_amount |
Order amount |
System name: $order_paid.
User paid for the order.
| Attribute | Description |
|---|---|
$order_id |
Order ID |
System name: $order_closed.
User received the order.
| Attribute | Description |
|---|---|
$order_id |
Order ID |
System name: $order_cancelled.
The user or the store cancelled the order.
| Attribute | Description |
|---|---|
$order_id |
Order ID |
$comment |
Comment |
System name: $order_refunded.
User received a refund for the order.
| Attribute | Description |
|---|---|
$order_id |
Order ID |
System name: $cart_added.
User added an item to the cart.
| Attribute | Description |
|---|---|
$name |
Product name |
$url |
Product description page url |
$amount |
Product price (integer) |
$img |
Product image link |
System name: $cart_viewed.
User opened the cart.
All of this event’s properties are arrays.
For example, there are two goods with names A, B and prices 10, 20. Then the $name property will be A,B, and the $amount property value will be 10,20.
| Attribute | Description |
|---|---|
$name |
Array with product names |
$url |
Array of Product description page urls |
$amount |
Array of Product prices (integer) |
$img |
Array of Product image links |
System name: $product_viewed.
User opened a product page.
| Attribute | Description |
|---|---|
$name |
Product name |
$url |
Product description page url |
$amount |
Product price (integer) |
$img |
Product image link |