introduced-transfer-threshold
Section: gim-transformation
Default Value: 0
Valid Values: Any nonnegative integer
Changes Take Effect: At the next run of Job_TransformGIM
Dependencies: None
Introduced: 8.5.001
Specifies a time threshold, in seconds, for Genesys Info Mart to treat a conference as an introduced transfer. If the conference initiator's participation is less than the threshold, while the receiving agent continues on the call, Genesys Info Mart treats this call flow as a special case of transfer. The option applies only to voice calls.
handling-timeout
Section: settings
Default Value: 180
Valid Values: Any integer from 1 to 1,440 (24 hours)
Changes Take Effect: Immediately
Specifies the handling timeout (in minutes) for any interaction that an agent handles. If no requests
are received from the agent who handles the interaction during this time
interval, the agent application is considered inactive and the interaction is
revoked and returned to the queue. This option applies to requests between the
desktop application and Interaction Server only. Value changes do not affect interactions
that are already being handled.
The same option might be specified in interaction user data or media type options.
The first found option is taken into consideration with the following check order:
1. The value of the “handling-timeout” key in user data of an interaction.
2. The media type option “settings/ handling-timeout”.
3. This “handling-timeout” IXN Server option.
delivering-timeout
Section: settings
Default Value: 30
Valid Values: Any integer from 1 to 86,400 (24 hours)
Changes Take Effect: Immediately
Modified: 8.5.201.05
Specifies the timeout, in seconds, for an agent to accept an interaction that is being delivered to him or her. If the agent does not respond before the timeout expires, the interaction is revoked and returned to the queue from which it was taken by Universal Routing Server.
stop-abandoned-interaction
Section: settings
Default Value: never
Valid Values: always, never, noagents, noanswer
Changes Take Effect: Immediately
Modified: 8.5.301.06
Specifies how Chat Server handles chat interactions (in Interaction Server) when the chat session is finished. Possible values:
- always: interactions are always stopped when the chat session is finished (not recommended value).
- never: interactions are never stopped by Chat Server (recommended value).
- noagents: interactions are stopped only if there are currently no agents or supervisors in the session (use value wisely).
- noanswer: interactions are stopped only if no agents ever joined the session - in other words, the session was never answered (use value wisely).
Note: When the chat session is closing, it ignores the presence of bot participants when evaluating this option (in other words, bot participants are not considered "agents"). The legacy "true" and "false" values are also supported and converted to new values as following:
- "false" is interpreted as "never"
- "true" is interpreted as "noanswer"
By default, Chat Server does not stop any interaction after the chat session is finished. Instead, Chat Server updates the IsOnline interaction property to false and attaches reporting statistics. If your deployment includes Genesys Info Mart reporting, Genesys recommends that you set the value of this option to "noanswer", to enable accurate reporting of abandoned chats. In all other deployments, Genesys recommends that you set the value of this option to "never", and have the agent desktop and/or a workflow stop the interaction. Values other than "never" must be used cautiously, as stopping the interaction from Chat Server may lead to conflicts with updates from the agent desktop.
canceled-queues
Section: gim-transformation
Default Value: iWD_Canceled
Valid Values: A comma-separated list of queue names
Changes Take Effect: At the next run of Job_TransformGIM
Dependencies: None
Introduced: 8.1.3
In multimedia deployments that use archive queues in their business processes, specifies the Interaction Queues that are used as archives for canceled interactions. When an interaction is placed into one of these queues, Genesys Info Mart considers the interaction to be terminated. The transformation job assigns the technical result/reason combination of COMPLETED/CANCELED in the IRF of the handling resource that placed the interaction in the queue, and Genesys Info Mart excludes the interaction from further processing.
The option was introduced in release 8.1.3. In earlier 8.x releases, Genesys Info Mart handled these situations as transfers to a queue.
completed-queues
Section: gim-transformation
Default Value: iWD_Completed
Valid Values: A comma-separated list of queue names
Changes Take Effect: At the next run of Job_TransformGIM
Dependencies: None
Introduced: 8.1.3
In multimedia deployments that use archive queues in their business processes, specifies the Interaction Queues that are used as archives for completed interactions. When an interaction is placed into one of these queues, Genesys Info Mart considers the interaction to be terminated. The transformation job assigns the technical result/reason combination of COMPLETED/ARCHIVED in the IRF of the handling resource that placed the interaction in the queue, and Genesys Info Mart excludes the interaction from further processing.
The option was introduced in release 8.1.3. In earlier 8.x releases, Genesys Info Mart handled these situations as transfers to a queue.
Interaction Concentrator
Also known as ICON. A Genesys product that collects and stores detailed data from various sources in a contact center that is empowered by using Genesys software. Downstream reporting systems can access Interaction Concentrator data in near–real time.
Operating on top of Genesys Framework, the product consists of a server application that is called ICON and a database that is called Interaction Database (IDB). The server receives data from data sources such as Configuration Server, T-Server, or particular Genesys solutions; it then stores this data in IDB by using Genesys DB Server.
Glossary
routing-timeout
Section: settings
Default Value: 720
Valid Values: Any integer from 20 to 525,600 (one year)
Changes Take Effect: Immediately for all new interactions submitted to URS
Specifies the timeout, in minutes, for any interaction to remain with URS
before its routing is considered a failure.
Universal Routing Server
Also known as URS. The server that is used by Universal Routing that automatically executes routing-strategy instructions and distributes incoming customer interactions among contact-center agents. Previously known as Interaction Router.
Glossary
handling-timeout
Section: settings
Default Value: 180
Valid Values: Any integer from 1 to 1,440 (24 hours)
Changes Take Effect: Immediately
Specifies the handling timeout (in minutes) for any interaction that an agent handles. If no requests
are received from the agent who handles the interaction during this time
interval, the agent application is considered inactive and the interaction is
revoked and returned to the queue. This option applies to requests between the
desktop application and Interaction Server only. Value changes do not affect interactions
that are already being handled.
The same option might be specified in interaction user data or media type options.
The first found option is taken into consideration with the following check order:
1. The value of the “handling-timeout” key in user data of an interaction.
2. The media type option “settings/ handling-timeout”.
3. This “handling-timeout” IXN Server option.
introduced-transfer-threshold
Section: gim-transformation
Default Value: 0
Valid Values: Any nonnegative integer
Changes Take Effect: At the next run of Job_TransformGIM
Dependencies: None
Introduced: 8.5.001
Specifies a time threshold, in seconds, for Genesys Info Mart to treat a conference as an introduced transfer. If the conference initiator's participation is less than the threshold, while the receiving agent continues on the call, Genesys Info Mart treats this call flow as a special case of transfer. The option applies only to voice calls.
Technical Descriptors
Understanding when interaction resource facts (IRFs) and mediation segment facts (MSFs) are created can help you to determine which types of interaction resources and mediation segments to include in, or exclude from, your queries. The TECHNICAL_DESCRIPTOR dimension is a combination of attributes — resource roles, role reasons, technical results, and technical result reasons — that describe how interactions arrive at and depart from resources.
This page describes the technical descriptor combinations that are applicable for IRFs and MSFs for voice and multimedia. Some technical descriptors apply only to IRFs, some apply only to MSFs, and some apply to both. Similarly, some technical descriptors apply only to voice interactions, some apply only to multimedia interactions, and some apply to both. Whether a particular resource role or technical result applies to IRFs or MSFs for various media types depends on the type of resource.
Resource Roles
The resource role of the interaction-handling or mediation resource depends on how the interaction arrives at the resource.
The Resource Roles table below describes the resource roles that Genesys Info Mart uses for resources that are the subjects of IRF or MSF records. Except where specified otherwise, all resource roles apply to both voice and multimedia interactions.
The number of potential resource roles for mediation resources is limited. For an ACD queue, virtual queue, multimedia interaction queue, or multimedia workbin, each row in the MSF table has a resource role of Received or ReceivedConsult.
For a list of the available combinations of resource roles with the other technical-descriptor attributes, see Technical Descriptor Combinations.
Resource Role | Description | Comments |
---|---|---|
DivertedTo | Denotes an interaction that was delivered to the resource via an ACD queue. | Applies to: IRF (voice)
A resource role of DivertedTo paired with a technical result of Conferenced indicates the initiator of a conference call. |
InConference | Denotes that the IRF was created for a resource as the result of a conference call in which the resource joined the conference. | Applies to: IRF
A resource role of InConference paired with a technical result of Conferenced indicates that, after joining the conference, the joining resource was the initiator of a subsequent conference. |
Initiated | Denotes that the resource in the IRF row initiated either an internal interaction or an outbound interaction. | Applies to: IRF
A resource role of Initiated paired with a technical result of Conferenced indicates that the resource initiated a call and was the initiator of a conference call. |
InitiatedConsult | In the separate IRF record that is created when an agent or IVR initiates a consultation, denotes that the subject of the IRF initiated the consultation. | Applies to: IRF
This resource role indicates that the subject of the IRF initiated a consultation, mute transfer, two-step transfer, or two-step conference to another resource. |
Puller | Denotes that the resource pulled the multimedia interaction from an Interaction Queue or Interaction Workbin. | Applies to: IRF (multimedia) |
Received | For IRFs, denotes that the resource received an inbound interaction without the benefit of prior distribution devices moving the call to it. This is typical for internal call types that are dialed directly to the resource. For MSFs, this resource role applies to all nonconsultation interactions that are received into a queue. | Applies to: IRF and MSF
A resource role of Received paired with a technical result of Conferenced in the IRF context indicates the initiator of a conference call. |
ReceivedConsult | Denotes that the IRF or MSF was created for a resource as the result of a consultation only (the resource did not receive a transfer, or was not joined into a conference). This enables counting of consultations that are received by a resource. | Applies to: IRF (voice and multimedia) and MSF (voice)
|
ReceivedTransfer | Denotes that the IRF was created as a result of the interaction being transferred to the IRF resource by a resource other than a nonself-service IVR, either directly or indirectly through an intermediate redirecting resource. | Applies to: IRF
A resource role of ReceivedTransfer paired with a technical result of Conferenced indicates the initiator of a conference call. For voice interactions, a resource role of ReceivedTransfer paired with a role reason of IntroducedTransfer indicates that an interaction that would otherwise appear as a conference qualified as an introduced transfer, as defined by the introduced-transfer-threshold configuration option. |
RedirectedTo | An interaction has been returned to the queue from which it was pulled.
Note: An IRF is created for a queue only if the interaction ended in the queue — for example, if the technical result was CustomerAbandoned. |
Applies to: IRF (multimedia)
An interaction is redirected back to a queue if:
|
RoutedTo | Denotes an interaction that was delivered to the resource via a routing point. | Applies to: IRF
For voice interactions, a resource role of RoutedTo paired with a technical result of Conferenced indicates the initiator of a conference call. |
Unknown | Genesys Info Mart does not have sufficient information to determine the resource role. | Applies to: IRF and MSF |
Technical Results
The technical result and technical result reason of the IRF or MSF depend on how the interaction leaves the resource.
The Technical Results table below describes the technical results and technical result reasons that Genesys Info Mart uses for resources that are the subjects of IRF or MSF records. Except where specified otherwise, all technical results and technical result reasons apply to both voice and multimedia interactions.
For a list of the available combinations of technical results with the other technical-descriptor attributes, see Technical Descriptor Combinations.
Technical Result | Result Reason | Comment |
---|---|---|
Abandoned | Denotes that processing of the interaction by the resource did not complete normally. | |
AbandonedWhileQueued | Applies to: IRF and MSF
The interaction was abandoned while in the queue. | |
Redirected | Applies to: IRF (voice) and MSF (voice)
In the IRF context, processing of the voice interaction by the resource that is the subject of the IRF row was abandoned, and the interaction was redirected to another resource. In the MSF context, processing of the voice interaction by a target handling resource was abandoned, and the interaction was redirected to another resource. | |
Rejected | Applies to: IRF (multimedia) and MSF (multimedia).
A handling resource, which was an agent (or a place), was invited into the interaction but rejected the invitation. As a result, processing of the interaction was abandoned. In the IRF context, the resource that rejected the invitation is the subject of the IRF record. In the MSF context, the resource that rejected the invitation is a target handling resource. | |
Revoked | Applies to: IRF (multimedia) and MSF (multimedia).
A handling resource, which was an agent (or a place), was invited into the interaction, but the invitation was revoked when the resource did not accept the invitation before the handling-timeout that is configured in Interaction Server. As a result, processing of the interaction was abandoned. In the IRF context, the resource that did not accept the invitation in time is the subject of the IRF record. In the MSF context, the resource that did not accept the invitation in time is a target handling resource. | |
Unspecified | Applies to: IRF and MSF
In MSF records with a resource role of ReceivedConsult:
| |
AbnormalStop | (Multimedia only)
Denotes that the interaction was stopped by an entity (for example, Interaction Server or a Media Server) that was not a party to the interaction, in situations in which no other technical result applies. For example, AbnormalStop would not apply if the Media Server stops the interaction with a reason system name of Abandoned, because the technical result of CustomerAbandoned would apply to that scenario. The STOP_ACTION field in the last IRF for the interaction is 0. | |
AbnormalStopWhileQueued | Applies to: IRF and MSF
The interaction was stopped while in the virtual queue, interaction queue, or workbin. | |
AbnormalStopWhileRinging | Applies to: IRF | |
Unspecified | Applies to: IRF and MSF | |
Cleared | Denotes that the interaction was cleared from a queue.
Applies to: MSF | |
DefaultRoutedByStrategy | (Virtual queues only)
The interaction was routed by URS to the default destination, as defined by the URS configuration options. | |
DefaultRoutedBySwitch | (Voice virtual queues only)
The switch default-routed the interaction. | |
PulledBack | (Multimedia only)
The routing strategy was unable to route the interaction successfully before the expiration of the routing-timeout that was configured in Interaction Server. As a result, the routing was considered to be a failure and the interaction was taken from the routing strategy and placed back into the interaction queue from which it came. | |
RoutedFromAnotherVQ | (Virtual queues only)
The interaction was added to this virtual queue as well as to a parallel virtual queue. It was routed from the parallel virtual queue to the target destination, and it was cleared from this virtual queue. | |
Stopped | (Multimedia only)
The interaction was stopped while in mediation, in situations in which neither CustomerAbandoned nor AbnormalStop applies. | |
StuckCall | (Virtual queues only)
An interaction that ICON identified as a stuck call was cleared from the virtual queue. (ICON determines that an interaction is stuck in a virtual queue if ICON received an event that indicates that the interaction entered the virtual queue, but ICON did not receive the event that indicates that the interaction exited the virtual queue, and URS has stopped sending status updates for that interaction.) Note: To calculate durations from virtual queue data accurately, Genesys recommends that rows that have this technical result and reason not be used. | |
Targets Cleared | (Virtual queues only)
The interaction was cleared from the virtual queue by the URS strategy Clear Target function. | |
Unspecified | For virtual queues, usually indicates that the interaction was cleared from the virtual queue because no target was found.
For ACD queues, usually indicates that the interaction was parallel queued and was not diverted from this ACD queue to another contact center resource. | |
Completed | Denotes that processing of the interaction by the resource completed normally.
Applies to: IRF | |
Archived | (Multimedia only)
The interaction was placed into an Interaction Queue that, based on the value of the completed-queues configuration option, Genesys Info Mart identifies as an archive queue for completed interactions. This Result Reason improves reporting in Genesys intelligent Workload Distribution (iWD) or other scenarios in which interactions are placed into “archiving” queues, instead of being terminated immediately after processing. | |
Canceled | (Multimedia only)
The interaction was placed into an Interaction Queue that, based on the value of the canceled-queues configuration option, Genesys Info Mart identifies as an archive queue for canceled interactions. This Result Reason improves reporting in iWD or other scenarios in which interactions are placed into “archiving” queues, instead of being terminated immediately after processing. | |
Unspecified | ||
Conferenced | Denotes that the interaction resulted in a conference.
See comments in the Resource Roles table, above, for the meaning of specific combinations of the Conferenced technical result with various resource roles. Applies to: IRF (voice) | |
Unspecified | ||
CustomerAbandoned | Denotes that the customer initiated termination of the interaction, or the strategy initiated termination while the customer was present.
Note: In order for Genesys Info Mart to report that a multimedia interaction has been abandoned by the customer, the Media Server must operate in compatibility mode (with the Chat Server stop-abandoned-interaction configuration option set to true). For the reason for this requirement, see Abandoned in the discussion of Multimedia Stop Reason system names. | |
AbandonedFromHold | Applies to: IRF (voice)
The handling resource placed the interaction on hold, and the customer abandoned the interaction. | |
AbandonedWhileQueued | Applies to: IRF and MSF
In MSF records, this technical result combination indicates that:
| |
AbandonedWhileRinging | Applies to: IRF | |
AnsweredByOther | Applies to: IRF (voice)
For interactions that end in a nonself-service IVR, this technical result combination indicates that the customer abandoned the interaction before service could be provided. | |
Unspecified | Applies to: IRF and MSF | |
Deferred | Denotes that the interaction was released because handling was deferred for some reason, not because it was abandoned by the customer. For example, the customer accepted a callback, instead of waiting on the line.
Applies to: IRF | |
CallbackAccepted | The customer accepted the callback offer. | |
DestinationBusy | Denotes that the interaction did not reach the target resource because the destination was busy.
Applies to: IRF (voice) | |
Unspecified | ||
Diverted | Denotes that the mediation resource diverted the interaction to a target resource.
Applies to: MSF | |
AbandonedWhileRinging | The interaction was abandoned before the target resource could answer it.
For voice interactions, the target was a handling resource (Agent, IVR or ACD position DN) that had a talk count = 0, and re-route on no answer (RONA) did not occur. | |
AbnormalStopWhileRinging | (Multimedia only)
Before the target resource answered, the interaction was stopped by an entity that was not a party to the interaction (for example, by a Media Server). | |
AnsweredByAgent | The target resource was an agent, and the agent answered the interaction.
For voice interactions, the target resource was an agent who had a talk count > 0. | |
AnsweredByOther | The target resource was not an agent, and it answered the interaction.
For multimedia interactions, the target resource was a place, but no agent was logged in to that place. For voice interactions, the target was a resource, other than an agent, that had a talk count > 0 (typically an IVR or ACD Position DN). | |
Redirected | The target resource did not answer the interaction; as a result, the interaction was routed to another resource.
For voice interactions, the target was a resource that was re-routed on no answer (RONA’d) or that forwarded the interaction elsewhere. | |
Rejected | (Multimedia only)
The target resource was an agent (or a place). The agent (or place) was invited into the interaction, but the invitation was rejected. As a result, the interaction is placed back into the interaction queue from which it came. | |
Revoked | (Multimedia only)
The target resource was an agent (or a place) that was invited into the interaction, but the invitation was not accepted before the delivering-timeout that was configured in Interaction Server. As a result, the interaction was placed back into the interaction queue from which it came. | |
RoutedToOther | The target was a mediation resource that was not the subject of the IRF. | |
RouteOnNoAnswer | (Voice only)
The target resource was an agent; the call rang at the handling resource, was not answered, and was deflected to another resource. | |
Unspecified | ||
Incomplete | Denotes that a callback media attempt did not complete successfully.
Applies to: IRF | |
Unspecified | ||
OutboundStopped | An outbound interaction was created and stopped without being sent.
Applies to: IRF (multimedia) | |
Unspecified | ||
Pulled | Denotes that the interaction was pulled from an Interaction Queue or Interaction Workbin.
Applies to MSF (Multimedia) | |
Unspecified | ||
Redirected | Denotes that an interaction was redirected to another resource.
Applies to: IRF | |
PulledBack | (Multimedia only)
The agent did not handle the interaction before the handling-timeout that is configured in Interaction Server. As a result, the interaction was placed back into the interaction queue from which it came. When paired with a resource role of InConference, identifies the uncommon scenario in which an agent who was invited into a chat conference became the only remaining agent in the chat (in other words, the inviting agent left the chat), and then the remaining agent left the chat abnormally (for example, because the agent logged out while the interaction was still open, or the agent’s desktop application terminated unexpectedly while the interaction was still open). As a result, Interaction Server pulled the interaction back from the agent and placed the interaction in a queue. | |
Rejected | (Multimedia only)
The target resource was an agent (or a place) that was invited into the interaction, but the invitation was rejected. As a result, the interaction was placed back into the interaction queue from which it came. | |
Revoked | (Multimedia only)
The target resource was an agent (or a place) that was invited into the interaction, but the invitation was not accepted before the delivering-timeout that was configured in Interaction Server. As a result, the interaction was placed back into the interaction queue from which it came. | |
RouteOnNoAnswer | (Voice only)
The interaction was diverted from an agent or IVR to another contact center resource as the result of a ring no answer. | |
Unspecified | For voice interactions, the interaction was diverted from an agent when forwarded to another resource, such as voice mail. | |
Transferred | Denotes that the resource completed a transfer of the interaction to another resource.
Applies to: IRF | |
IntroducedTransfer | (Voice only)
The transfer was actually accomplished via a short conference, during which the transferring agent introduced the customer to the receiving agent. The transferring agent (the subject of the IRF) then left the conference within the time limit specified by the introduced-transfer-threshold configuration option, while the receiving agent continued on the call. | |
Unspecified |