Call settings and features

Call settings: Call details


The call settings page controls all global settings for your environment. Many features, like call recording have per-queue settings, but require that the feature is enabled globally on this settings page.

Use calls

Turn the Use Calls toggle to On to enable calls.

Turning the toggle to OFF will disable ALL CALLS.

A WARNING confirmation screen will appear. Click YES if you are sure you want to disable all calls.

Phone numbers

See Multiple outbound numbers for more information about managing your list of phone numbers.

Emergency calling (US only)

To enable this feature, contact your support team.

Call details



Call Recording

  • Use Call Recording

  • Record Callback Outbound Calls

    • Enable Call Recording Redaction for agents

    • Play Call Recording Messages

  • Record Agent Initiated Outbound Calls

    • Enable Call Recording Redaction for agents

    • Play Call Recording Message

      • Ask User Permission To Record

Recording Message Sequence: Select one of two options:

  • Play Ask Permission to Record message before Call Recording message

  • Play Call Recording message before Ask Permission to Record message

Leave Ongoing Calls with 3rd Parties

Select this option to enable agents to leave a call with a 3rd party without disconnecting the call.


  • This option must be enabled if over capacity or Automatic redirection is to be followed for call transfers.

  • If call recording is enabled, the recording will continue for the duration of the call with the 3rd party; however, once the agent leaves the call, the remainder of the call between the consumer and the 3rd party is redacted.

Scheduled Call Countdown

Specify the minutes that an agent will be pulled out of the queue and assigned to a scheduled call before it takes place. See Scheduled Calls.

Scheduled Call Expiration

Expires a scheduled call if the assigned agent does not take the call. See Scheduled Calls.

Unanswered Call Expiration

Call is ended (fail reason "Failed (Expired)") when an inbound call remains unanswered in queue for a set duration from 30 to 1440 minutes.

Note: This setting is used for incoming calls and overcapacity callback calls.

Unanswered Transferred Call Expiration

Expires all unanswered transferred calls and unanswered deflected callbacks in queues when the wait duration in the queue reaches the time configured. The timer starts when the call is transferred to the destination queue.

Hold Time Counter

Select the option to show the hold time counter on adapter while the call is on hold to the agent. Currently, hold time is not carried over for transferred calls.

No IVR selection from Customer

If a customer reaches your queue and does not select any options, you can choose the path they are directed to. Set the number of times the IVR menu will repeat, then the action after the menu is repeated.

  • Select the 1st available menu: Of the options given to the caller, this option automatically places them in the first menu option available to them.

  • Direct to voicemail: The customer will be redirected to voicemail.

  • End call: The caller will be disconnected.

IVR - End User Dial '0' Behavior

Choose routing when 0 is dialed:

  • Dialing '0' moves user back up one level in IVR: If there are multiple menu levels, the caller will be routed to the queue one level back.

  • Dialing '0' transfers user to another queue: The caller will be transferred to the queue selected in the search field. Setting can be done globally per-language by using the language drop-down.

  • Dialing '0' results in no action by the IVR: The IVR will not respond when a caller presses 0.

Enable queue level Dial '0' override behavior: When enabled, dial '0' behavior can be set per-queue, from Settings > Queue.

Custom Callback Number Option

When the callback option is enabled in Call settings: Overcapacity deflection & caller announcements, the caller may want to be called back on another number than the one they have dialed in from, or may not have a caller ID. Enabled this feature to allow the caller to enter their preferred phone number to receive the callback call.

After applying any changes to this section, click Save Call Details.

Call settings: Phone numbers overview


Each call center can have many phone numbers for inbound and outbound calls. We will guide you through adding and configuring the phone numbers which are provisioned for your contact center.

Inbound default and specific routing options

Default IVR phone number behavior

If CCAI Platform has configured a number for your contact center environment the number will default routing to the top of the queues. If you have multiple languages, numbers will default to the language selection message.

Specific IVR inbound routing

If you have a line that is specific to a particular customer type or marketing promotion, Direct Access Points can be used to direct phone calls to that specific point in the queue. Direct Access Points can also be used for languages so that one number can be published for Spanish and that phone number will direct specifically to the top of the Spanish queue.

Outbound default and specific assignment options

Default outbound caller ID

By default, your contact center has one outbound number, which can be configured following the instructions below.

Outbound caller ID configuration options

When operating different brands or locations from your CCAI Platform environment, use Multiple Outbound Numbers so that agent outbound calls show the appropriate outbound number when calls are placed. There are two places for an Admin to make these configurations:

  1. Setting up phone numbers to the Phone Number settings.

  2. Configuring outbound numbers for each queue in the Queue Settings.

Full details about entering and assigning multiple phone numbers can be found at Multiple Outbound Numbers. Agents will have options for specific outbound numbers based on their queue assignments, or can be configured to not have options at all and will always dial outbound from the phone number which is set by the admin.

Requesting new phone numbers

Please contact Support and include the following information about your preferences:

  1. Number type: Toll-free, National, Mobile, Local

  2. Location of number

  3. Number preference details about number structure or patterns

Call routing with Auto Answer


Auto Answer connects calls to agents without agents clicking to manually pick up.

Auto Answer applies to inbound calls and transfers.

A whisper message can announce the call type and queue the call is coming from, and a call countdown can be enabled to alert the agent before the call connects.

Routing details

Call is routed via Deltacast to the longest idle agent in the first group.

If there is no agent available within the admin-defined number of seconds of the Deltacast pickup threshold duration, it will then append the second group, and so on.

If the agent receiving the Auto Answer call is not able to take the call due to network issues, they are considered Skipped and the call will be routed via Deltacast to the next agent.

Admin configuration

Auto Answer can be enabled at the menu level, or at a global level. If it is off globally, individual menus can't use the feature.

Dependencies: Deltacast must be enabled.

To prevent agents from getting Auto Answer calls before they're ready, Admins can preset a default status for agents who have just logged in. See Set the default agent status.

Enable Auto Answer globally

  1. Go to Settings > Call.

  2. Set Auto Answer to On.

Enable Auto Answer per-queue

New queues: new queues added after Auto Answer is initially enabled will default to ON.

Existing queues: when initially enabled, existing queues will be set to off by default. To enable Auto Answer on existing queues, continue with the steps below.

  1. Go to Settings > Queue.

  2. Select the queue you would like to have Auto Answer enabled and select Auto Answer ON from the settings on the right panel.

  3. For all other queues, repeat these steps to either disable or enable Auto Answer.

Set the default Agent Status

To prevent agents from getting Auto Answer calls before they're ready, admins can preset a default status for agents who have just logged in.

  1. Go to Settings > Operation Management > Agent Status.

  2. Select from either using the last status before logout, or set a default status:

Caller messages and announcement settings

When Auto Answer is enabled, call whisper and/or call countdown should be enabled to alert the agent of the connecting call. See Agent Call Messages & Notifications for settings details and recommendations.

Agent experience

When the call is assigned and is about three seconds from being connected:

  1. A browser notification shows Call Auto Answered and the call type and queue name of the call. When clicked, the notification brings the agent to the appropriate screen and the call is auto-answered if the agent is on the screen with the call adapter or not.

  2. If the notification is clicked, a tab will load with the agent widget and the ticket loaded in the background.

  3. Optional: Agent will hear an audio message with the call information "{Call Type} from {Queue Name} starting in 3, 2, 1..."

Using Auto Answer with additional features and settings

Deltacast: Auto Answers for agent receiving Deltacast

Deltacast for Cascade / % Allocation: Auto Answers for assigned agent according to routing logic.

Multicast: Auto Answer cannot be used for Multicast calls

Transferred Calls: If call is transferred to a queue, it will follow the queue's Auto Answer settings. If call goes to an Auto Answer queue the call is Auto Answered for agent. If call goes to a non-Auto Answer queue the call is manually answered

Scheduled Calls (Mobile and Web): When the call is Auto Answered, and whisper is enabled, an audio message will announce that the call is a scheduled call.

Calls with User Segmentation applied: When the call is Auto Answered, and whisper is enabled, an audio message will announce that the call is a high-priority user segment call

Monitoring and Reporting


Auto Answer can be monitored on the Call Monitoring page where Admins and Managers see in real-time which calls are:

  • Auto Answered

  • Manually picked up


Auto Answer can be reported by downloading the following reports showing which calls were Auto Answered and which calls were manually picked up:

  • Agent Performance Report

  • Agent Timeline Report

  • Agent Summary Report

  • Individual Call History

Due to the call whisper and call countdown, the minimum wait duration for Auto Answered calls will be 12 seconds unless the whisper read-out speed is reduced.


Auto Answer can be accessed by our API to retrieve information on:

  • Answer type from the /calls endpoint

Pre-session SMS Deflection


Pre-session SMS Deflection allows for more effective channel use and a speedier support experience for callers. Pre-session SMS Deflection enables you to offer SMS chat support as an alternative option for IVR callers before the call is connected to an agent. This feature is configured at the IVR queue level and can be offered to callers conditionally based on the estimated wait times.

Callers who opt-in for the SMS deflection will respond to an incoming SMS to continue their support session over an established SMS. Once the SMS is successfully delivered, the call will be terminated automatically.

In order to enable the Pre-session Deflection, you must have the following:

  • A valid CCAI Platform account with Admin role assigned

  • A valid Legacy, Pro, Enterprise, or Digital License Package

  • A valid subscription for CCAI Platform IVR Support with IVR enabled

  • A valid subscription for CCAI Platform SMS Support enabled with a valid queue structure

  • The SMS must be functional (agent assigned)

Basic configuration

Enable and complete the steps below in order for the four settings:

Enable pre-session SMS deflection

  1. Go Settings > Call.

  2. Scroll down to the Pre-session SMS Deflection section and switch the toggle switch to ON.

Enable and save the pre-session SMS deflection offer and opted-in messages

  1. Go to Settings > Languages & Messages.

  2. Scroll down to Audible Messages > Pre-session SMS Deflection.

  3. In the Pre-session SMS Deflection Offer Announcement message box, enter or upload the global audio message that will announce the availability of the SMS Deflection as an option for IVR callers.

Message Example: Thank you for calling us. Your estimated wait time is @{ESTIMATED_WAIT_TIME_IN_MINUTES}. An agent will be happy to help you over SMS. To continue this help session over SMS message, press 1. To speak to an agent, press 2.

  1. In the Pre-session SMS Deflection Opted-in Announcement message box, enter or upload the global audio message that will acknowledge the consumer's choice to opt for the SMS Deflection as an alternative to the current IVR call.

Message Example: You've chosen to continue this session over SMS. An SMS message with the next steps is sent to the phone number you are presently calling from. Please stay on the line and when the session is successfully converted to SMS, this call will be automatically terminated.

2. Click Apply to save the messages.

Enable and save the rre-session SMS deflection greeting message
  1. Go to Settings > Languages & Messages.

  2. Scroll down to the SMS Messages > Pre-session SMS Deflection.

  3. In the Pre-session SMS Deflection Greeting message box, enter the global SMS message that will be sent to the consumer after they have opted for the SMS deflection.

Message example: Hi @{END_USER},

Thank you for opting to continue your help session over SMS. A representative will be joining this conversation shortly. Meanwhile, please let us know how can we help you today

4. Click Apply at the bottom of the SMS Messages section to save the message.

Configure pre-session SMS deflection for a specific queue
  1. Go to Queue Settings > IVR.

  2. Click on the leaf-queue you want to configure. For this step, you must use a leaf-queue (the lowest level queue)so that Pre-session SMS Deflection is available as a settings option on the right-side panel.

  3. On the Queue Settings side panel, scroll down to the Pre-session SMS Deflection section.

  4. Click the Expand button to view the Pre-session SMS deflection section. The Pre-session SMS Deflection section is displayed.

  5. Click the Configure SMS Queue Settings link.

  6. In the SMS Queue selection field, search and select the destination SMS queue where the consumers will be deflected when they opt-in for SMS deflection.

  7. Click Save to save the SMS queue selection.

  8. Click the Back to Settings link. The Pre-session SMS deflection section is displayed with the updated SMS queue selection.

  9. Switch the Enable session deflections to SMS channel toggle to ON.

  10. Click the Set Pre-session SMS Deflection button. The Pre-session SMS Deflection feature is now enabled for the specific IVR queue.

Optional configurations

Scenario 1: Trigger the pre-session SMS deflection only when the estimated wait time is over a certain time limit for a specific IVR queue.

  1. Navigate to the Pre-session SMS Deflection configuration page of the desired IVR queue where you want to set up the Estimated Wait Time limit.

  2. Under the Conditional Settings section, select the desired Estimated Wait Time limit over which the Pre-session SMS Deflection must be triggered.

  3. Select the Enable Pre-session SMS Deflection checkbox.

  4. Click Save.

The Pre-session SMS deflection will now be triggered in the specific IVR queue only when the queue estimated wait time exceeds the set threshold when enabled.

Scenario 2: Announce custom, queue-specific \ audible messages.

  1. Navigate to the Pre-session SMS Deflection configuration page for the IVR queue where you want to set up custom audible messages.

  2. Scroll down to Messages and Announcements > Audible Messages.

  3. Select the checkbox of the audible message that you want to customize for the specific IVR queue. The message configurations are displayed.

  4. In the message configurations, enter or upload the audio message that will be announced to the IVR callers for that specific queue.

  5. Click Save. The Pre-session SMS Deflection feature will now announce queue-specific custom audible messages for the specific IVR queue when enabled.

Scenario 3: Announce custom, queue-specific pre-session SMS deflection SMS message when a caller opts in for SMS deflection.

  1. Navigate to the Pre-session SMS deflection configuration page of the desired IVR queue where you want to set up the custom SMS message.

  2. Scroll down to the Messages and Announcements > SMS Messages.

  3. Select the checkbox for Customize Pre-session SMS Deflection greeting message

  4. In the message configurations, enter the SMS message that will be triggered for consumers of that specific IVR queue when they opt-in to using SMS messages instead of IVR support.

  5. Click Save.

Flexible inbound call handling


The flexible inbound call handling feature gives Agents the flexibility to manage inbound call sessions using the Agent Adapter. Agents can select the CRM account and CRM record the session should be associated with during the call or during wrap-up.

Feature details

Account/Record selection

CCAI Platform temporarily stores all events/info/data that happen during the call until an Account/Record is assigned either by an Agent or by the system. The system automatically makes a selection following the standard rules for Account/Record choice if the Agent doesn't assign a selection. Then, once the Account/Record is assigned (either automatically or by an Agent), the data is pushed to the selected CRM record.

More details:

  • Users can map specific fields of matching results to display in the Agent Adapter UI.

  • The agent's selection of account/record is preserved in the drop-downs when moving from call screen to wrap-up screen. If the Agent has not assigned an account/record but has made the selection in the drop-downs, that selection will be assigned once the call or wrap-up ends (based on the configuration).

  • The system will always create a new account and record for Anonymous calls (hidden Caller ID).

  • When a call is escalated from Voice Virtual Agent to a Human Agent, the UI is presented to the Human Agent.

  • This feature is NOT available when an agent listens to a voicemail


When a call is transferred from Agent 1 to Agent 2, Agent 2 can select the account/record unless Agent 1 has already made the selection. In this case, Agent 2 will see but not edit the assignments made.

Recovery Calls

If an Agent assigns an account/record and then uses the Hang up and Callback option, the Adapter will show the previous account/record selection.

Mobile and Web SDK calls

If the caller's phone number is not available, but User email or User ID is passed via SDK, then the record drop-down is available.

Available session types

This flexible inbound call handling UI will show when the call session is one of the following types: Voice Inbound (IVR), Voice Callback (Web), Voice Scheduled (Web), Voice Inbound (Mobile), Voice Inbound (IVR via Mobile), Voice Scheduled (Mobile), & Voice Inbound (API).

CRM integration behavior

Since this feature allows agents to select the record or account for the sessions to be associated with during the call and during wrap-up, the CRM integration behavior is impacted.

When data is sent:

  • The CRM record creation will be delayed until the Account/Record assignment is made by the Agent or by the system

  • Once the assignment is made, CCAI Platform will push any data to the record in the CRM

Agent UI

CCAI Platform uses the caller's phone number or UID to lookup the matching Account and Record, presenting the Agent with any matching options.

Account drop-down

Default selection and options

If there are one or more matching accounts, the account drop-down will be preloaded with the most recently created account.

  • The agent can also select another account OR Create a new account option if enabled

  • If there are no matching accounts, Create a new account is the only option. This cannot be disabled.

Record drop-down

Salesforce-specific configuration options that impact available options

If Attach CCAI Platform Sessions directly to the account lookup object option is enabled in Settings > Developer, then the record drop-down is hidden.

If the Leads lookup object is selected, then the record drop-down is hidden.

Default selection and available options

If Append call or chat session to the latest open case in the same leaf queue option in Case Creation Details is enabled, the latest open record in the same leaf queue is preloaded.

When Also append to closed records in the same leaf queue, when closed with the last _ days is enabled, the latest record in the same leaf queue is preloaded.

The agent can also select Create a new record OR the agent can select another record.

If there are no open records for the selected account, the record drop-down is prepopulated with the Create a new record option. This cannot be disabled.

If Append call or chat session to the latest open case in the same leaf queue option in Case Creation Details is disenabled, the default selection is New Record.

Assign button

The Agent must apply the account/record selection by clicking the Assign button.

Until Assigned is clicked, the Agent can freely select different accounts and records.

Once clicked, CCAI Platform associates the account/record with the session and starts pushing data to the record. This assignment can not be changed in the Agent Adapter, but can likely be changed manually in the CRM depending on your CRM settings.

CCAI Platform Portal configuration

  1. Go to Settings > OperationManagement.

  2. Scroll to the Inbound call section and mark the checkbox next to Prompt agents to select account and record (when applicable) to enable this feature.

  3. Click Allow agent to select "Create a new account" option even when matching accounts are detected if this option suits your organization's needs. The "Create a new account" option is always available if there are no matching accounts.

  4. Mark the checkbox to allow Agent to have access to Not Create a Record.

Recommendation: Restricted access to this option as CCAI Platform is unable to retroactively retrieve information lost if a record is not created in your CRM (due to an agent selecting this option resulting in the agent not creating a record).

5. For the Automatically select account and record option, select if you want the system to automatically assign the account/record when the call ends, or after the call wrap-up ends.

If auto wrap-up for calls is disabled, "when call ends" is the only available option.

Agent experience

The Agent's available options rely heavily on the CCAI Platform portal configuration as well as which records and accounts match the incoming call session. Review the Feature Details and Agent UI sections for variables.

  1. When a call comes in, the agent will be presented with options to:

    look up and select from matching account(s) to create a new account

    select an existing matching record(s), or create a new record.

  2. Once selections are made, click Assign.

If disposition codes and/or notes are also enabled, the agent will see the flexible inbound screen first, then the Disposition & Note selection UI.

Custom UID Support for IVR


By default, CCAI Platform uses the ANI (incoming phone number) to look up the contact object in your CRM. Once there's a match, CCAI Platform then displays an existing CRM ticket or opens a new ticket based on your environment settings. In the case that you don't have phone numbers stored in your CRM, or prefer to use a Unique ID (UID) for this contact lookup instead, CCAI Platform can deliver the same seamless experience.

Example use cases:

  • Phone numbers are not stored in your CRM

  • Your system's UID is more accurate than the incoming phone number within your specific system configuration

Steps to configure

  1. Contact Support to start the setup process and provide API details.

  2. Support will work with you to configure this experience and test the configuration is returning the correct UID.

Call Settings: Overcapacity deflection & caller announcements


When there are no agents available and wait times are high, Admins can configure various experiences for consumers.

The Call Settings page enables the following settings, and the Languages and Messages page offers the configuration for voice recordings or text-to-speech prompts that are required after certain settings are enabled. Be sure to add the appropriate messages once announcements or deflections are enabled.

After hour deflection

When After Hour deflection is enabled, calls will be deflected based on the specific operation hours for the queue or language the caller has selected or has been routed to. There are multiple options you can offer callers once this setting is enabled.

Overcapacity deflection

Overcapacity deflection threshold will be reached when a call is placed in queue and is not answered within the set amount of time ("Deflect calls in a particular queue if wait time in the queue is > [set duration]") AND when the estimated wait time is greater than the set amount of time, the caller will be offered from the selected deflection options.

Caller messages: the Overcapacity message will play, then the Overcapacity Options message plays one time. If nothing is selected, "keep waiting" will be auto-selected, If the Keep Waiting option is selected, the options will repeat at the set interval.

Estimated Wait Time (EWT)

For more information about how CCAI Platform calculates the estimated wait time prediction and how to enable an estimated wait announcement see Estimated Wait Time Prediction.

Agent call messages and notifications

You have flexibility based on your individual contact center environment to change how often the agent hears call alerts, what the alert sounds like, and also options for more detailed audible call announcements. See the Agent Call Messages and Notifications.

Order of caller announcements

CCAI Platform has many options that may or may not be enabled for your environment. If you are using all the below features, all announcements will be played. If you aren't using overcapacity, or CSAT, or call recording, those specific messages will be skipped.

  1. Overcapacity deflection message (if enabled)

  2. Estimated wait time announcement (if enabled)

  3. Connecting Message

  4. Record a Call Message (if enabled)

  5. Pre-Call Notification of CSAT survey (if enabled)

  6. Any other messages (if applicable)

  7. Wait Time SMS consent voice readout (if enabled and "keep waiting" is selected)

CCAI Platform Portal configuration

Universal caller announcement intervals

Announcements such as Overcapacity, CSAT, and Estimated Wait time are set with one global setting.

  1. Go to Settings > Call.

  2. Scroll down to Caller Announcements.

  3. Set the duration in minutes and click Set Caller Announcements to save.

Enable overcapacity deflection
  1. Toggle IVR - Enable Overcapacity Deflection to On to deflect customers calling in via IVR when the wait time in queue is greater than the specified duration set in the next step.

  2. Set the duration a caller should wait in queue before hearing overcapacity options. The duration is set by the Universal Caller Announcement Intervals timer above.

    ::: note

  3. Toggle Mobile and Web SDK - Enable Overcapacity Deflection to On to deflect customers reaching out via Mobile and Web channels when the wait time in queue is greater than the specified duration.

Select mobile and web SDK call deflection options

When selected, visual options will be displayed when either outside of operating hours or when the estimated wait time is higher than the set Overcapacity threshold. The regular Call/Chat options will not appear in the UI and the options you select below will be the only options available.

  • After Hours Deflection: Deflects customers by presenting alternative options. See After Hour Deflection for Calls and Chats for details.

  • Overcapacity Deflection: When the estimated wait time is greater than the overcapacity threshold, the selected options will be presented.

    • Scheduled Call: Option for the consumers to schedule a time to request a callback. See Scheduled calls.

    • Email

      • Web SDK: gives the customer the email address to contact.

      • Mobile SDK: default email app is launched with

        • Email address in the "To" field,

        • Data like app version and device type call be added to the email body

        • Subject "Support for [queue path]"

      • Email address is set in Settings > Support Center Details.

    • Phone Number: Only for mobile. Deflects consumers to another phone number. Shows as "Call now" and displays the number the phone will be dialing.

    • Voicemail: Only for mobile. Allows customers to leave a voicemail. Shows as "Leave a callback message." Voicemails will be delivered to agents assigned to the selected queue menu for calls.

IVR call deflection options

  • After-Hours Deflection: During the set hours in Support Center Details, calls will deflect to the selected option below. See After Hour Deflection for Calls and Chats.

  • Overcapacity DeflectionWhen enabled, the "Overcapacity Deflection" and "Overcapacity Deflection Options" messages will play, as well as specific recordings for options like "Overcapacity Deflection Callback Option." When you add or remove options below, be sure to update the message that lists the options callers have, otherwise, callers won't know the new options exist. These messages can be configured in Settings > Languages & Messages.

    • Queue: Deflects callers to another queue when the Overcapacity threshold is reached.

    • Phone Number: Deflects caller to another phone number.

    • Voicemail: Allows caller to leave a voicemail. Agents assigned to the queue that was called will be alerted of new voicemails.

      • Optional setting to limit the number of voicemails left by a consumer. CCAI Platform looks to see if a voicemail is already left from the incoming number and can block new voicemails from being recorded. When enabled, configure the TSS or upload a custom greeting in Settings > Languages & Messages | Deflection to Voicemail option - Request Already Placed Message.

        • Limit consumer to 1 voicemail per queue: a consumer could leave a separate voicemail request on a separate queue

        • Limit consumer to 1 voicemail request across all queues: voicemail option not available if an unattended voicemail is already left form the phone number

    • Callback: The customer can choose to receive a callback retaining their place and priority in queue. The system will call the phone number they used to dial in when they are next in queue and the call will be routed to an agent the same as a standard incoming call. To allow callers to customize their callback number, see Custom callback number.

      Timeout behavior: If the caller selects the callback option and the queue goes into after hours before the call is answered, the caller waits until the call times out based on the Unanswered Call Expiration set on the same Call Settings page. See Call settings: Call details.

      • Optional setting to limit the number of callback requests placed by a consumer. If a callback request was already placed from the incoming number, new callback requests will be blocked. When enabled, configure the TSS or upload a custom greeting in Settings > Languages & Messages | Overcapacity deflection callback option - Request Already Placed message.

        • Limit consumer to 1 callback request per queue: a consumer could leave a separate callback request on a different queue than the first request

        • Limit consumer to 1 callback request across all queues

    • Keep Waiting: Allows caller to continue waiting in the queue.

Click Set Deflection to Save the above settings.

Custom callback number


When a caller leaves a voicemail or selects the overcapacity callback option, CCAI Platform will use the phone number from which they dialed. However, sometimes a caller wants to be called back on another number. For example:

  • The consumer called at work and would like to be called on their personal phone number

  • The consumer is calling from a blocked number

  • The consumer is calling from an office, where the outgoing number does not reflect their extension

CCAI Platform will prompt the caller to enter their desired phone number, communicate the number with your CRM, and facilitate the callback as usual.

Feature specifics and expected behavior

Blocked or unknown caller behavior

CCAI Platform checks for blocked numbers and automatically triggers the custom callback flow.

Overcapacity callback
  • The consumer is prompted to leave a phone number to receive the callback call

  • If the caller leaves a valid number, they will receive a callback call when they are next in the queue.

  • If the caller does not leave a valid number, they will not receive a callback call since there isn't a number to dial to reach them.

  • The caller is prompted to leave a phone number to be called back on before leaving a voicemail.

  • If the caller enters a valid number, they will be prompted to leave a voicemail.

  • If the caller does not enter a valid number, the call will end as there is no number to dial to reach them after the voicemail is received.

CRM behavior for non-blocked callers

When a call comes in, the new number is recorded in the CRM record. After CCAI Platform looks for the contact based on the incoming phone number, 3 possible actions will take place.

  • No contact with a matching phone number is found

    • CRM will create a new contact

    • Incoming phone number is added as the primary number on the contact

    • Post comment in the CRM record

      • Incoming Phone Number: <Phone Number>

      • Callback Number: <Phone Number>

  • Existing contact with a matching phone number is found

    • Existing contact is updated

    • Incoming phone number is added as the primary number on the contact

    • A comment is posted in the CRM record

      • Incoming Phone Number: <Phone Number>

      • Callback Number: <Phone Number>

  • Multiple existing contacts matching the phone number

    • The CRM and CCAI Platform will find the most recently created contact

    • The incoming phone number is added as the primary

    • Post comment in the CRM record

      • Incoming Phone Number: <Phone Number>

      • Callback Number: <Phone Number>

Custom callback call

Overcapacity Callback: Checks for the number entered and uses the custom callback number if entered.

Voicemail: Once the agent has listened to the voicemail, they will be given the option to call the consumer back, and the entered custom callback number will be used

What happens when a consumer hangs up before completing the flow?

  • Consumer hangs up without leaving or confirming a phone number and the incoming phone number is not blocked.

    • The system will call the consumer back with the incoming phone number.
  • Consumer hangs up without leaving or confirming a phone number and the incoming phone number is blocked.

    • Consumer will not receive a callback call.

International callers

When entering the callback number, the consumer does not enter the country code. CCAI Platform will gather the country code:

  1. Based on the phone number the consumer is calling from.

    • The call-back number is interpreted as [the country code (extracted) + the consumer entered number].
  2. If the phone number is blocked and therefore the country code not available, the country code is taken from the IVR number the consumer called into.


  • If a consumer dials a UK number from a UK phone and does not enter UK country code [44], the number will be stored with +44 and the callback call will take place as usual since the correct number is stored.

  • If the number is blocked, and the caller is calling into a UK number from a phone number with a US country code, the callback will not take place since there will be an incorrect number stored for the caller [UK +44 (extracted from inbound IVR number + consumer entered number].

Valid and invalid numbers

Once the caller enters the phone number, CCAI Platform checks for the validity of the number. If it's not valid the consumer will be asked to enter the number again.

For US numbers: number must be 10 digits.

International numbers: after the country code is determined, phone number validation is run based on the number format of that country.

CCAI Platform Portal configuration

Recorded messages

Default messages

There are 2 messages that are not customizable and will be played during the custom callback flow. The messages will be translated into all languages and use the text-to-speech voice specific to each language.

Phone Number Confirmation Message

"If the phone number <Phone Number> is correct, please press 1 to confirm. If that number is not correct, please press 2 to try again."

Phone number invalid

"Sorry, that number won't work, please try again."

Upload custom messages
  1. Go to Settings > Languages & Messages

  2. Scroll to the Custom Callback Messages section.

  3. If you are using Voicemail, record the 3 voicemail greetings.

  4. Record the following 3 greetings for callback calls.

  5. Repeat for any other languages you have enabled.

  6. Click Apply after updating each language.

Configure Custom Callback

All blocked or unknown numbers will automatically be prompted to enter a custom callback number.

Enable for all callers and set retry threshold

Follow these steps to enable the feature when any caller selects overcapacity callback or leaves a voicemail.

  1. Go to Settings > Call.

  2. In the Custom Callback section, check to enable "Allow consumer to leave a custom call back phone number" if you would like every caller to get the option to leave a different number than the number from which they are calling when:

    -Leaving a voicemail

    -Selecting the callback option for overcapacity

  3. Set the number of times a consumer can try to leave a phone number before the system times out and ends the call. If the number entered is invalid, the consumer will be asked to try again.

  4. Click Set Call Details to save.

Phone Number Management


Admins can set which number shows for outbound calls, and agents can choose from a list of assigned numbers when placing a call.

This can help you improve expense tracking, avoid long-distance charges, and assign numbers for different needs such as specialized support or multiple brands.

Feature details

Allows you to store and label numbers programmed to your environment for easy recognition by other Admins and Agents.

Agents can set a favorite outbound number or select from a list of other numbers. The favorite number can serve as a dedicated number in place of a phone extension.

Consumers can reach a specific agent/sales rep via their individual number.

The outbound phone number used is included in the default comment is sent to the CRM

Add a phone number

  1. Go to Settings > Call.

  2. Click Phone Number Management

  3. Click Add a Number.

    1. Add a phone number including the + country code.

    2. Check this box if this the global outbound number. Default global numbers will be used when any call is made outbound from an agent that is not configured with a specific number and will be available to all agents for outbound dialing.

    3. Add a label that will clearly distinguish this number from others and click Save.

  4. Once the number is saved, click Verify all Unverified Numbers, and the status should change to Verified. This process checks to make sure the phone number has been configured for your CCAI Platform environment.

  5. Repeat steps 3-7 for all other phone numbers you wish to set up as Outbound calling options.

Allow/Deny international calls

By default, all countries are allowed for international calling. These settings allows admins to specify which countries are allowed or denied for each phone number.

After this international calling configuration is set at the phone number level, admins can manage user-level access. See Add and view users for more information.

  1. Go to Settings > Call > Phone Number Management > Add Number.

  2. Select the checkbox This number is restricted to call certain country codes only.

  3. Two options are available: Allow this number to call the following country codes, and Deny this number from calling the following country codes. Select the country codes under Permitted Country Codes to allow or deny based on previous selection.

  4. Click Save.

Assign numbers to queue menus

  1. Go to Settings > Queue and select IVR or Web.

  2. Click on a queue, then scroll to the bottom of the settings on the right until you see the Outbound Phone Numbers Settings.

  3. Select and set the number you would like to show when outbound calls are placed from this queue or from agents assigned to this queue

    Select a phone number from the list of numbers you have set up in the above steps.

    Click Add Number.

    Click Set Outbound Numbers.

  4. The phone number is now saved and will be used as the outbound number for calls from this queue and will show in the queue set up page next to each assigned queue. In this case, since the setting was for a parent queue, the sub-queues also have the same outbound number setting.

    1. If multiple numbers are added to the queue, a default number must be set.

  5. Repeat steps 1-4 for any other queues which will have specific outbound numbers.

Phone number selection in the Agent Adapter

When an agent clicks on the dial option of the adapter, they will now see a drop-down of the default Global Outbound number as well as any other outbound numbers which are associated with the queues to which they are assigned.

Agents can also favorite one number so that it shows by default when dialing outbound.

  1. **From the agent adapter, click Dial**

  2. From the number drop-down, select a number from the available options.

  3. **Click on the star icon to favorite an outbound number option.**

Multi-language support

When using multiple languages, the languages must be marked as Live on the Languages and Messages page to appear in the language dropdown for Agents. If the language is not Live, the number will still appear but will show in reporting as the default language, English.

Estimated wait time announcement for calls


Estimated Wait Time (EWT) Announcements use a calculation to predict the wait time until a caller is connected with an agent. The announcement plays for IVR calls.

Feature details

  • When enabled, Estimated Wait Time is announced when the caller enters the queue using a custom audio file and Text to Speech voice.

  • Option to have the announcement repeat or only play one time at the start of the call.

  • The Estimated Wait duration is capped at 30 minutes. If the actual wait time is longer than 30 minutes, the announcement will not go above 30 minutes.

  • TIP: If you'd like callers to hear deflection options immediately after the wait time notice, enable both Estimated Wait Time and Overcapacity Deflection. Callers will hear the estimated wait time, then hear overcapacity options, as long as Overcapacity Deflection is enabled with at least one option.

CCAI Platform Portal configuration

Enable EWT announcement

  1. Go to Settings > Call.

  2. Enable Estimated Wait Time by toggling to On.

  3. Select if the announcement should repeat or only play once. The interval at which it will repeat is set by the Universal Timer at the top of the section.

Customize announcement

By default the estimated wait announcement will be announced using a TTS voice: "Thank you for calling, your estimated wait time is @{ESTIMATED_WAIT_TIME_IN_MINUTES}." To customize the message follow the steps below.

  1. Record a custom audio file that leaves room at the end for the system to fill in the variable for what the estimated wait time will be announced as.

  2. Go to Settings > Languages & Messages.

  3. Click Upload in the Estimated Wait Time section.

  4. Click Apply to save.

Call experience flows

  • Call Flow experience for different call types

    • Overcapacity Deflection

      • IVR

      • Mobile

    • Afterhours Deflection

      • IVR

      • Mobile

    • Recording Per Queue Option

    • Temporary Redirect per IVR Queue

    • Credit Card Over IVR

Scheduled calls


Rather than waiting in queue for an agent, give consumers the option to select a time that works for them to receive a call from an agent. Scheduled calls can also be enabled for after hour or overcapacity deflection and are available when using the Mobile or Web SDK.


With the CCAI Platform Web, or Mobile SDKs, a consumer selects the scheduled call option and is presented with a list of open time slots in 15-minute increments.

  • Before the scheduled time (duration is configurable), an agent will be assigned to the call to ensure the call takes place at the scheduled time.

  • If no agents are available to be assigned, the call will wait in queue and be assigned as soon as an agent is available.

  • When scheduled calls are enabled for queues with Cascade groups:

    • If available, an agent from the highest level group will be assigned the calls first, then the next group in the standard routing order.

    • If no agents are available to be assigned, the call will wait in queue and the first available agent from any cascade group will be assigned.

Mobile SDK

Once the time selected is reached, the consumer receives a call via VoIP in the app and SmartActions will be available. If the consumer doesn't pick up the Mobile call, CCAI Platform will then place another call out to the consumer via a standard outbound (PSTN) call. During the PSTN fallback call, SmartActions will not be available. If the consumer doesn't pick up, the call is marked as finished.


Once the time selected is reached, the consumer receives a PSTN call to the phone number provided when the scheduled call was initiated. SmartActions are not available for Web SDK Scheduled calls. If the consumer doesn't pick up, the call is marked as finished.

For UI and details about the agent and consumer experience, see Scheduled calls.

Schedule call timeslot logic

Currently, the scheduling model is static and calculates how many calls can be scheduled for a specified period of time, using the following logic:

  • Agent availability calculation

    • Total Slots Available per 15 min interval = 2 x Total Number of Agents assigned to the Queue
  • Operation hours

    • Time slots must be in the operation hours of the queue

    • If currently out of operation hours, time slots for the following day will be offered

  • Estimated wait time (EWT)

    • Based on the current Estimated Wait Time calculation, consumers will only see time slots that start after the duration of the EWT

    • Since time slots are in 15-minute increments, the next slot will be 15 minutes after the EWT duration

    • For example, if it's currently 1 pm and EWT is 35 minutes, the first time slot will be 1:45 pm

CCAI Platform Portal configuration

Global settings

  1. Go to Settings > Call.

  2. Set the Scheduled Call Countdown which controls the duration of a countdown timer an agent will see before getting assigned to a scheduled call. If the value is set to 0 minutes, the agent gets assigned the call at the time of the call and will not see a countdown timer.

  3. Set the Scheduled Call Expiration: sets the threshold for a scheduled call if no agents are available at or after the selected scheduled call time or if the assigned Agent does not pick up the call.

    Example: Consumer's scheduled call time is 12:00 and all agents are on calls. If the expiration is set to 15 mins, the scheduled call will be in queue to be assigned to an agent until 12:15. If no agents are available during the 15 minutes, the call will expire and the consumer who scheduled the call will not receive a call.

  4. Click Set Call Details to save.

Enable scheduled calls for after hour deflection

When your hours of operation dictate that live calls cannot be delivered, you can enable the option for the consumer to be able to select a time slot to receive a call when your operation is open the next day. See Support Center Details - Hours of Operation Settings for details.

  1. Go to Settings > Calls.

  2. Scroll to the Caller Announcements section.

  3. Toggle to On to enable after hours deflection.

  4. Scroll down and mark the checkbox next to Scheduled Call.

  5. Click Set caller announcements to save.

Enable scheduled calls for overcapacity deflection

Overcapacity is active when the wait time threshold is met. You can enable the option for scheduled calls to show as an overcapacity option so that consumer can request a call back at a time in which the agents should be available. See Call Settings: Overcapacity deflection & caller announcements for more details.

  1. Go to Settings > Calls.

  2. Scroll to the Caller Announcements section.

  3. Toggle to On to enable Overcapacity deflection.

  4. Scroll down and mark the checkbox next to Scheduled Call.

  5. Click Set caller announcements to save.

Call recovery features


Once a call is connected to an agent, if that call fails or is unexpectedly ended from the agent's side, then the call will go into a call recovery flow. Depending on the type and duration of a failed call, the call recovery can either be automatic or manually initiated by an agent.

Why calls are unexpectedly ended or dropped

  1. Agent closes active tab or browser in the middle of the call

  2. Network issues on the Agent's side, for example, WiFi drops, or bandwidth maxes out

  3. Network issues on the caller's side

Mobile SDK: Automatic call recovery

If the agent's connection is interrupted or unexpectedly ended from their voice provider, CCAI Platform will wait for the agent to be reconnected for up to one minute. If the agent reconnects, the call will be automatically recovered and both the agent and caller can resume the same call.

If the agent does not reconnect within one minute, or if the caller hangs up, the call will be ended and the status will be set to 'Finished'.

Manual callback

Hangup and callback

When an agent is on a call, they have an option to Hang up and call back. This is useful if there is a bad connection and/or difficulty hearing the caller.

Clicking Hang up and call back will end the current call and place a new Outbound call to the caller with a new Call ID. If this call originated as a VoIP call from the Mobile SDK, VoIP will be used to call the consumer back. If this was an IVR call or a Mobile SDK PSTN call, the call will be placed back to the consumer via PSTN.

Short call recovery

If Automatic Wrap up is enabled and the call connects but is ended within 10 seconds of connecting, the call adapter appears with a message "The call was too short" and provides an option to either Call back, or go Back to Available, placing them back in Available status.

  • Clicking the Call back button will place a new Outbound call to the caller with a new Call ID.

  • Clicking the Back to Available button will set the Agent's status to Available.

  • A Timer also counts down to Automatically set the Agent's status back to Available. The timer is set for 180 seconds by default.

See Call settings: Call details for automatic wrap-up settings.

Voicemail callback

When an Agent listens to a Voicemail they have an option to press the Call back button. This will place a new Outbound Call and set the status of the original Voicemail call to 'Voicemail Read.'

Scheduled call recovery

If a consumer scheduled a call via the Web or Mobile SDK, then doesn't pick up the call at the scheduled time, a Callback option presented to Agent which will create a new Outbound call. The original call ID will have the fail reason "End User No Answer."

Because of the unique call type that scheduled calls present, if the Agent clicks 'Hang up and Callback', this will create a new Inbound call.