Avaya Aura 8 and Mindful integration guide

Your Avaya telephony environment can be integrated with your Mindful Callback account to deliver calls via SIP while maintaining UUI and User-to-User data.

This guide presents configuration requirements for the following integration components.

  • Mindful Callback for callback registration and processing
  • Providing a callback offer through Mindful Callback, including the option to hold
  • Avaya Communication Manager (CM), including queuing VDNs and vectors for the appropriate skills
  • Avaya Session Manager (SM)
  • Avaya Session Border Controller Enterprise (SBCE)

We also discuss routing configuration and best practices, as well as a detailed call flow.

Important:

Before you begin - The following is a list of information that should be noted before beginning the steps in this guide.

  • The Callback Number configured for the Call Target
  • Avaya Communication Manager Vector for the skill being added to integration
  • Avaya Session Manager IP address
  • Avaya CM IP address
  • Mindful Callback instance IP address
  • Avaya CM Priority queuing VDN
  • Call Target phone number
  • Your contact center's public IP address (for SIP addressing)
Note:
  • This guide assumes that Avaya Aura 8 is the version used in your Avaya environment.

  • The minimum supported version of Avaya SBCE is 8.1.2 PATCH 2.

  • It is important to ensure that SIP headers and the SIP URI are intact when they leave the switch in your Avaya environment.

  • The steps in this guide assume that you have full access to Avaya Session Manager (SM), Avaya Communication Manager (CM), and the Mindful Callback user interface.

  • If you are interested in using Avaya UUI routing to utilize a single queueing VDN that sends calls to a shared pool of agents, see the add-on article Avaya UUI Routing with Mindful Callback.

  • For further validation against additional integrations options, please contact a Mindful representative.

  • The configuration in this guide is an example and may be used as a template for integrating with Mindful. Any sample code in this guide should not be considered ready for production.

Tip:
  • When quoting the estimated wait time prior to offering a callback, it is a best practice to set an upper limit for the amount of time that can be quoted. For example, if the wait time exceeds 10 minutes, you might choose to say "...more than than 10 minutes from now" rather than quoting an exact time.

  • We recommend setting a minimum offer threshold based on the current estimated wait time to ensure that callback offers are not made when wait times are very low. You may also wish to check agent availability prior to sending calls to Mindful Callback.

Overview

This integration guide covers the following topics.

  • Components and architecture
  • Step 1: Configure your Mindful account
  • Step 2: Configure your SBC
  • Step 3: Configure the Avaya environment to route inbound calls
  • Step 4: Configure the Avaya environment to receive callbacks
  • Call flows
  • Optional: Offer Second Chance Callback

Components and architecture

Expand the following content to to review the definitions of acronyms and terms used throughout this guide. You can also view a high-level overview of the components and architecture of the integration before getting started.

Definitions and acronyms

TermDefinition
CMAvaya Communication Manager
DIDDirect Inward Dialing phone number
SBCSession Border Controller
SIP TrunkVirtual phone line that enables users/applications to make and receive calls
SIP URISIP addressing scheme that communicates who to call via SIP
UUIUser-to-User data passed in SIP headers
VDNVector Directory Number

Components and architecture

architecture diagram

Step 1: Configure your Mindful account

At least one Call Target should be configured on the Callback platform before addressing your Avaya environment.

For complete step-by-step instructions on building a Call Target, see How to set up a call target. Once you have a Call Target set up, use the guidelines below to integrate it with your Avaya environment.

Registration

Quick access: Callback > Call Targets > Your Call Target > General tab > Registration

  • Offer ASAP Callback: Select this checkbox to offer callbacks to be returned as soon as possible.
  • Offer Choose Hold: Select this to offer callers the option to wait on hold rather than accepting the offer of a callback.
  • Offer Scheduled Callback: Select one of both of these checkboxes (Voice and/or Widget/API) if you wish to offer callback scheduling for specific dates and times.
Note: For government users - SIP is the only Telephony Type supported in the Government instance.
Important:
  • The Choose Hold Number must be in the format <prefix><queuing VDN>@<your public IP address>
  • The Callback Number must be in the format <prefix><priority queuing VDN>@<your public IP address>
  • The public IP address in the Callback Number should lead to a firewall with a rule configured to forward requests from the Mindful SIP IP addresses to the Avaya Session Manager. The firewall should be SIP-aware (e.g. using ALG) so that an RTP stream can be established using a dynamic range of ports.

Contact Center Settings

Quick access: Call Targets > Your Call Target > General tab > Contact Center

In the Contact Center section, configure the Callback Phone Number field with the SIP address of the VDN that leads to a holding queue staffed by agents. This holding queue should have a higher priority than regular inbound calls.

Call Target Metadata

In order to obtain Avaya UUI data and attach it to callbacks, you must configure a Metadata item for any Call Target used in the integration. For complete instructions on working with Metadata items, see How do I work with user data and metadata? in the How To section.

Quick access: Call Targets > Your Call Target > Metadata tab

Configure a single Metadata item with the following parameters.

metadata configuration

  • Name: User-to-User
  • Type: Sip Header
  • Max Length: 10
  • Persist forever: enabled
Note:

Mindful will retain UUI data as long as the Persist forever checkbox is selected. With the checkbox selected, UUI data may display as hex-encoded strings in Callback reports. If you would like to remove historical metadata, first deselect the Persist forever box then click the Remove historical metadata button.

Provision a phone number for the Call Target

Each Call Target used in the integration must have a unique phone number assigned to it in the Callback application. For the examples in this guide, the phone number +12512500865 was used.

provisioning phone numbers

Step 2: Configure your SBC

Mindful Callback integrations can function with different Session Border Controller (SBC) products regardless of the ACD platform used in your environment. Click any of the links below for instructions on integrating your chosen SBC.

Note: We plan to add integration guides for more SBC products over time. Check back here for updates or let us know if you would like us to cover a specific SBC.

Step 3: Configure the Avaya environment to route inbound calls

Configuration is needed in both Avaya Communication Manager (CM) and Avaya Session Manager (SM). For inbound calls, we will begin with CM and then proceed to SM.

Configure Communication Manager to forward inbound calls

To configure CM, you will need to update the vector script of the queuing VDN and add an entry to the ARS Digit Analysis table to assign a route to Session Manager.

  • In the vector script on the queuing VDN, add a route-to step to send the call to the Call Center Phone Number configured in the Callback application.
Example

Using the SAT command change vector xx, we have configured a route-to step as Step 04 in the example vector below.

example vector
Important:

The number designated in the route-to step should match a route to the Session Manager.

In the preceding example, we allow the Call Target phone number (12015841234) via an entry in the ARS Analysis table. In the screenshot below, Dialed String 1201 determines that numbers matching the 1201 prefix with a length of 11-digits will use Route Pattern 1. In our configuration, Route Pattern 1 uses an existing SIP trunk to the Avaya Session Manager.

The change ars analysis 1201 SAT command was used to perform this configuration.

A.R.S. analysis tableWith these items complete, CM is ready to handle inbound calls with a route over to Session Manager. Next, we will configure Session Manager to send calls into the Callback application.

Configure Session Manager to handle inbound calls

To complete the inbound configuration, you will need to perform the following updates in Session Manager:

  • Prefix the plus (+) symbol to customer phone numbers for compliance with Mindful Callback.
  • Create a new SIP Entity for the SBC.
  • Create new Routing Policies.
  • Create new Dial Patterns.
Important:

If the Mindful Callback application utilizes Twilio trunks to receive inbound calls (default configuration), then the ANI of the call sent from the ACD environment to Mindful Callback must be in e164 format. The ANI must be prefaced with +1. If a custom range of DNs is used instead, e164 format is not required.

Create an Adaptation to prefix the plus (+) symbol

When sending SIP calls to the Callback application, the SIP URI must be in the format sip:+<phone number>@sip-callback.vhtcx.com. Using our example phone number of 12015841234, the format would be sip:+12015841234@sip-callback.vhtcx.com.

The plus (+) symbol is required, and any SIP calls to Callback without the plus symbol will fail. To insert the symbol in front of the number, you will need to create an Adaptation in Session Manager.

Use the image and guidelines below to create the Adaptation. If you are already using an Adaptation, you can add a new row rather than creating a new Adaptation.

adaptation details

Quick access: System Manager > Elements > Routing > Adaptations > New

  • Adaptation Name: Enter a description name of your choice.
  • Module Name: Select DigitConversationAdapter
  • Module Parameter Type: Select Name-Value-Parameter, then add one parameter with the following values:
    • Name: fromto
    • Value: true
  • Digit Conversion for Outgoing Calls from SM: Add one entry with the following values:
    • Matching Pattern: Enter the number or pattern being dialed. This is the number used to call the Callback application (for example, 12015844063).
    • Min/max: Enter a minimum and maximum value. The example uses 11 digits in both the Min and Max fields.
    • Delete Digits: Enter 0.
    • Insert Digits: Enter the plus (+) symbol.
    • Address to modify: Select destination.
Note:

In our example configuration, Communication Manager already strips the 9 prefix off of numbers if it is present. If CM is not already configured to do this in your environment, you will need to strip the 9 prefix in the Adaptation by entering 1 in the Delete Digits field. This instructs the adaptation to delete the first digit from the number.

digit conversion

Create a SIP Entity for the SBC

There should already be a SIP Entity configured in System Manager for your SBC. Add the Adaptation created in the previous step to the existing SIP Entity for the SBC, as shown in the following image.

sip entity details

entity links

If needed, use the following steps to create the SIP Entity.

Quick access: System Manager > Elements > Routing > SIP Entities > New

  • Name: Enter a descriptive name for this SIP entity.
  • FQDN or IP Address: Enter the address of the SBC.
  • Type: Select SIP Trunk.
  • Adaptation: Select the Adaptation that you created in the previous section of this guide.
  • Leave all other settings at their default values, or the values needed in your environment.
  • Entity Link: Update the existing Entity Links for all protocols.
    • Select your new SIP Entity in the SIP Entity 2 field.
    • For TCP and UDP, enter 5060 in the Port field next to SIP Entity 2.
    • For TLS, enter 5061 in the Port field next to SIP Entity 2.
    • Select trusted in the Connection Policy dropdown menu.

Create Routing Policies

We have already created Routing Policies on the SBC, but we must now create Routing Policies in System Manager to route specific numbers to the SBC or Avaya CM.

When creating the new Routing Policies, select the SIP Entity that you created in the previous section of this guide to use as the SIP Entity as Destination. Do not add a Dial Pattern at this time.

1. Routing Policy to CM

The first Routing Policy will send callbacks from Mindful Callback into Communication Manager.

Quick access: System Manager > Routing > Routing Policies > New

In our example configuration, the Routing Policy catches two values: one complete inbound DID and a range of numbers representing VDNs, agent stations, or similar endpoints.

  • Select the SIP Entity that you created in the previous section of this guide to use as the SIP Entity as Destination.
  • Add at least one DID in the Dial Patterns section.
  • Leave all other settings at their default values, or the values needed in your environment.

routing policy details

2. Routing Policy to Mindful Callback via the SBC

The second Routing Policy will send calls to the Mindful Callback application via the SBC. This policy specifically targets the SBC.

Quick access: System Manager > Routing > Routing Policies > New

In our example configuration, the Routing Policy includes Dial Patterns for any 11-digit number starting with 12, 13, 14, 15, etc. We used this method to catch any possible U.S. phone number, but your preferred method may differ.

routing policy details

Select the Mindful Callback SIP Entity created in a previous step and do not add a Dial Pattern at this stage. We will add a Dial Pattern in the next step.

Create Dial Patterns

Next, we will create Dial Patterns to link VDNs with the Routing Policies created in the previous step.

1. Dial Pattern for calls to CM

Configure the first Dial Pattern to match the VDN correlating with the intended skill. In our example configuration, we are using the VDN 20062, which is configured as the pattern 20xxx.

dial pattern details

Quick access: System Manager > Routing > Dial Patterns > New

  • In System Manager, create a new Dial Pattern that matches the VDN for the intended skill. This will be the same number used in the route-to step that you added to the vector script for the queuing VDN in Avaya CM.
  • Add the Routing Policy for CM created in the previous section of this guide.
Note:

Avaya Session Manager does not handle audio, so the RTP may either be established between the Avaya CM and Callback, or between the SBC and Callback, depending on your Avaya configuration (including Media Shuffling and Direct-IP-Audio) settings.

2. Dial Pattern for calls to Callback via the SBC

Configure the next Dial Pattern to match the Call Center Phone Number configured for the Call Target. In our example configuration, we are using the number 12512500865, which is configured as 12x.

dial pattern details

Quick access: System Manager > Routing > Dial Patterns > New

  • In System Manager, create a new Dial Pattern that matches the Call Center Phone Number configured for the Call Target.
  • Add the Routing Policy for the SBC created in the previous section of this guide.

The Avaya platform is now configured to send SIP calls to Callback via the configured Call Center Phone Number.

Step 4: Configure the Avaya environment to receive callbacks

Similar to inbound calls, you will need to update the configuration in System Manager to handle callbacks received from the Mindful Callback application.

Configure Session Manager for outbound callbacks

When a SIP call arrives from Callback, Session Manager will receive an INVITE to the Call Center Phone Number configured for the Call Target.

Create a Dial Pattern

Quick access: Elements > Routing > Dial Patterns > New

Use the graphic and steps below to configure a Dial Pattern to route calls from the Call Center Phone Number to Communication Manager.

dial pattern details

  • Pattern: Select a pattern matching the Call Center Phone Number, as shown in the example.
  • Min/Max: Set to the exact length of the Call Center Phone Number.
  • SIP Domain: Set to ALL.
  • Originating Locations and Routing Policies: Add the Routing Policy that leads to Communication Manager. This Routing Policy should already exist in Session Manager.

In the preceding example, any calls that come into Session Manager from a 9-digit number beginning with 8099 will be sent to Communication Manager.

Create a SIP Entity for Avaya CM

There should already be a SIP Entity configured for Communication Manager in your environment. However, you can use the following image and instructions to create one, if needed.

sip entity details

Quick access: System Manager > Elements > Routing > SIP Entities > New

  • Name: Enter a descriptive name for this SIP entity.
  • FQDN or IP Address: Enter the address of the SBC.
  • Type: Select CM.
  • Adaptation: Select the Adaptation that you created in the previous section of this guide.
  • Leave all other settings at their default values or the values needed in your environment.
  • Entity Link: Make the following additions to the Entity Link that is already configured for Session Manager.
    • Select your new SIP Entity in the SIP Entity 2 field.
    • Enter 5060 in the Port field next to SIP Entity 2.
    • Select trusted in the Connection Policy dropdown menu.

Create the callback call vector

The agent leg of the callbacks from the Mindful Callback application will be sent in via a SIP request to sip:20062 – the SBC, via URI Groups and a Routing Profile. Session Manager will use a route pattern to send this to CM where 20062 exists as a VDN number using vector 62.

call vector

The queuing vector shown here does nothing more than queue the call to skill at high priority. If any decision making needs to be done on the callback, based on the inbound UUI data (now present on the callback), vector variables can be used to do so.

Call flows

The following diagram highlights the high-level call flow for inbound and outbound calls using the Customer First Callback Strategy in Mindful Callback.

call flow diagram

This call flow assumes that the Customer First Callback Strategy is being used. If the Agent First Callback Strategy is used instead, then the agent leg of the call would be connected prior to dialing the customer's phone number.

Optional: Offer Second Chance Callback

Second Chance Callback is a best-practice methodology that can increase the take-rate of callback offers and lower the abandon rate in your call center's holding queues. With a few updates to your routing logic, you can provide additional callback offers to customers waiting on hold who have already declined an initial offer.

There are a variety of reasons that customers might appreciate a second chance to accept an offer of a callback. For example, perhaps something has come up that requires their attention and they can no longer wait on hold. Perhaps the quoted wait time was low when they declined the first offer but queue conditions have quickly changed and resulted in a longer hold time. Regardless of the scenario, Second Chance Callback ensures that customers have the callback option available when they need it.

Benefits

Our research shows positive results for call centers offering Second Chance Callback, including:

  • Keeping customers in control with additional options while holding.
  • Reducing abandoned calls in the holding queue by offering an alternative option.
  • Fully controlling Second Chance offers in your ACD with no integration constraints.
  • Adding another tool to address unexpected increases in hold time.
  • No additional requirements for customers. They are not required to respond to Second Chance prompts, but can instead simply continue to wait on hold if they choose.

ACD configuration

Most configuration for Second Chance Callback is done on your ACD platform, so the technical implementation will vary based on your integration. In all integrations, the following logic must be introduced to interact with customers in the holding queue.

call flow diagram

  • Whether offers are made in your ACD or in Mindful Callback, the process begins with the first offer. If the initial offer is accepted, then a callback is registered and no Second Chance offer is needed.
  • If the initial offer is not accepted, callers are routed to a holding queue.
  • A timer begins in the holding queue. When the specified time expires, another callback offer is made.
  • If the customer declines the Second Chance offer, then the timer is reset, and another offer will be made when it expires again.
  • If the customer accepts the Second Chance offer, the call is sent to Mindful Callback for treatment.
Note:

You can add logic into the routing script to limit the total number of offers made per call.

Things you'll need

If you wish to use a single Call Target for normal inbound calls and Second Chance calls, you will need:

  • Two Phone Numbers provisioned for the same Call Target.
  • The Return to Hold Call Target setting disabled. Offering a hold option in Mindful Callback after a customer has already chosen to leave the holding queue can negatively impact the customer experience.

If you wish to use separate Call Targets for normal inbound calls and Second Chance calls, you will need:

  • Two Call Targets configured with the same Call Center Phone Number targeting the same group of agents.
  • The Return to Hold setting disabled for the Second Chance Call Target. The setting can still be enabled for the normal inbound Call Target.

For either method, you will also need:

  • The ability to capture DTMF input from customers in your holding queue.
  • The ability to play audio prompts to customers in your holding queue based on a timer.

Mindful Callback configuration

There are two alternatives for preparing your Mindful Callback account for Second Chance Callback. Each alternative introduces its own advantages and drawbacks.

  • Option 1 (best practice): Use separate Call Targets for normal inbound calls and Second Chance calls.
  • Option 2: Use a single Call Target for both normal inbound calls and Second Chance calls.

Option 1 (best practice): Use separate Call Targets

This option uses the first Call Target to service normal inbound callback requests with a second Call Target dedicated to servicing Second Chance callback requests. For an initial offer, send the call to the first Call Target. For a Second Chance offer, send the call to the second Call Target. This option separates the two types of calls for ease of reporting and real-time analysis.

call targets page

AdvantagesDrawbacks
Call Detail reporting is more convenient.ECBT is not combined between the two Call Targets. Therefore, ECBT on the normal inbound Call Target may be lower than it should be, since the call volume from the Second Chance Call Target is not included in the calculation.
Real-time monitoring clearly distinguishes the two call types.
You can enable the Return to Hold option on the normal inbound Call Target while disabling it on the Second Chance Call Target.

Option 2: Use a single Call Target

The second option uses a single Call Target to service both normal inbound callback requests and Second Chance requests. This method is easier to configure and maintain, but it introduces a few additional drawbacks to consider.

call targets page

AdvantagesDrawbacks
Configuration is simpler.When a Second Chance ASAP callback is registered, it will be placed at the back of the virtual queue or waitlist. This can result in customers who accept Second Chance offers waiting longer than they would have if they remained in the holding queue.
Return to Hold should not be offered by the Call Target. This can affect your offer strategy for normal inbound calls, which may not be intended.
Reporting on Second Chance interactions requires additional steps.
Real-time monitoring combines normal inbound callback requests and Second Chance requests together.

Reporting on Second Chance Callback interactions

As noted in the lists of advantages and drawbacks, reporting on Second Chance interactions varies depending on whether you use one or two Call Targets.

Reporting with separate Call Targets

On the Metrics, Executive Summary, and Call Detail screens, use the Call Target filter to view data only for the Second Chance Call Target. This will exclude any data from initial offers and callers that chose to hold. If you offer Second Chance for multiple lines of business, you can add all of your Second Chance Call Targets into a shared Reporting Category to view all Second Chance interactions.

On the Callback Status screen, review real-time statistics for the Second Chance Call Target or use the Category filter to limit the view to only Second Chance Call Targets.

Reporting with a single Call Target

When using a single Call Target, additional configuration is required and the reporting capabilities are limited.

Preparation:

  • Provision two Phone Numbers in the Mindful Callback user interface, and assign both Phone Numbers to the same Call Target.

phone numbers page

  • In your routing scripts, send normal inbound calls for callback treatment to the first Phone Number.
  • Send Second Chance calls for treatment to the second Phone Number.

Reporting:

  • On the Call Detail screen, export the reporting data to CSV. In the exported CSV file, the Call Target Phone Number to which each call was sent will be noted in the Source column.
  • In the CSV file, filter the Source column for all records matching the Second Chance phone number. The remaining data will include only Second Chance interactions.

When using a single Call Target, the Callback Status, Metrics, and Executive Summary screens will combine Second Chance interactions with initial offers and callers that chose to hold.