Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel
titleOn this page:
Table of Contents

What is a Variable?

  A variable is a container that has a name and a value. XCALLY Motion has a list of standard variables that can be used to access information about Omni Channel Interactions (Voice Calls, Web Chat, Email and so on).

In addition to these, you are able to create your custom variables that can be used within the entire Motion system. For example, you can create a variable named order and use it in a Cally Square project to add logic to your IVR flow or customize the phonebar popup displayed for agents.

This section explains mainly how to create and use custom variables.

Warning

For more information about all the Asterisk Variables that can be used see here.


The Variables section

You can find the Variables section under Tools menu:

Image RemovedImage Added


Create a Variable

To create a variable, click on New Variable button 

Image RemovedImage Added

Enter variable Name and Description then click on Add Variable. After the variable is created, you can view it in the list of variables.


Edit or Delete a Variable

Find the variable from the variables list (you can use the search box on the top-right of the page to filter) and Click on Edit Variable. 
Edit Name or description and click on Save.

To delete a single variable, find the variable in the variables list and click Delete Variable:

Image RemovedImage Added

To delete multiple variables, select the list of variables by marking the checkbox on the left side, click on Delete button and click OK to confirm:

Image RemovedImage Added

Export list of Variables

To export list of variables in CSV, select the list of variables to export by marking the checkbox on the left side and click on the icon Export button:

Image RemovedImage Added

How to use Variables 

You can use Motion standard variables and custom variables in your Motion system according to your needs.

The following are some of the sections where variables can be used:

  • Triggers

    • to customize phonebar or web pop-up displayed for agents

    • to pass custom parameters to a web or windows application

    • to forward custom parameters in HTTP GET/POST request

  • Cally Square project:

    • to insert logic in the call flow

  • Routes Dialplan:

    • to insert logic in the call flow

  • Integrations

    • to pass custom information to 3rd party applications like Zendesk, Freshdesk...

  • Templates:

    • to customize the content with the values you need

  • Jscripty:

    • to customize contents in agent scripts

  • Email:

    • to customize the outbound email messages contents

Variable Syntax

The syntax you need to use to access the value of a variable slightly differs from section to section:

Triggers, Templates and Jscripty:

Panel
borderStylenone
nopaneltrue

{{VARIABLENAME}}

Cally Square projects:

Panel
borderStylenone
nopaneltrue

{VARIABLENAME}

OutboundInbound and Internal routes:

Panel
borderStylenone
nopaneltrue

${VARIABLENAME}

 Scenario:

Example of Motion Phonebar CTI URL action in Voice Triggers:

Example of a template:

Example of a Cally Square Project:

Example of OutboundInbound and Internal routes:

You must place the variable inside {{ }} to pass custom parameters in the URL query string.

You must place the variable inside {{ }} to display the content of the variable.

Note

Unless the value of a custom variable is set (e.g. within the dialplan or cally square application) it will have an empty value.

Set a Variable

You can set (assign) the value of a variable to a constant (string, number, etc.) or another variable (Asterisk variables or custom variables). In Cally Square, if you want to set a variable to another variable, you have to put the variable inside {}. 

In the following example, we are setting callernumber variable to an Asterisk variable CALLERID(num) in Cally Square Set application. After the variable is set, {ordernum} contains the caller number.

Image RemovedImage Added


The same operation can be performed in Inbound or Internal routes using the set application as follows: 

Image RemovedImage Added


Note that you have to specify the variable name in the variable field and the variable within ${ } in the Value field.