Adding or Editing Variables

  • Adding a new Variable: There are two ways of adding a Variables within script steps:
    • Clicking the + icon under any script step to open the Variable input window, type the Variable name. Once finished, Press Return to confirm.
    • Pressing Shift + + on your keyboard within a script step. After entering the Variable name press return.

Adding a Variable to a step

  • Editing Variables: Press the Variable you want to edit. In the Variable input window, Press the ‌··· button next to it. You will be given the option to modify the Variable name or delete it.

Editing a Variable on a step

  • The Variables Panel: When editing campaign scripts, the Variables Panel is accessible by clicking the hexagon icon, located in the top-right corner. The panel allows adding new Variables, and deleting them. This panel displays:
    • All Variables currently referenced in the script under “Variables in Use”.
    • Any defined but unused Variables under “Variables Not in Use”.

Variables panel

Working with Variables

  • Populating Variable values: Variable values need to be populated in the following ways:

    • When Uploading Contacts:
      • Via CSV: The file to upload must include column headers that match the Variable names used in your script. For example, if your script includes the variable company, the CSV should have a company column.
      • via API: When uploading contacts programmatically, include Variable values in the data object. Refer to API documentation and uploading contacts pages for more details.
    • Dynamically During a Call: Variables can be populated based on call content. For example, if a campaign includes a step asking “What is your name?” The Variable name will automatically be set from the transcribed user response.
  • Variables within Actions: Variables can be added on a campaign action steps in API endpoint URLs, as values in request headers and in request bodies.

Variables being used in an Action

  • Transcript Variables: When adding variables within Actions, an additional Transcript option is available. This allows you to dynamically populate a variable based on the content of the conversation and a descriptive instruction:
    • Text: captures freeform responses.
    • Number: captures a numeric input.
    • Boolean: captures yes/no or true/false responses.

Adding a transcript Variable on an Action

For more detailed instructions on making use of Actions on your campaigns, please refer to our Campaign Action Guide.