First steps
User Data
- Responsive Email Editor Review
- Designing your email
- Creating Synchronized Modules
- Setting Up Responsive Email Design
- Setting Up Smart Containers
- Creating a Gmail Promotions Annotation
- Adding The Rollover Effect
- Adding Anchor Links
- Module Library
- Adding a Table to an Email
- Adding Custom Fonts
- Creating CTA Button
- Working with Images
- Creating Timer
- Using AI in the Email Editor
Omnichannel
- Setting Up Widgets for Your Site
- Widget Calling
- Setting Up Locations for the Widget Calling Rules
- Storing data from widgets to contact fields
- Using Annoyance Safeguard
- Actions After Form Submission
- Replacing Double Opt-In System Workflow
- Creating Pop-ups via Google Tag Manager or WordPress
- Sending Yespo Widget Events to Google Analytics
- Using A/B Tests for Widgets
- Collecting Contact Information Using Request Forms
Automation
- Building and Editing Workflows
- Configuring Workflow Start/Stop Conditions
- Start Block
- Popular Blocks
- Message Blocks
- Using One from Many Message Block
- Contact Blocks
- Conditions Blocks
- Other Blocks
- Message to Segment Blocks
- Time Blocks
- Advanced Workflow Block Parameters
- Setting Up Allowed Send Time
- Using Workflow Launch History
- Webhook Workflows
- Workflow Troubleshooting
- Double Opt-In
- Welcome Сampaign
- Welcome Series Segmented by Category
- Launching a Workflow After a Contact Import
- Regular Workflow for a Segment
- Birthday Campaign
- Linking Workflow to the Button
- Using Variables from Order in Workflow
- Collecting Order Feedback
- Customer Reactivation
- Sending Extra Campaigns
- Sending Reminders at the Time Specified by the User
- Sending Campaign to Those Who Did Not Open the Previous One
- Using A/B Tests In Workflows
Personalization
Analytics
- Email Campaign Report
- Web Push Campaign Report
- Viber Campaign Report
- Mobile Push Campaign Report
- App Inbox Campaign Report
- Telegram Campaign Report
- In-App Report
- Widget Report
- Triggered Campaign Report
- AMP Campaign Report
- SMS Campaign Report
- Multilingual Campaign Report
- Setting up UTM Tags
- Revenue from Campaigns
- Tracking Campaign Performance in Google Analytics 4
- Message Analytics
Multilanguage Campaigns
Events and Behaviour Tracking
Recommendations
API
Security and Compliance
Popular Blocks
Popular — common blocks. There are five blocks in the group:
- End
- Timer
- Task
- Condition
- Check point
End
We recommend using the End block at the end of the workflow and all its paths. Adding this block will help visually understand the logic of the workflow and actions before the end. This is especially useful when the workflow has a path structure and a significant number of other blocks.
Timer
Task
The block is used to set for the workflow one of the following tasks:
- Create contact
- Update contact
- Get contact
- Confirm contact
- Send obligatory (transactional) email
- Send transactional Viber message
- Send transactional SMS message
- Get order
- Create promo code
- Get promo code
- Launch Event
You can select the necessary task from the drop-down menu on the right.
Create Contact
The task is to create a contact in the system. If the contact with this email address already exists in the system, it will be updated. If not, a new contact will be created.
Important
Use this task only when the contact data is passed via the API method Generate event, and only a part of the data needs to be specified when a contact is created. For example, you sent the event via Generate event for a new contact.
With this block, you add this contact to the system. For all other methods, this block is not needed.
The task has 3 parameters:
- Email: required field if you create a contact by email.
- Phone: required field if you create a contact by phone number.
- JSON: field contains a line or a variable with a line in JSON format with contact data (phone number, name, surname, city, additional fields). Email address is specified by default; if needed, specify other additional data.
You can pass the contactJson variable in the JSON field. In this case, REST API will validate the values passed together with this parameter. In case of passing the contact’s parameters with mistakes, the warning returns the invalid and valid values.
Request body for the JSON field:
{"firstname":"...","lastname":"...","sms":"...","town":"...","timeZone":"Etc/GMT+03","languageCode":"uk","profileInputs": [{"profileInputId":10001,"value":"..."}],"confirmed":false}
where
- profileInputs - additional field array;
- profileInputId - additional field ID;
- value - additional field value;
- confirmed - contact email address status (confirmed/unconfirmed)
Important
To create an unconfirmed contact, add "confirmed":false to the request body:
{"firstname":"...","lastname":"...","sms":"...","town":"...","profileInputs": [{"profileInputId":10001,"value":"..."}],"confirmed":false}
To create a contact with a value in the date field, use the format YYYY-MM-DD:
{"profileInputs": [{"profileInputId":10001,"value":"2023/11/06"}]}
To create a contact with a value in the date with time field, use the format YYYY-MM-DDThh:mm":
{"profileInputs": [{"profileInputId":10001,"value":"2023/11/06 16:42"}]}
Update Contact
The task is to update the contact information. If the contact exists in the system, their info will be updated; if the contact doesn’t exist, the system will skip them.
Use this task to update the contact data from an event sent via the API method Generate event, or to set a fixed value of the additional field in the workflow.
The task has 4 parameters:
- Contact ID: contact ID in the system. If you want to update a contact not by email but by ID in the system, specify the name of the variable that contains the contact ID. For example, ${contactId} or 123345.
- Email: required field. For example, ${emailAddress} or test@test.com. If your event has a different variable, specify it in the field. In the system events, the variable is called EmailAddress. System events are the events generated within the system (click on an email CTA, regular workflow launch, filled subscription form, reactivation with RFM analysis). For them, enter ${emailAddress} in the field.
- Phone: required field if you update a contact by phone number. For example, ${phoneNumber}. If you have a different name for the variable in the event, specify it in the field.
- JSON: field contains a line or a variable with a line in JSON format with contact data (phone number, name, surname, city, additional fields). Email address is specified by default; if needed, specify other additional data. The parameter confirmed is ignored.
Get Contact
The task is to get contact data and pass it to the message or to the Condition block. For example, you want to send a notification email with contact data every time a new subscriber is added to the database, or send the subscriber registration details after registration.
The task works as follows:
- The event that contains contact data is created (registered) in the system.
- The task extracts out all available contact data stored in the database.
- Block passes this data to the email.
The task has 4 parameters:
- Contact ID: contact ID in the system;
- Email: email address of the contact;
- Phone: phone number of the contact;
- Token: mobile token of the contact.
Email, Contact ID, Phone, and Token are used to identify a contact. One of these fields must be filled with relevant data.
For example, if you want to identify a contact not by email but by ID in the system, specify the name of the variable that contains the contact ID. By default, it's ${contactId}.
You can use these variables in the message:
- $!data.get('firstName') - name;
- $!data.get('lastName') - surname;
- $!data.get('email') - email address;
- $!data.get('sms') - phone number;
- $!data.get('contactKey') - contact key;
- $!data.get('id') - contact ID in the system;
- $!data.get('createdDate') - creation date;
- $!data.get('updatedDate') - date of the last contact update;
- $!data.get ('confirmed') - contact’s email address status (true - confirmed, false - not confirmed);
- $!data.get('fields').get('12345') - additional fields. Insert an ID of the additional field instead of 12345.
For Get contact task, you can activate the Search only contact ID checkbox to search contact only by contact ID.
Confirm Contact
The task is to confirm the email address of the subscriber, add them to the system and make available for receiving.
For example, a person fills in a subscription form, their email address gets to the system and they receive a confirmation email. They can not receive promotional campaigns until they confirm subscription. A successful confirmation link triggers the Confirm contact task and starts the corresponding workflow.
The task has Advanced parameters.
More about advanced workflow block parameters >
Important
When searching contacts for Create contact, Update contact, Get contact tasks, the following rules apply:
- Contact ID has the highest priority among all parameters
- If externaiCustomerId is specified, contact search will be performed by externaiCustomerId.
- If externaiCustomerId is not specified, contact search will be performed by email address or phone number.
Send Obligatory (transactional) Email
The task is to send an email to the contact regardless of their status in the system (confirmed, unconfirmed, unsubscribed, spam report) except for blacklisted contacts.
Important
Use this task only if absolutely necessary. It ignores the contact status which may result in spam reports and harm sender reputation.
Use the task only to send a transactional email (subscription confirmation, order confirmation, change in a pricing plan) to a new unconfirmed contact.
In all other cases, use the Email task from the Message or the Message to segment blocks.
The task has one basic parameter — Message. In this field, select a pre-created message that will be sent to the user. The task also has advanced parameters.
More about advanced workflow block parameters >
Send Transactional Viber Message
The task is to send a Viber message to the contact regardless of their status in the system.
The task has two basic parameters:
- Message
- TTL — Set the period after which the message will not be displayed if it has not been delivered to the contact by that time. By default, 1 day is set. The minimum value is 2 minutes, and the maximum is 28 days.
The task also has advanced parameters.
More about advanced workflow block parameters >
Send Transactional SMS Message
The task is to send an SMS message to the contact regardless of their status in the system.
The task has one basic parameter — Message, and contains advanced parameters.
More about advanced workflow block parameters >
Get Order
The Task block extracts the data from an order and passes it to the message. For example, order status – order confirmation, order delivery.
Use this task only if you send the order data to our platform using the Add orders API method.
To configure the Get order task block:
Click the Get order by dropdown list and select one of the following options:
- Order ID. Choose this option when you wish to get the order data by the ID generated by our system.
- External Order ID. Choose this option when you wish to get the order data using the order ID that you pass to our system.
You don’t have to fill in the Order ID/External order ID field. The task extracts automatically all the parameters from the order event.
The task works as follows:
- The system receives the order information.
- The task extracts all the data from the order and passes it to the email as variables.
Read more about the Task block in the Order automation article.
Create Promo Code
The task is to generate a promo code and pass it to a message that goes next in the chain. The algorithm encrypts the parameters by your key, and the reverse algorithm decrypts it when a promo code is entered on the website. Learn more.
The task has 4 parameters:
- Days: number of days until the promo code is expired. The system will add them to the current date, and the resulting expiration date will be encrypted into the promo code. The variable ${days} is specified by default.
- Type: promo code type. You can set up 32 promo code types. For example, assign type 0 to a subscription promo code, type 1 to a birthday code, type 3 to reactivation code, etc. Pass in the variable the number from 0 to 31 that corresponds to the right type. The variable ${type} is specified by default.
- Discount: size of the discount. Used to generate a promo code when a discount is given as a % off the order cost. It is always a double-digit number, so discounts of up to 10% should go with zero ahead. For example, specify 05 for an email with a 5% discount. The variable ${discount} is specified by default.
- Key: encryption key. You can leave the default value. The variable ${key} is specified by default.
Note
All parameter fields are required.
In a workflow, this block is followed by one of the Message blocks (Email, SMS, Viber, etc.).
For example, in the email template, you can put a variable $!data.get ('promocode') in the place intended for a promo code.
Get Promo Code
The task is to pass a promo code from the base to the email. More about uploaded promo codes.
The task has three required parameters:
- Days: number of days after the current date during which the promo code is valid;
- Type: promo code type;
- Discount: discount size from 01 to 99.
The system selects promo codes from the downloaded database based on the specified parameters.
Let's look at an example. Enter the following values in the parameters: days - 10, type - newyear, discount - 25.
The workflow will extract from the database a promo code with a 25% discount, identified by the type newyear and having a validity period of at least 10 days. If several promo codes meet the specified parameters, the system will automatically choose one of them.
After the Get Promo Code block, you place the block for sending messages (Email, SMS, Viber, etc.).
In the email template, put a variable $!data.get ('promocode') in the place intended for a promo code.
Launch Event
The task is to launch any event from the workflow. For example, one workflow can trigger the launch of another. To use the task, you need to previously create the event you plan to launch.
The task has 3 parameters:
- Event: required field. Select the type of the event to launch.
- Unique key: key of the event you’re launching, for example, a variable with an email address. If the field is not filled, the key from the event that triggered the current workflow will be used.
- Parameter: array of parameters we want to pass to a launched event. If the field is not filled, the parameters from the event that triggered the current workflow will be passed.
The format of the parameters:
[{"name":"paramName,"value":"parameter value"}]
Condition
The block is used to check whether certain workflow conditions are met or not. Depending on this, the workflow is further split into two paths - Yes or No - with separate downstream tasks.
The block has one Start block and two End blocks (for Yes/No paths).
The Condition block has 7 tasks:
- Check event
- Variable matches regular expression
- Contact confirmed
- Contact exists
- Check parameter by date/time value
- Verify contact field matches event parameter
- Check the checkbox list fields.
Check event is a default task. When needed, choose the necessary task from the drop-down menu.
Check Event
The task is to check whether a particular event occurred since the workflow was launched. Events are searched by keys.
The task has 3 parameters:
- Unique key: event key. For example, it can be an email address; thus, this field should contain a parameter with an email address. This is a parameter from the event that launched the current workflow. If it's emailAddress, enter ${emailAddress} in the field.
- Event: event type. This is a required field without which the workflow will not start.
- Period: you can set the time before the start of the workflow, during which the event must be checked. By default, the block checks for events since the activation of the workflow.
Variable Matches Regular Expression
The task is to check a certain variable from the event or the data received from other blocks.
For example, you can check if your recipient is a male or a female and send them different messages.
The task has 2 parameters:
- Name: variable name. It could be an event parameter. The parameter name is entered in this field without ${}. If you check the data obtained by other workflow blocks (for example, Get contact), specify the system variable smartMessageJson in the field.
- Pattern: regular value checked for compliance. For example, to check whether the event parameter address contains the word “London”, specify London in the Pattern parameter.
Contact Confirmed
The task is to check whether the contact's email has been confirmed.
For example, a person has subscribed to your newsletter, and you want to send a welcome email.
The task works as follows:
- The contact is added to the Yespo database but has an unconfirmed status.
- A confirmation email is sent to the contact.
- The task checks whether the subscription is confirmed.
- If it is confirmed, the Yes path is triggered, and a welcome email is sent.
- If it isn’t confirmed, the No path is triggered.
The task has 2 parameters:
- Email: contact’s email address;
- Contact ID: contact’s ID in the system.
By default, the system checks whether the contact is confirmed by email. Specify the name of the variable or the email address in the Email field. For example, ${emailAddress} or test@test.com.
If you want to use a contact ID for confirmation, specify ${ContactId} in the Contact ID field.
One of the parameters must be specified.
Contact Exists
The task is to check whether the contact exists. It works similarly to Contact confirmed.
The task has 3 parameters:
- Email;
- Phone;
- Contact ID.
By default, the system uses an email address. If you want to use a contact ID, specify ${contactId} in the Contact ID field. To identify a contact by phone number, specify ${phoneNumber} in the Phone field.
Check Parameter by Date/Time
The purpose of the task is to check the date from the event parameter.
When creating a workflow, the user's time zone is taken into account. Time will be saved in UTC.
For example, The date and time being checked is 2020-07-30 13.00. The user's time zone is GMT +3 (Europe/Kyiv). The following value will be passed to the event: "2020-07-30T13:00 + 03:00".
The task contains 2 parameters:
- Parameter. It is required to state the parameter's value passed in the parameter. By default, this is a variable ${parameter}. The date is in ISO 8601 format.
- Date. Select an option from the list for a single date, time or the date/time range.
Parameter
The Parameter field accepts the parameter name in the system.
Enter the parameter name as a variable or a string. The format example: ${userId} or 123abc.
Selecting the Date and/or Time Settings
To select the date and/or time settings:
- Click the down arrow and select one of the options from the list:
- Date
- Date with time
- Date range
- Time range
- Date/time range
- Date before
- Date after
- Date and time is greater that current by
- Configure the required date and time settings for the selected parameter as explained below.
Configuring the Date settings
When you select the Date parameter, the Condition block checks if the event date matches the selected date for this parameter.
To select the Date settings:
- Click the calendar icon and select the required date.
Top Tip
Click the left or right-pointing arrows to change the month, or click the section of the calendar to switch to the month or year selection.
Configuring the Date with time settings
When you select the Date with the time parameter, the Condition block checks if the event date matches the selected date and time for this parameter.
To select the Date with time settings:
- Click the calendar icon and select the required date in the date selection window.
- In the hour selection window, select the required hour.
Configuring the Date range settings
When you select the Date range parameter, the Condition block checks if the event date matches the selected date range for this parameter.
To select the Date range settings:
- Click the date beside the left field and select the initial date of the range.
- Click the date beside the right field and select the final date of the range.
Configuring the Time range settings
When you select the Time range parameter, the Condition block checks if the event time range matches the selected time range for this parameter.
To select the Time range settings:
- Click the time beside the left field and select the initial time from the time selection window.
- Click the time beside the right time field and select the end time from the time selection window.
Configuring the Date/time range settings
When you select the Date/time range parameter, the Condition block checks if the event date and time range match the selected date and time range for this parameter.
To select the Date/time range settings:
- Click the left date and select the required initial date in the date selection window.
- In the hour selection window, select the required hour.
- In the minute selection window, select the precise time. The time values in this window are within the range of 1 hour with an increment of 5 minutes.
- Click the right date and select the final date, hour and minutes, the same as for the initial ones.
Configuring the Date before settings
When you select the Date before parameter, the Condition block checks if the event date received as a parameter is within the date range before the selected date.
To select the Date before settings:
- Click the calendar icon beside the date field and select a date.
Configuring the Date after settings
When you select the Date after the parameter, the Condition block checks if the event date received as a parameter is within the date range after the selected date.
To select the Date after settings:
- Click the calendar icon beside the date field and select a date.
Note
The selected date for the Date before and Date after parameters is not included in the period.
Configuring the Date and time is greater than current by settings
When you select the Date and time is greater than current by option, the Condition block checks if the event date and time received as a parameter are greater than the current date and time by N minutes/hours/days.
Example:
The date and time of your webinar is 2022-10-10, 16:00.
You have configured to send 3 messages to the registered persons: 30, 10 and 5 minutes before the webinar start.
The person’s registration date and time is 2022-10-10, 15:52 (the current date and time).
The Condition block compares the current time and the time from the event parameter. As the result of the comparison:
- Sending the first message is cancelled because the condition for sending the message (30 minutes before the event) is false.
- Sending the second message is cancelled because the condition for sending the message (10 minutes before the event) is false.
- The third message will be sent as scheduled because the condition for sending the message (5 minutes before the event) is true.
To configure the Date and time is greater than current by option:
- Enter the required value in the field and select its format from the dropdown list: minutes, hours or days.
Verify Contact Field Matches Event Parameter
The task allows checking if the contact field matches the passed value in the event parameter.
For example, you want to check if the subscriber's city matches the city value passed in the event. If that is not true, you can place the contact update block downstream.
The task contains two basic parameters described in the table below.
Parameter | Description |
---|---|
Contact field | The field from the contact information that has to be verified. Click the down arrow to select a field from the dropdown list or enter the field’s name in the box. You can compare the following field types: - Text box - Text area - Number - Fractional number - Dropdown list |
Parameter | The event parameter. The task checks if the contact’s field matches this parameter. You can enter the value as a variable in the format of ${parameterName} (the parameter’s name in an event, for example, ${city}), and in this case the contact’s field is compared with the value of the parameter in the event. Using the 123abc format is acceptable (for example, Kyiv), in this case the contact’s field is compared with the specific value in the parameter (Contact's field 123abc?). Select case sensitive if this operation is case-sensitive. |
The task also has advanced parameters.
More about advanced workflow block parameters >
Check the Checkbox List Fields
The purpose of the task is to check for empty or specific checkboxes in the contact card.
The list of checkboxes displays checkboxes created in the Additional fields section.
The following checking options are available:
- Check for empty checkbox fields options
- Check for specific checkbox field options
- Check for the presence of one of the specific checkbox field options
Check Point
If you have a complex workflow with paths, you can add this block at any point and then check in the workflow launch history if it followed a specific path. A Check point can also bridge multiple paths. Not all blocks allow connection to several paths, but this block solves that task.
The block has one parameter: Name.