Events
Last updated
Last updated
Events are used to trigger a flow based on an event that happens in a certain conversation. Multiple types of events allow for widely varying use cases.
To add an event, go to the 'Events' module under Bot dialogs
Create a new event and give it a name. In the dropdown menu, select what type of event you want to create.
This event allows you to guide the user towards a specific flow whenever a variable is changed. While creating a new “variables changed” event, you can select:
Which variable do you want to watch
Which bot dialog should be triggered whenever this variable changes
Whenever the variable is changed, for example in a go-to, when a button is clicked, or when an entity is detected, this event will be triggered. If the bot dialog triggered by the event has multiple messages, or connects to other bot dialogs, a go-to will show all of these.
If the bot dialog from where the variable was changed connects to other bot dialogs, these will be shown after the bot dialog of the event.
In this flow, for example, a variable is changed in a quick reply in the 'Change variable' bot dialog that triggers an event. This event triggers the 'Event triggered' bot dialog, which has a 'Go to' that points to 'Event triggered step 2'. After these messages, the flow is redirected to the 'Send back after event' action, where the following configuration is placed.
This results in the following flow:
The changed variables are also stored in the user session, where you can access them in the events.variablesChanged array.
Our customers often use the 'variables changed event' to perform an API request through an API action whenever a specific variable changes.
With this event you can steer the conversation in a new direction when the user stops responding. It allows you to configure which bot dialog is triggered if the bot detects a silence, or in other words: when the user does not respond for a certain period of time. You can set the amount of time after which the new dialog will be triggered in the duration field (in minutes).
Essentially, this event starts a timer after the bot's last message; if the user hasn't responded yet when the timer runs out, the bot will prompt the user with a new message of your choosing.
The duration of silence can range from 1 minute to a maximum of 1440 minutes (24 hours).
It is possible to create multiple "Silence Detected" events for one bot. All "Silence Detected" events will start counting down at the same time. This means you can prompt the user at different intervals by setting up "Silence Detected" events with different durations. For example, using one event with a duration of 3 minutes and another of 30 minutes you can first ask the user if they want to continue the conversation after a few minutes silence and then reset the conversation after half an hour of inactivity. It's best not to create multiple events with the same duration. Otherwise the user will be spammed with multiple dialogs at once.
