Available actions

Actions let you transform or filter a field’s data before sending it to the bot. They apply in the order they’re added, and are available on Bot Params, Product Params, and Extra Params fields.

Removal actions

Action	Description	Parameters
remove_empty	Discards the whole record if the field is empty.	—
remove_empty_and_spaces	Discards the record if the field is empty or contains only spaces.	—
remove_length_greater_than	Discards the record if the value’s length exceeds N characters.	`Value` (integer)
remove_length_less_than	Discards the record if the value’s length is less than N characters.	`Value` (integer)
allows_long_between	Discards the record if the value’s length is outside the defined range.	`Minimum length`, `Maximum length`

Replacement actions

Action	Description	Parameters
replace_empty	Replaces empty values with a fixed value.	`Replacement value`
replace_characters	Replaces a character or string with another.	`Character to replace`, `Replacement value`
replace_field_value	Replaces a specific value with another.	`Value to replace`, `Replacement value`

Column actions

Action	Description	Parameters
new_column	Assigns a fixed value to the field, without reading from any file column. Useful when the bot requires a parameter that doesn’t exist in the file.	`Value`
copy_column	Copies the value from another file column.	`Source column`, `Copy column name`

Format actions

Action	Description	Parameters
change_format	Converts the value’s data type.	`Target format`: `str`, `int`, `float`
convert_to_list	Converts the value into a list.	—

Date actions

All date actions work with a reference date and a day offset:

Reference date (init_date): can be today (the current date) or a fixed date in YYYY-MM-DD format.
Day offset (shift_days): number of days to add or subtract from the reference date. Can be negative. For example, shift_days = -1 with init_date = today is equivalent to “yesterday.”

Date filtering actions

Action	Discards the record if the field’s date is…
date_remove_greater_than	greater than the reference date
date_remove_greater_equal_than	greater than or equal to the reference date
date_remove_less_than	less than the reference date
date_remove_less_equal_than	less than or equal to the reference date
date_remove_equal_than	equal to the reference date
date_remove_different_than	different from the reference date

date_generate_from_relative_value

Generates a date from a numeric value (days) in the field. For example: if the field contains 30, it generates the date that is 30 days from the reference date.

Parameter	Description
New column name	Name for the column with the generated date.
Initial date (`init_date`)	Base date: `today` or a fixed date.
Day offset (`shift_days`)	Days to add or subtract from the base date.
Operation	`nothing`: doesn’t modify the original column. `add_col`: adds a new column with the generated date. `subst_col`: replaces the original column.

Home

Getting started

Best practices

Build your agent

Configure your bot

Campaign Input

Available actions

Removal actions

Replacement actions

Column actions

Format actions

Date actions

Date filtering actions

date_generate_from_relative_value

​Removal actions

​Replacement actions

​Column actions

​Format actions

​Date actions

​Date filtering actions

​date_generate_from_relative_value

Removal actions

Replacement actions

Column actions

Format actions

Date actions

Date filtering actions

date_generate_from_relative_value