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
- Messenger Protocol Support in Email Clients and Platforms
Omnichannel
- Setting Up Widgets for Your Site
- Widgets Gamification
- 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
Adding New Contacts
To add a new contact use data streaming in JSON format via Public API.
Use the Add Contact method to create the user's profile to an account or update an existing one.
Note
- This method doesn't generate events, so you won't use it to launch workflows.
- Using the specified methods, contacts with email addresses will be created as confirmed, as imported from a file. It doesn't allow configuring double opt-in.
- If you want to store some custom information about your users, create additional fields before uploading contacts.
- For adding/updating bulk of contacts use the Add Contacts method. This resource allows adding/updating up to 3000 contacts with one request.
JSON sample of request body
For this API method, you must pass channels; other fields are optional. Format and description of all fields are available here.
{
"firstName": "John",
"lastName": "Smith",
"channels": [
{
"type": "mobilepush",
"value": "8900-7654-6456-9876-0012",
"device": {
"appId": "83b77a49-fc28-409b-aeaa-68c9d544ab9d",
"deviceModel": "iPhone 13",
"os": "Android",
"locale": "uk-UA",
"clientVersion": "native",
"appVersion": "4.1.7",
"active": true
}
},
{
"type": "email",
"value": "john.contact@gmail.com"
}
],
"fields": [
{
"id": 12345,
"value": "writer"
},
{
"id": 12346,
"value": "1990-03-09"
}
]
}
Validation of Contacts' Names and Last Names
Yespo validates contact data received through the API according to the following rules:
First Name
The maximum field value length is 40 characters.
Letters of any alphabet (unicode) and up to 3 digits are allowed.
Special characters are prohibited, except:
-
apostrophes in the middle of a word
-
hyphens in the middle of a word or between words without spaces
-
a dot at the end of a short (up to 3 characters) word (for example, Jr.)
It is allowed to use 3 words of more than 3 characters and 3 words of a maximum of 3 characters. Names exclusively composed of numbers and/or special characters are prohibited.
Last Name
The validation rules of the Last name field are the same as for the First name, except that any number of words of any length are allowed (but not more than 40 characters in total).
