State (Dialog) Parameter Values

The following table describes possible values for the state (dialog) parameter for voice dialogs:

Dialog State

Description

INITIATING

Indicates that the phone is off the hook at a device

INITIATED

Indicates that the phone is dialing at the device

ALERTING

Indicates that the call is ringing at a device

ACTIVE

Indicates that the dialog has at least one active participant

FAILED

Indicates that the dialog has failed

DROPPED

Indicates that the dialog has no active participants

ACCEPTED

Indicates the user has accepted the OUTBOUND_PREVIEW dialog

Nonvoice States

The following table describes possible values for the state (dialog) parameter for nonvoice dialogs:

Dialog State

Description

OFFERED

Indicates that the dialog has been offered to a user

ACCEPTED

Indicates that the user has accepted the offered dialog

ACTIVE

Indicates that the dialog has at least one active participant; the user has started working on the accepted dialog

PAUSED

Indicates that an active dialog has been paused

WRAPPING_UP

Indicates that a user is performing wrap up activity for a dialog

INTERRUPTED

Indicates that the dialog has been interrupted by a dialog from another MRD. Dialogs can be interrupted if they are in the ACTIVE, PAUSED, or WRAPPING UP states.

While a dialog is interrupted, all actions for that dialog are disabled.

This state is applicable only for interruptible MRDs with the Media API interruptAction parameter set to ACCEPT.

CLOSED

Indicates that the dialog ended.

The disposition code indicates the reason the dialog closed. See Disposition Code Parameter Values for Nonvoice Tasks.

UNKNOWN

After Finesse server or PG failure recovery, any dialogs in the INTERRUPTED state change UNKNOWN state when the dialog is no longer interrupted.

For example, the following scenario results in a dialog in the UNKNOWN state:

  1. The user accepts and starts a dialog in an interruptible media.

  2. The user accepts and starts a dialog in a non-interruptible media.

  3. The dialog in the interruptible media changes to the INTERRUPTED state.

  4. The PG goes out of service.

  5. Both dialogs are recovered and are in the correct state.

  6. The user closes the dialog in the non-interruptible media.

  7. The dialog in the interruptible media changes to the UNKNOWN state.

When a dialog is in the UNKNOWN state, the user is only allowed to close the dialog.

The following figure illustrates these allowed state transitions for nonvoice dialogs: