Emergency Alert Systems

AcsAPI Library Routines - Dialer and Line Setup

int ACSQueryDialerLines(const char * _campaign);

If _campaign is blank, this routine requests a list of all available lines.  If not, it returns the lines assigned to the campaign.  They are returned in “bursts” of up to 24 each, in the structure AcsApiDialerResponse, with an operation type of ACSAPI_OP_QUERY.  One last empty return of ACSAPI_OP_QUERYDONE indicates the end of the bursts.

struct AcsApiDialerResponse{ // ACS_RT_DIALER

    char campaign[7];

    int  operation;

    int  lines[24]; // ACSAPI_OP_QUERY

    int  numLines;

};

int ACSSetupDialer(const char * _campaign,

                   const char * _recordingsRootpath,

                   const int    _noanswerSeconds,

                   const int    _dialerConnectOn,

                   const int    _numLinesAllowed,

                   const int  * _linesAllowed);

This routine sets up the dialer.  There are four connection options:

ACSAPI_DC_VOICE       // dialer connect on positive voice

ACSAPI_DC_ANSWMACHINE        // on answering machine

ACSAPI_DC_BUSY        // on busy

ACSAPI_DC_NOANSWER    // on noanwser

This routine executes a minimum of two communications, so multiple returns may be received in an AcsApiDialerResponse structure (above), with the operation type ACSAPI_OP_ADD.

There is a 1024 limit to the number of lines that can be set.  Due to communications standards, they will be sent in bursts of 24 maximum, resulting in even more responses.