Events

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.

Events are a versatile way to trigger a flow whenever either:

• a variable changed

• a silence was detected

Note that Events are not the same as Track events, which are used for analytics purposes.

Variables Changed event

Using a Variables Changed event will allow you to trigger a block whenever a variable value is changed. This can happen for example within a Condition block, a button, or even when an entity is detected. In other words, the bot will continue to the next block set to happen when this change of variable was detected.

To add an Variables Changed event to your bot:

1. Open the Events page under the Bot builder tab, on the left-hand side of the screen.

2. Click on Create event.

3. Fill in the event with the features that you would like. In this example, we want to trigger the block called Variable changed whenever the test_variable changed.

4. Click on Create.

Please note that if you want to create an event triggered when a variable changed, that variable needs to be created beforehand, otherwise you won't find it in the dropdown menu.

Create a Variables changed event

This results in the following flow:

A flow example where a Variables Changed event takes place.

And this flow will result in this type of conversation:

An example of conversation using a Variables changed event.

The changed variables are also stored in the user session, from your Debugger tab, where you can access them in the events.variablesChanged array.

Access the changed variables from your Debugger tab.

Customers often use Variables Changed events to perfrom an API request through an API action.

Silence Detected event

Silence Detected events allow you to steer the conversation to a new block when the user doesn't respond for a defined period of time. The duration of silence can range from 1 minute to a maximum of 1440 minutes (24 hours).

Silence Detected events are not the same as Delays, which are a way to wait before the bot goes to the next block. Learn more about Delays here.

To add a Silence Detected event to your bot:

1. Open the Events page under the Bot builder tab, on the left-hand side of the screen.

2. Click on Create event.

3. Fill in the name, trigger and duration (in minutes) that you would like to wait before the next block. In this example, we trigger the block called Next block after 1 minute.

4. Click on Create.

Create a Silence Detected event.

You can create multiple Silence Detected events within one bot. All of them will start counting at the same time, i.e. your bot will prompt the user at several intervals. It's best practice to not create multiple Silence Detected events with the same duration so that users aren't spammed with multiple messages in a row.