Data Router applet

The Data Router applet makes dynamic routing decisions. The applet compares a value held in a data source with a value that you specify in the applet, using the operator that you also specify in the applet. If the comparison is true, then the applet routes the call accordingly. If the comparison is not true, the applet routes the call elsewhere. You can use the Data Router applet to route calls based on information returned from Data Connectors earlier in the call plan, for example, route the call based on the value of a Salesforce field.

If you plan to route a call based on the value of a Salesforce field, the data type of this field cannot be Formula.
You can specify multiple rules; the call is routed to the applet of the first matching rule. To add rules, click Add or Copy. Clicking Copy adds a new rule with the same settings as the rule you are copying. We recommend that you specify a maximum of 50 rules. If you need more rules, you can chain multiple Data Router applets together — when you specify the 50th rule, select another Data Router applet in the If rule does not match, route to field.

After making any changes to the applet, you must click the corresponding Update button, or buttons, to save your changes. Changes in other sections are NOT saved when you click an Update button in another section, so update the modified field or fields before making changes in other sections.

Operators

The list of Operators depends on the selected data type. For example, numerical types will allow the Is greater than and Is less than operators, whereas string types will not.

Data Router Settings

FieldOptionsDescription
Data sourceList of available data sources

The Data source list typically contains the properties returned from all the Data Connectors in the current call plan and any available IVR Slots. For example, if the call plan has a Data Connector configured to fetch a Salesforce record, the list contains entries for all the Salesforce object fields.

You must configure the call plan such that the Data Connector applet appears earlier in the call plan than the Data Router applet—this ensures that the selected Data source is populated with data before the Data Router is executed.

Data typeList of available data typesThe Data type list contains the supported data types for rules. When the rule is executed, the selected data source value will be processed as the selected data type for comparisons. If the runtime data source value is invalid for the selected data type, then the rule will be ignored at runtime.
Operator

Equals

Call is routed to the selected applet if the value of the selected Data source matches the Comparison value.

For string data sources, the comparison is case insensitive.


Not equals

Call is routed to the selected applet if the value of the selected Data source does not match the Comparison value.

For string data sources, the comparison is case insensitive.


Contains

Call is routed to the selected applet if the value of the selected Data source contains the Comparison value. The comparison is case insensitive.

Contains is only available for string data sources.


Does not contain

Call is routed to the selected applet if the value of the selected Data source does not contain the Comparison value. The comparison is case insensitive.

Does not contain is only available for string data sources.


Is null

Call is routed to the selected applet if the value of the selected Data source is null.

Is null is only available for string data sources.


Is not null

Call is routed to the selected applet if the value of the selected Data source is not null.

Is not null is only available for string data sources.


Starts with

Call is routed to the selected applet if the value of the selected Data source starts with the Comparison value. The comparison is case insensitive.

Starts with is only available for string data sources.


Is greater than

Call is routed to the selected applet if the value of the selected Data source is greater than the Comparison value.

Is greater than is only available for numeric data sources.


Is greater than or equal to

Call is routed to the selected applet if the value of the selected Data source is greater than or equal to the Comparison value.

Is greater than or equal to is only available for numeric data sources.


Is less than

Call is routed to the selected applet if the value of the selected Data source is less than the Comparison value.

Is less than is only available for numeric data sources.


Is less than or equal to

Call is routed to the selected applet if the value of the selected Data source is less than or equal to the Comparison value.

Is less than or equal to is only available for numeric data sources.


Is or is before

Call is routed to the selected applet if the time portion of the value of the selected Data source is equal to or before the time portion in the Comparison value.

Is or is before is only available for time data sources.


Is or is after

Call is routed to the selected applet if the time portion of the value of the selected Data source is equal to or after the time portion in the Comparison value.

Is or is after is only available for time data sources.

Comparison typeFixed valueFixed value indicates that you must specify a literal value for the Comparison value.

IVR storage nameIVR storage name indicates that Comparison value is the value of the data held in an IVR Slot.
Comparison valueText or list of available IVR slots

If the Comparison type is configured to Fixed value, you must specify a literal value for the rule.

If the Comparison type is configured to IVR storage name, you must select the name of the IVR Slot containing the value.

Route to appletList of available appletsThe applet that the call is routed to if the rule matches.
If rule does not match, route toList of available appletsThe applet that the call is routed to if no rules match.


Support and documentation feedback

For general assistance, please contact Customer Support.

For help using this documentation, please send an email to docs_feedback@vonage.com. We're happy to hear from you. Your contribution helps everyone at Vonage! Please include the name of the page in your email.