Settle a problem:66
This document provides a comprehensive technical solution for designing and implementing an outbound script in Cisco Unified Contact Center Express (UCCX). The specific use case addresses a common requirement for agentless (IVR) outbound campaigns: playing a pre-recorded audio prompt to a called party and subsequently transferring the call to a designated internal or external Directory Number (DN). This analysis details the initial problem, evaluates the common pitfalls in script logic, and presents a robust, best-practice solution with necessary verification steps.
The core technical challenge involves an outbound script initiated by the UCCX system that fails to complete a call transfer after successfully playing an audio prompt. The intended script logic is as follows:
The failure typically occurs at the transfer stage, where the call is disconnected instead of being rerouted, indicating an issue with the transfer method chosen within the script’s logic or an underlying routing misconfiguration.
The initial approach to building this script correctly includes foundational steps that are often implemented without issue.
Start
step.Accept
step is used to establish script control over the call leg connected to the customer.Play Prompt
step is utilized to deliver the audio message to the accepted call.While these initial steps are correct, this approach is incomplete. The critical flaw lies in the subsequent transfer mechanism. Using a generic step like Redirect
can be unreliable in this context. The Redirect
step instructs the Cisco Unified Communications Manager (CUCM) to redirect the call, but it relinquishes script control. For outbound calls managed by the UCCX engine, this can lead to unpredictable behavior or outright failure, as the call legs are not handled in a way that guarantees a successful transfer. A more explicit and controlled method is required.
To ensure a reliable and robust prompt-and-transfer outbound script, the following design, incorporating the Place Call
step and essential verification checks, is the recommended engineering best practice.
Start
trigger.Accept
step with the default contact (--Triggering Contact--
) to take control of the call.Play Prompt
step to play the desired audio file to the customer.Delay
step (e.g., 1-2 seconds) after the Play Prompt
step. This ensures the prompt playback fully completes before the transfer logic is initiated, preventing any audio cutoff.Redirect
, use the Place Call
step. This step instructs UCCX to initiate a new call from one of its CTI ports to the destination number and then bridges the new call leg with the existing customer call leg.
Place Call
step properties, set the Destination field to a string variable containing the target DN (e.g., "12345"
).--Triggering Contact--
.Successful
and Unsuccessful
.End
step to terminate the script gracefully.Place Call
step fails (e.g., the destination is busy, invalid, or unreachable), the script should handle the failure. This could involve logging an error, retrying the call placement, or simply proceeding to an End
step. This prevents the script from getting stuck.End
step.A script failure is often caused by misconfiguration in the underlying telephony platform. Before deploying the script, verify the following in CUCM:
Place Call
step will fail. This is the most common point of failure outside the script itself.The key to successfully implementing a UCCX outbound prompt-and-transfer script lies in using the appropriate scripting step for call control. The Place Call
step provides a deterministic and reliable method for transferring an outbound call after a prompt, offering superior control and error handling compared to other methods. By combining this robust script logic with a thorough verification of the underlying CUCM calling permissions and route plan, administrators can ensure consistent and successful execution of their agentless outbound campaigns.