Control Over Events, Tags and Promocodes

There is always a risk that some technical or human error will occur that will cause the processes you have automated to fail. To find out about such problems promptly, set up alerts about:

• Events received during a specific period to ensure the correct functioning of workflows and segmentation by events. If the integration breaks, events stop flowing into the system, associated workflows do not run, and associated conditional segments are not updated.
• Messages with specific tags sent over a specific period to maintain the expected frequency of mailings. Message tracking helps control mailing failures that are not related to the arrival of events: for example, due to a lack of funds.

• The number of promocodes in your Yespo account to ensure that you have enough unused promocodes left because if they run out, the system will not be able to send messages that use the corresponding type of promocodes.

Creating Notification

1. Go to your profile settings → Notifications and click New notification.

2. Select the following parameters:

• Type (Event/Tag/Promocode),
• Title, or in the case of promotional codes – Type,
• Amount,
• Period (only for tags and events),
• Notification type (Alarm or Warning).

3. Click Create.

Notifications are sent through one of the following event types:

• Warning — alertSettingsWarningTriggerEvent
• Alarm — alertSettingsAlarmTriggerEvent

The parameters of these events will contain the following data:

Create a message for each notification type – Warning and Alarm into which the parameter values from the event will be inserted, and a workflow through which this message will be sent.

Substituting Event Parameters into the Message

Create email and/or SMS messages into which data from the event will be inserted using Velocity variables.

Insert the variables into the message involved in the workflow in the $!data.get('name') format,  where

• $!data.get — extract data command,
• the parameter name from which the value should be extracted is indicated in parentheses.

Since events can transmit data about both events and tags or promocodes, messages should be universal, for example:

$!data.get('alertLevel') for the $!data.get('organisationName') organization!

• Notification type: $!data.get('alertTrackingSourceType')
• Tag or event title/promocode type: $!data.get('alertTrackingSourceName')
• The number of sent messages/events/promo codes in the account at the time the notification was sent: $!data.get('actualCount')
• The period selected for counting (only for tags and events): $!data.get('periodDays')
• The lower limit for tags/events/promocodes: $!data.get('threshold')

Setting Workflow

Create 2 workflows – for the Warning and Alarm events – with the Send obligatory (transactional) email or the Send transactional SMS tasks.

Fill in block fields:

1. Send obligatory (transactional) email:

• Contact’s email: manager's email address.
• Message: email with variables.

2. Send transactional SMS:

• Message: SMS with variables.
• Phone: manager’s phone number in full international format.

Connect events to workflows according to the instructions and launch the workflows.

Now, whenever an event occurs related to one or another notification you created, the workflow will launch and send messages with information about the corresponding issues that need attention.