Jump to: navigation, search

Call Stages

Call flows are built with various stages. The supported stages within Channel Monitoring are:

  • Start Call
  • Receive Media
  • Send DTMF Tone
  • Send Media
  • Wait for Agent
  • Wait
  • End Call
Important
Every call flow must begin with a Start Call stage and finish with an End Call stage. All other stages are optional, and can be added to the call flow in any order to build the call flow required for testing a specific path through the IVR application. The call stages and their properties are detailed in the sections below.

Start Call Stage

Registers the SIP account and initializes the call. This must be the first stage of every call flow.

Properties:

  • Destination (required):
    • The destination DN and ip address of the system under test
    • Required Format: "DN@ipaddress"
  • Caller User (required).
    • The DN that will be used to place the call from Channel Monitoring
    • Required Format: “DN@ipaddress”
  • Caller Password (required)
    • The password for the calling DN
  • DTMF Method (required)
    • The method that will be used for sending DTMF tones with this call flow
    • Possible Options:
      • RTP: As defined in RFC 4733
      • SIP INFO:Sends the tones using out-of-band SIP INFO messages
      • INBAND: Audio tones are sent in the RTP stream
      • Auto: Uses RTP DTMF, and if not available, uses INBAND DTMF
  • Start Call Timeout
    • The timeout in seconds for the initialization of the call. This value can be any positive integer. If no value is entered, or the specified value is not in the correct format, the default value of 30 seconds is used.

Receive Media Stage

Listens for media to be sent from the System Under Test. The media that will be selected for this stage must be uploaded through the media upload page. See the Upload Media section for additional details.

Properties:

  • Media Category (required)
    • The user-defined category to filter the media. This is created when a media file is uploaded to the system and is used for organizing the files.
  • Media To Receive (required)
    • The media that is expected to be sent by the System Under Test
  • Receive Timeout (required)
    • The timeout in msec. If media is not received from the System Under Test before this time elapses, then the call fails and, if configured, an alert is raised.
  • Receiving Duration (optional)
    • The duration in milliseconds of the length of the media to be received. If no value is specified, then the length of the selected media file is used.
Important
Please read the Stages and Media Files section for important information about ongoing maintenance.

Send DTMF Tone Stage

Sends a DTMF tone to the System Under Test.

Properties:

  • DTMF Tone Sequence (required)
    • The sequence of digits/tones that will be sent to the System Under Test.
    • Required Format: at least one digit but a sequence of digits can be specified. For example: 112233

Send Media Stage

Sends media to the System Under Test. The media that will be selected for this stage must be uploaded through the media upload page. See the “Upload Media” section for additional details.

Properties:

  • Media Category (required)
    • The user-defined category to filter the media. This is created when a media file is uploaded to the system and is used for organizing the files.
  • Media To Send (required)
    • The media that is to be sent by the test call
  • Sending Duration (optional)
    • The duration in seconds of the media that will be sent to the call. If no value is specified, then the file is played in its entirety.
Important
Please read the Stages and Media Files section for important information about ongoing maintenance.

Wait for an Agent Stage

Waits for a response from an agent and records the length of time before connecting with an agent. The stage can be configured to accept a connection from any agent or from a white-list of appropriate contacts.

  • Wait for Agent Timeout:
    • Max time in minutes to wait for connecting to an agent. If this max time is exceeded, the call fails and, if configured, an alert is raised.
    • This value must be an integer. If no value is entered, or the specified value is not in the correct format, the default value of 5 minutes is used.
  • Agents: (optional)
    • The list of agent DN’s that will determine the success of a transfer if a connection is made to any agent in the list.
    • If the list is left blank, the success of the transfer is determined by a connection to any agent in the environment.
    • Required Format:
      • If transfers from your routing strategy to the agent are using a “Refer” message, the agents should be listed as:
        • DN@agentIpAddress
      • If transfers from your routing strategy to the agent are completed via a “Re-Invite,” the agents should be listed as:
        • agentIpAddress
    • If you are not sure which transfer method is used, you can include entries for both “Refer” and “Re-Invite” transfer formats, and Channel Monitoring will accept both formats.

Wait Stage

Waits for a specified period of time before proceeding to the next stage of the call flow.

Properties:

  • Wait Duration: (required)
    • The time in seconds for the stage to wait

End Call Stage

Terminates the call when the call flow reaches this stage. This stage is required as the final stage for all call flows.

Properties: None

Stages and Media Files

Before executing a call, Channel Monitoring extracts the required audio files from the database and stores them on a directory located in the <workbench Installation directory>/cm_cache path. These audio files are the ones configured on the Send Media and Receive Media stages.

Important
In time, the directory can grow if there are a high number of different media files and call flows. Genesys recommends that users periodically check this directory and delete all of its contents if space is needed. This is a safe operation as long as no call flow that needs one of these audio files is being executed at the same time as the deletion.

Feedback

Comment on this article:

blog comments powered by Disqus
This page was last modified on 30 May 2017, at 11:39.