Login

Omnichannel

Security and Compliance

Validating Event parameters

Events that are sent to Yespo must meet specific requirements. Otherwise, the workflows may not work, you may lose important data, etc. 

The Yespo system allows you to validate events and provide immediate feedback if event parameters contain errors. Also, the system checks that event includes the required parameters.

Setting Required Event Parameters

Set required event parameters so the system accepts an event only if it meets the specified structure.

Steps to set up event’s structure validation:

1. Create a new event or edit an existing one (See Events to learn more about how to create events in Yespo).

2. Enable the Validate parameters slide button.

3. Click + Add parameter.

Add parameters

4. Enter the parameter name in the corresponding field and select the Required parameter checkbox if the parameter is required.

5. Add other parameters as necessary, then click Edit.

Required parameters

Validating Event Parameters

Validate event parameters and structure using Generate event API method. Indicate parameters in the params array.

Generate event

If parameters do not meet the specified structure, you will get the 400 bad request error and the required event structure in the response.

Response example:

The event should have the following params: [
    {
        "name": "EmailAddress",
        "required": true
    },
    {
        "name": "Phone Number",
        "required": false
    },
    {
        "name": "Name",
        "required": false
    }
]

Event types with enabled parameter validation are marked with a check icon.

Event types with enabled parameter validation

Event requirements

eventTypeKey

Type

Required/Optional

Description Requirements
String Required

Event type ID key. If no such event type exists with such a key, a new one is created.

1. All characters are allowed except < ; ’ \ / | " ` ' ^ ? ! , >

 

2. Max. length: 100 characters.

keyValue

Type

Required/Optional

Description Requirements
String Optional The key of the event, which determines its uniqueness. If you don't pass a keyValue in the event, it is automatically taken from the request's Params object with such a priority:
  • contactId;
  • externalCustomerId;
  • email;
  • phone;
  • pushToken (web or mobile).

 

An event without one of these parameters or a passed keyValue value is not accepted.

1. The key must contain a unique value for each contact (for example, email, phone number, external contact id, etc.).

 

2. All characters are allowed except < ; ’ \ / | " ` ' ^ ? ! , >

 

3. Max. length: 300 characters.

params

Type

Required/Optional

Description Requirements

Array of objects

Optional

List of event parameters represented as an array of "key" - "value" pairs. The parameter keys are arbitrary.

Used in campaigns and for creating dynamic content in messages.
 

1. Params array may be empty: []
But if the array is not empty, both name and value fields must be in the array object.

 

2. The value of the name parameter must be unique.


3. Max. length of the name parameter’s value: 100 characters.

See API documentation for more information.

Any Questions?
We’re always happy to help!
Discount services
Schedule a Call
Fill in the form, and our specialists will call you back as soon as possible.
Discount services
Chat Support
We’re waiting for your questions!
Discount services
Email
Contact the support team