Steps to Configure VXML Connect Node

Field name

Description

Name

Enter a descriptive name for the VXML connection. This name helps identify the node within the IVR flow.

Example: CustomerAuthenticationVXML

VXML URL

Provide the endpoint URL of the VXML server that will process the interaction. Ensure that the URL is accessible from your IVR system.

Example: https://vxmlserver.example.com/authenticate

Input: This section defines the variables and values sent from the IVR flow to the VXML server.

VXML input variable

Specify the name of the input variable expected by the VXML server.

Example: accountNumber

Value to be sent

Enter the value that should be passed for the defined input variable. You can map this to an IVR parameter, session variable, or static value.

Example: ${callerAccountNumber}

+ Add more

You can configure multiple input variable–value pairs if the VXML server expects more than one parameter by using the Add more button.

Output: This section defines how responses from the VXML server are mapped back into the IVR flow.

VXML output variable name

Enter the variable name returned by the VXML server.

Example: authStatus

Variable to store output

Specify the IVR variable that should store the value of the VXML output variable. You can reuse this stored output later in the flow for conditions, branching, or agent handover.

Example: ${authenticationResult}

+ Add more

You can configure multiple input variable–value pairs if the VXML server returns more than one parameter by using the Add more button.

VXML handover settings (checkbox)

Select this option if you want the IVR to hand over control to the VXML server entirely during execution. This is useful when the VXML server manages the dialogue flow directly (for example, handling prompts, grammars, or multi-turn conversations).

• Checked: The VXML server controls the interaction.

• Unchecked: The IVR flow remains in control, using the VXML server only for input-output exchange.

VXML timeout

Define the maximum wait time (in seconds) to establish a connection with the VXML server. If the connection is not established or the server does not respond within the configured timeout (t seconds), the IVR will treat it as a timeout error and proceed with fallback logic.
Example: 10