ADNOS, Dynamic Numbering
  1. User guide
    1. 1 Overview
    2. 2 Getting started
      1. 2.1 Connecting
      2. 2.2 A simple overlay
      3. 2.3 Moving an overlay
      4. 2.4 Canceling an overlay
      5. 2.5 Overlaying multiple numbers
      6. 2.6 What next
    3. 3 A more advanced overlay
      1. 3.1 Call announcements
      2. 3.2 Call recordings
      3. 3.3 Advertisers
      4. 3.4 Expiry options
        1. 3.4.1 Setting an expiry
        2. 3.4.2 Enforcing the expiry
        3. 3.4.3 The called extension
      5. 3.5 Restricting calls
        1. 3.5.1 Who can call
        2. 3.5.2 The length of calls
        3. 3.5.3 The number of calls
    4. 4 Advertisers functions
      1. 4.1 Create an advertiser
      2. 4.2 List advertisers
      3. 4.3 Edit an advertiser
    5. 5 Sound file functions
      1. 5.1 Pre-call anouncements
        1. 5.1.1 Create an announcement
        2. 5.1.2 List announcements
        3. 5.1.3 Edit an announcement
        4. 5.1.4 Delete an announcement
      2. 5.2 Call recordings
        1. 5.2.1 Get recordings
    6. 6 Statistical functions
      1. 6.1 Call statistics
        1. 6.1.1 Raw statistics
        2. 6.1.2 Grouped statistics
      2. 6.2 Overlay statistics
        1. 6.2.1 Count your overlays
        2. 6.2.2 List your overlays
      3. 6.3 Real time reporting
    7. 7 Miscellaneous functions
      1. 7.1 Check values
        1. 7.1.1 List number types
        2. 7.1.2 List number classes
        3. 7.1.3 Check a parameter
      2. 7.2 Check settings
        1. 7.2.1 Check your permissions
        2. 7.2.2 Check your settings
        3. 7.2.3 Check call costs
        4. 7.2.4 Check costs for a call
      3. 7.3 Check previous requests
        1. 7.3.1 Count previous requests
        2. 7.3.2 List previous requests
        3. 7.3.3 View request details
    8. 8 Glossary

3.1 Call announcements

Call announcements are recorded sound files played to the caller or callee before the start of a call. It is possible to play announcements to both parties, and for these announcements to be different if desired.

For more information about managing call announcements, see the sound file functions section of this guide. If you already have an anouncemnt on the ADNOS system then it can be used by specifying it in the overlay request. There are three parameters which can be used for this, use callerPreSoundFileID to play the file to the caller before connecting the call, callerPostSoundFileID to play the file to the caller after connecting the call or calleeSoundFileID to specify a file to be played to the recipient when answering the call.

Note, if the caller is dialing from a system which generates its own local dialtone, a pre-connect announcement may not be heard. For this reason we recommend using callerPostSoundFileID and not callerPreSoundFileID.

Example

We have uploaded two sound files to the ADNOS system. The first, with an ID of 126 states that 'calls may be recorded for training purposes', the second says 'this call was brought to you by advertisersite.net' and has an ID of 127. In addition to the usual overlay request, we send:

Note, while one party is listening to an announcement, the other party cannot be connected. For caller announcements this is not an issue, but while playing a callee anouncement the caller will continue to hear a ringing tone. If the announcement is too long, the caller may hang up before it is finished!

It is also possible to use an anouncement when a call cannot be connected. This is usually used in conjunction with the expiry or restriction options to explain that the overlay is not available at that time.

Example

An overlay is to be restricted such that it can only be called from 01234567890, we have uploaded a file which states "You do not have permission to call this number" which has ID 128, we send: