đź“–
API Documentation
  • About
  • Version History
  • Introduction
    • Account Setup
    • Platform Features
    • Mid Call Divert/Mid Call Conference
    • Call Whisper
    • Conferencing
    • Percentage Distribution Algorthm
    • Call Queueing
    • Call Recording
    • Outbound Call
    • IVR Voicemail Retrieval Telephone Service
    • IVR Service Switcher Telephone Service
    • Web Service Security
    • Web Service Definition Language
      • Using a development environment other than the .NET Platform
    • Web Service Error Handling
    • Real-Time Multi-leg Call Data Records
      • Pseudo Code
      • Real-Time Multi-Leg CDR Call Types
    • Status Code Table
    • Default Audio
    • Development Guidelines
      • Development LAB Platform Test Harness
    • Post Call
    • DTMF Controlling Party
    • Data Rentention Policy
    • API Availability
    • Dynamic Call Agent (DCA)
      • Status Code Table
      • Call Outcome Table
      • Call Status Table
      • IVR Dynamic Call Agent Service
      • Apology Modes
    • JSON API
    • Emails
      • Custom Email Settings
      • Not Receiving Emails
      • Global Email Variables
      • Using Custom Service Variables within your emails
      • Email Content Type
      • Email Address HTML encoding
    • TimeZone Offset Setting
      • TimeZone Offset Table
      • Daylight Saving Time Changes
    • Public IP Addresses
    • Default Email Settings
    • Scheduled Call Feature
      • How to create a Scheduled Call request
      • What CLI be presented to the called parties
      • How to check the progress of a Scheduled Call request
      • How to retrieve the call statistics for my Scheduled Calls
      • How to delete a queued Scheduled Call request
      • How many simultaneous Scheduled Calls can be in progress
      • How many Scheduled Call requests can be created
  • Service Creation
    • Node XML structure
    • Service XML structure
    • Custom Service Variables
    • Variable Scope
    • Node Security
    • Graphical Representation of a Sample Service
    • Sample Service XML
    • Sub Plans
    • Sub Plan Example XML
  • Web Service Authentication
  • Service Audio
  • Node Reference
    • Start
    • Page 1
  • Security Methods
  • Service Management Methods
  • Audio Management Methods
  • General Methods
  • File Management Methods
  • Real-Time Data Methods
  • Service Number Activation Methods
  • Number Group Methods
  • Account Methods
  • Payphone Barring
  • Dynamic Call Agent Methods
  • Tiff to Fax Methods
  • Call Barring Methods
  • Platform Logging Methods
  • Platform Logging
  • Data Tables
  • Scheduled Call
  • External Number Management Methods
  • Phone Book Management Methods
  • Origin List Management Methods
  • Private SIP Management Methods
  • Bulk Configuration
  • Appendix
Powered by GitBook
On this page

Was this helpful?

  1. Introduction

Percentage Distribution Algorthm

A node with a percentage distribution mode distributes passes through the node in a specified proportion.

The percentage distribution calculation occurs each time a call passes through the distribution algorithm and it is based on the number of calls that have passed though the node since it was configured

Initially flow is passed to each configured percentage item in order of decreasing percentage value.

Subsequent passes are allocated according to the configured percentages.

For example, having 4 configured percentage items of 15%, 20%, 30% and 35%, after 16 passes the platform would have the following table stored for the Node:-

Configured Percentage

Pass Count

Current Percentage

Weight

15

2

12.5

-2.5

30

5

31.25

1.25

20

3

18.75

-1.25

35

6

37.5

2.5

The “Pass Count” column represents the number of times the flow has passed through that percentage item since the node was configured.

The “Weight” column calculation is the “Current Percentage” minus the “Configured Percentage”

Each time a call is presented to the distribution algorithm, it uses the table above to select the percentage item with the lowest value in the “Weight” column then increments the “Pass Count” for that item. In the example above the next pass would select the 15% item increasing the Pass Count from 2 to 3 resulting in the following table:-

Configured Percentage

Pass Count

Current Percentage

Weight

15

3

17.64705882

2.647059

30

5

29.41176471

-0.58824

20

3

17.64705882

-2.35294

35

6

35.29411765

0.294118

The next pass would select the 20% item as this now has the lowest value in the “Weight” column. The table would then be updated as follows:-

Configured Percentage

Pass Count

Current Percentage

Weight

15

3

16.66666667

1.666667

30

5

27.77777778

-2.22222

20

4

22.22222222

2.222222

35

6

33.33333333

-1.66667

The next pass would then select the 30% and so on…..

In the event of two or more percentage items having the same “Weight” value, the item with the highest configured percentage is selected.

Scope

Global

The Pass Count represents all inbound calls that have passed through the Node since it was last configured. The Pass Count is reset to zero when the percentage configuration is changed. This option should be used when you want to apply percentage distribution to all inbound calls to a service.

Call

The Pass Count is reset to zero for each inbound call that passes through the Node. The percentage calculation is isolated to an individual inbound call.

PreviousConferencingNextCall Queueing

Last updated 1 year ago

Was this helpful?