Contents

IS_Action_Stage

Definition

This action is used to set stages within a predictive campaign script. It moves a call to a new stage. Staging is normally only used in predictive campaigns, it does not apply to power or preview campaigns. The staging values correlate with the values set in the staging container in Interaction Administrator that is assigned to the active campaign. A campaign call can be segmented into various stages that an agent may traverse during a campaign call. While a campaign is active, Interaction Dialer monitors agent performance per stage and maintains values that allow Outbound Server to predict the probability of the agent finishing the call in that stage, as well as how long the agent is expected to be in that stage. For example, the following table depicts how a sample telemarketing campaign might be staged:

Id	Name	Probability	Adjusted Call Length
Stage 1	Introduction	67%	37 seconds
Stage 2	Preliminary Sales Pitch	75%	1 minute, 42 seconds
Stage 3	Detailed Product Description	80%	5 minutes, 48 seconds
Stage 4	Billing information	100%	2 minutes, 30 seconds

The Probability Value is the likelihood of the call ending in that stage for a particular agent. Each agent has a table of values (as in the example above) that corresponds to that agent's personal statistical summary while the agent is logged into a campaign. Therefore, if one agent takes longer in a particular stage than another agent, the algorithm adjusts accordingly.

Tip—the topic titled 'Stage Sets view' in Interaction Dialer Manager Help explains how to define stages.

Scripter will recognize click events from any HTML element whose name has an associated action documented in this API (e.g.: "IS_Action_CallComplete"). If the script needs to associate several buttons with the same action, then define the action using a meta element and call the click event on the meta element from the button(s).

Attributes

The IS_Action_Stage element has the following attribute:

stage

The call stage number to set. The call stage number can be any number in the range of 0-10,000. We recommend that you make stage numbers consecutive. (E.g. 1, 2, 3, 4, 5; not 1, 2, 5, 20, 45). This number should match the value of a stage from the Stages associated with the campaign. It cannot match the stage name, only the numeric value. If no matching stage value is found, Interaction Dialer will choose a stage name (e.g.: "Auto-Added Stage #), where # is the specified stage value.

[callback]

The callback property ensures that this action executes asynchronously in Interaction Connect. Starting with 2018 R3, all Interaction Scripter actions (IS_Actions) provide a callback property for use in Connect scripts only. In the example below, statements inside the highlighted callback function block execute only after the action completes. The callback will return an error if the action fails. See Writing custom scripts for Interaction Connect or Scripter .NET.

Here's how to use the .callback property in a script for Interaction Connect:

function IS_Action_Stage() {
  IS_Action_Stage.stage = "3";
  IS_Action_Stage.callback = function(error) {
    if (error) {
      console.error("IS_Action_Stage failed.");
    } else {
      console.log("IS_Action_Stage succeeded.");
    }
  }
}

Example 1

This is an example of a button that moves a call to the next stage (which, in this case, is Stage 1).

<body>
    <input type=button name="IS_Action_Stage" value="Stage 1" Stage="1">
</body>

Example 2

This is an example of a button that invokes the "Stage" script function. The "Stage" script function moves a call to the next stage (which, in this case, is Stage 3).

<head>
    <meta name="IS_Action_Stage">
    <script language=javascript>
        function Stage(stageNumber) {
            IS_Action_Stage.stage = stageNumber;
            IS_Action_Stage.click();
        }
    </script>
</head>

<body>
    <input type=button value="Stage 3" onclick='Stage("3")'>
</body>

Example 3

<head>
    <meta name="IS_Action_Stage">
    <script language="javascript">
        function IS_SetCurrentStage(p_page, p_stage) {
            IS_Action_Stage.stage = p_stage;
            IS_Action_Stage.click();
            if (p_page != null) location.href = p_page;
        }
    </script>
</head>

<body>
    <input type=button value=" Next Page" onclick="IS_SetCurrentStage (‘ClosingSale.htm', 4);">
</body>