Creating Events

You can create events in two ways:

  • Automatically (via API, after setting up the launch conditions for regular workflow and workflow based on changes in the contact's field)
  • Manually.

The event sent via API / SDK is automatically registered in Other category with the name with which you stream it to us. After the first request, it will appear in your account, and you can see it in the AutomationEvent types section.

But if you want to use one of our system events, firstly, you need to create it and specify its category.

Creating an Event Type

To create an event manually, go to AutomationEvent types and click New event type.

Create new event

Follow the steps below:

Creating event
  1. Fill in Name (required).
  2. Fill in Key (required). A key is a unique event identifier that is registered in the system. You can fill in any text in Latin, with numbers allowed, for example, click, sale1, etc. The main requirement is that the key should be unique for every event.
  3. Add a description that will help you quickly identify what the event is used for. Next to the event type name in the general list, you will see a document icon; when you hover over it, a description will appear.
Description
  1. In Category, select the necessary event category.

  2. If you enable the Segmentation by events option, switch Use event for contact segmentation. The availability of this option depends on your tariff plan. To enable it, please contact [email protected].

  3. Enable Validate parameters.

    If the option is enabled, the system only accepts an event whose structure complies with the validation rules.

More about validating event parameters >

  1. Click Add.

After this, a new event type appears in the Event types list.

Event types

Now you can link the created event to the workflow so it will run the automated campaign.

Viewing, sorting, and validating event parameters

Go to Automation → Event types to view available event types.

Event types

Activity Statuses

To sort events by activity, select the appropriate filter:

  • All statuses
  • Active
  • Inactive
Activity statuses

At the top of the list, is a set of additional filters to sort events by specific metrics.

Additional filters to sort events

You can sort from highest to lowest value and vice versa.

Event Type Dependencies

Event type dependencies represent the relation between the event type and a workflow or dynamic segment.

Dependencies

To filter event types by dependencies, select the tab:

Enabled segmentation
  • Without dependencies.

📘

Note

One event type can have multiple related workflows and dynamic segments. In this case, dependencies are grouped, and their quantity is displayed.

Event types created for regular workflows and workflows based on contact field changes contain:

  • Segment name, segment ID.
  • Contact field name, contact field ID.
Event types for regular workflows

Click on the dependency to open the Dependencies of event type window, which provides detailed information about the associated workflows and dynamic segments.

Dependencies of event type

The green marker next to the workflow indicates that this workflow is active.

To view and edit related objects, click on the preview icon.

Daily Statistics

Activate the checkbox on the tab in the left menu to filter event types and workflows with declining metrics, as well as events with errors

  • Volume decline
  • Launched workflows decline
  • With errors

Declining metrics are displayed in orange so that you can promptly notice events that require attention.

Daily statistics

Additional Actions with Event Types

Clicking on the three dots in the event type field reveals a menu with the following options.

Additional actions

Analytics

Charts display metrics of event and workflow activity, and error metrics, and include the following categories:

  • Total events count
  • Launch workflow
  • Stop workflow
  • Contact not found
  • Parameters errors
Analytical charts

More about event analytics  >

Event history

This option shows the launch history of the selected event.

Event history

Parameters validation / Structure preview

Add validation parameters so that the system accepts only events that correspond to them.

Parameters validation

If an event is used for contact segmentation and has already been transmitted to the system, you can view its structure on the Structure preview tab and compare event parameters with the validation rules you've set. You can also copy the structure parameters.

Structure preview

📘

Note

When transmitting new parameters, they will add to the event parameter structure, while the existing ones will remain unchanged.

Delete

The event is deleted along with its history, and recovery is not possible

Event Search

To find a specific event, enter its name in the search bar.

Search