AVANSER API Services Quick Reference Summary

AVANSER API Services Quick Reference Summary


The Objective of this document is to outline the various APIs AVANSER offers for both collection of data and remote service interaction.

Individual documentation for all APIs is available in the table below:



Telco API

Enables the customer to provision and maintain numbers through a restful API.


HTTP Callback

HTTP url is called upon call completion providing all required information for that call.


SMS Forward

HTTP url is called upon receiving an sms from an sms enabled number.



A restful API for reporting purposes, reports the call data according to request parameters.



Restful ApI designed to interact with our system "as a user" allowing integration with 3rd party services providing a framework for integration.



ARTIC API allows customer to retrieve all ARTIC data via the ARTIC Reporting API and perform Agent operations using the ARTIC Actions API


Data Feed

Custom JSON/XML/CSV feed API, "feed" urls are provided for remote systems to download the most recent data set.

This integration is currently available for call records only, example json and csv examples are provided with this document. Due to the custom nature of the integration

a dedicated document is required.

Number Provisioning

Through the TelcoAPI it is possible to create services in the AVANSER System.

The Telco API is designed to automate the process of managing client number inventory.
Once the numbers are assigned to a client’s private pool of numbers, the client will be able to:

  • List their available numbers.

  • Configure a new service.

  • Update an existing service.

  • Decommission an existing service.

An important feature of the Telco API is the "Custom ID" and "Custom Group". These two IDs are available for the client to set at the number level and will automatically populate each call with the applicable value. AVANSER Reporting APIs will then report the values for each call record that the client retrieves.

The Telco API uses HTTP Basic Authentication over Secure Socket Layer (HTTPS).

It has an asynchronous model to submit the requests:

  1. Submit the request with an HTTP callback URL.

  2. Callback URL is called when the request is completed.

  3. Request status can also be polled via a dedicated API request.

It allows the client to create the following service types:

  1. VoiceMail: A recording is played to the caller, after which they can leave a voice message.

  2. Prompt: A recording is played to the caller. Is generally used for notification purposes.

  3. Transfer: The answer point phone the call is transferred to.

  4. Additional service features are available upon request.

Each Service Type can be configured with the following options:

  • Email and SMS Notifications: Emails and/or SMS are sent to the desired recipients depending on call status (refer to API reference document).

  • HTTP Call Back: A URL is called each time a call is completed.

  • SMS Forward: A URL is called each time an sms is received - Requires a Virtual Mobile Tracking Number.

Provisioning Model

This is the model that is currently implemented, with orange numbers denoting processes at the client’s side and blue numbers processes at AVANSER's side.
  1. A NEW AD is requested and a NEW NUMBER REQUEST is submitted to the AVANSER Telco API. This request specifies both "custom_id" and "custom_group" for attribution purposes.

  2. The number selected from the available number list is returned in real-time.

  3. The AVANSER System configures the service on the phone network.

  4. The AVANSER System reports the service has been configured. On average it takes 7 minutes for the change to propagate to all servers of AVANSER's Network.

  5. A test call is automatically conducted and the data sent via HTTP Callback. (Requires Subscription)

  6. Client receives the data.

  7. Ad Number is live.


Call Data reporting is available via through the following methods:
  • HTTP Callback: URI reporting method which is configured autonomously via the Telco API. This method calls a URL for every call received by the AVANSER system. 

  • Data Feed URL that provides the Client with the most recent data according to a predefined format. For example calls can be reported by year, month, day but also calling number, call status, custom_id and custom_group. Feeds are available in CSV, JSON and XML format. 

  • WebAPI to build the Client’s own request parameters and get the results in JSON and XML format. Rate limits apply.

  • ARTIC API to fetch ARTIC Call Center data similarly to the WebAPI but with in-depth access to call center specific reporting.

Reporting Model

  1. AVANSER System receives a call.

  2. AVANSER connects the caller to the desired answering number.

  3. Call completes.

  4. AVANSER system reports depending on the configuration.

  5. Data is ready for the client to use.

HTTP Callback

AVANSER can will send an HTTP Callback to the customer as soon as the call is completed and the Post-Call processing is done. HTTP Callback can be configured automatically via the TelcoAPI or manually through the AVANSER Portal.

An example HTTP Callback URL is as follows:


Query Parameter








Unique Call ID



Unique Call Tag



Tracking Number - This is the number activated through the API or through our Support



Tracking Number Name - Friendly name assigned to the Tracking Number



Answer Point Number - This is the number you requested the calls to be transfered



Answer Point Name - Friendly name assigned to the Answer Point Number



Caller Party - This is the number of the Caller Party, your clients' customer number - ANI : Automatic Number Identification.



Date with timezone



Call Duration



Call Status



Call Status Code



Caller Location



Caller State



Caller Country



custom_id, managed by the Telco API



custom_group, managed by the Telco API

Tags are replaced with the relevant values from the call data.

HTTP Callback: Full Parameter List






Unique for each account



Unique for each call

Call Status


Descriptive text of the call status

Call status code


Call status code 0,1,2,3,4,7,8

Avanser's UniqueId


Unique id for each call

adSource Name


As configured in the Portal

Avanser's Bnum


Service Tracking Number (format +CC-LOCAL)

Call duration


Call Duration in seconds

Unixtime, now


Unix timestamp of the call

ISO 8601 date


ISO 8601 format string

Call Date (d/m/Y)


day/month/year format

Call Date (seconds)


UTC timestamp of the call

Calling number


Calling Number (format +CC-LOCAL) or "Private"

Target number


Answer Point the call was sent to

Call location


Detected call location

Call state


Detected call state

Call country


Detected call country

Target name


Answer Point name as configured in the Portal

Call label


Call Label set through the dialler

Call parameter #1


Feature Tracking: Feature value

Feature #1


Feature Tracking: Feature1 name

Call parameter #2


Feature Tracking: Feature value

Feature #2


Feature Tracking: Feature1 name

Call parameter #3


Feature Tracking: Feature value

Feature #3


Feature Tracking: Feature1 name

Call parameter #4


Feature Tracking: Feature value

Feature #4


Feature Tracking: Feature1 name

Call parameter #5


Feature Tracking: Feature value

Feature #5


Feature Tracking: Feature1 name

Call parameter #6


Feature Tracking: Feature value

Feature #6


Feature Tracking: Feature1 name

Call parameter #7


Feature Tracking: Feature value

Feature #7


Feature Tracking: Feature1 name

Call parameter #8


Feature Tracking: Feature value

Feature #8


Feature Tracking: Feature1 name

Call parameter #9


Feature Tracking: Feature value

Feature #9


Feature Tracking: Feature1 name

Call parameter #10


Feature Tracking: Feature value

Feature #10


Feature Tracking: Feature1 name

IVR Selections


IVR selections

User's visited page


Dynamic Numbers: website hit

Search Source


Dynamic Numbers: source

Search Medium


Dynamic Numbers: medium

Search Keywords


Dynamic Numbers: keywords

Search Campaign


Dynamic Numbers: campaign

Web, location


Dynamic Numbers: user's location

Web, state


Dynamic Numbers: user's state

Web, country


Dynamic Numbers: user's country

GA User Code


Google Analytics: User Code

GA Session Code


Google Analytics: Session Code

GA Client Id


Google Analytics: Client ID

Google Click Id


Google Analytics: Click ID

Downloadable Audio URL


Audio download url

A-Party E.164 Phone


Caller/Callee Number E164 format

A-Party State


Caller/Callee Number state 

A-Party Country


Caller/Callee Number country 

B-Party E.164 Phone


Service Number E164 format

C-Party E.164 Phone


Caller/Callee Number E164 format

C-Party Country


Caller/Callee Number country 

Call Disposition



UTC Date


UTC call timestamp

Call Direction


Call Direction, call-in or call-out

Sentiment Score


Sentiment Analysis: summary score

Agent Sentiment


Sentiment Analysis: agent score

Caller Sentiment


Sentiment Analysis: caller score

Talk Most


Sentiment Analysis: who talked the most



Sentiment Analysis: communication score



Sentiment Analysis: conduct score

Agent Politeness


Sentiment Analysis: agent politeness score

High Risk Call


Sentiment Analysis: call marked as high risk

Call Attitude


Sentiment Analysis: bad agent attitude detected

Slang Used


Sentiment Analysis: slang was used

Profanity Used


Sentiment Analysis: profanities were used

Data Feeds

Data feeds are static feeds that can be called and cached as desired. The default configuration sets the feed as a "catch-all" for all call records and organises them in a structured manner. The feeds can be accessed via HTTPS request and HTTP Basic Authentication can be enabled to access such data as well as call recording data.

Multiple methods of authentication can be configured:

  • IP Address Whitelisting.

  • Static HTTP Basic password.

  • HTTP Digest (available on request, scoping is required).

Data output can be customised to match the Client’s specific needs.

Below is an example of the data returned by AVANSER’s standard feed. Data is aggregated by Year, Month and Day.


call_audio_url: "",call_connection_duration: 1,call_direction: "call-in",

call_duration: 17,call_end_time: "2020-05-26 17:00:18",call_has_audio: 0,

call_id: 67643772,call_is_artic: 0,call_local_time: "2020-05-26 17:00:01",

call_param_0[1-7]: 0,call_param_08: "",call_param_09: "",call_start_time: "2020-05-26 17:00:01",

call_status: "Missed",call_status_code: 1,call_talk_duration: 16,

call_timezone: "Australia/Sydney",call_tz_end_time: "2020-05-26T17:00:18+1000",

call_tz_start_time: "2020-05-26T17:00:01+1000",call_u_end_time: 1590476418,

call_u_start_time: 1590476401,call_unique_id: "ECS8-1590476401.423578",

caller_country: "AU",caller_location: "Sydney",caller_number: "+61-0290088888",caller_state: "NSW",

client_id: 5995,

custom_group: "",custom_id: "",

private_reference: null,

target_name: "Target Name",target_number: "+61-0289995916",

tracking_master_id: 0,tracking_name: "Tracking Service Name",tracking_notes: "",

tracking_number: "+61-0289996235",tracking_wpc_id: 0


Data feeds can be set up concurrently with other reporting methods (HTTP Callback/Web API). AVANSER recommends the download and storing of the dudata at Client’s side to ensure a quicker response on larger data sets. Data feeds are available in JSON, CSV and XML format.
Highlighted in blue are the custom_id and custom_group which are to be used for attribution at the Client’s side.

Data feeds can be automatically uploaded to a desired destination on a daily basis.

Number Inventory

When managing an inventory of numbers there are some guidelines that AVANSER suggests be followed when it comes to number recycling and handling of the number inventory.

For regular clients AVANSER automatically handles the inventory, ensuring that any numbers made available for provisioning have already passed rigorous quarantine procedures. This incorporates checks to determine that the number is no longer "noisy".

A “noisy” number is a number that still receives calls for the previous owner after it has been cancelled. Only numbers that have been proven not to still be receiving calls for the previous owner are released to the public number pool. This process usually takes from three to six months.

For use cases that involve a large quantity of numbers (1000+), the public pool may be insufficient to guarantee the numbers are always available in the quantity required. Therefore an alternative solution is available.

AVANSER can provide a "Private Inventory", configured with its own customised rules which can be tailored to suit the Client’s business rules. This will not only ensure availability of numbers in the quantity required, but also allow the Client to choose when and how to safely recycle the numbers. These rules must be defined by the Client and discussed before the Inventory can be made available. They can be fully automated to minimise inventory maintenance and the Telco API can be customised to allow for recycling of a number upon request.

Once the Client and AVANSER agree on the exact volume of numbers required, AVANSER will assist in determining the size of the inventory and will provide feedback on ways to optimise the number usage to reduce inventory bloat and cost.

    • Related Articles

    • AVANSER Telco API - Product Outline and Examples

      Understanding AVANSER number stock When automating number provisioning it is important to know your inventory configuration. Your inventory is managed by Country; each Country has different number classes available for your tracking needs. Number ...
    • AVANSER API and Third Party Integration

      There are two main ways to integrate with 3rd Party APIs: 1. WebAPI: The documentation is available here: https://avanserwebapi.docs.apiary.io/ Test system information: The test environment isavailable at https://api.test.avanser.com/JSON/ 2. HTTP ...
    • Reports: Call Log - Filters and Data Access

      The Call Log is the list of all calls received on your tracking numbers for the selected period. Viewing the data The standard view for the call log provides a list of call details. It can be customised as per requirements (see Personalising Fields ...
    • Call Evaluation Overview

      Call evaluation tool allows businesses to rate all calls and give insight into the content of calls. You will have tangible evidence on which key areas need improvement and what your clients are calling about.  This tool provides the user with the ...
    • Tracking Numbers - Mini Management Tool

      A core concept within the AVANSER Call Tracking system is the Tracking Number. A Tracking Number is provisioned by AVANSER for use within online or offline advertising spaces. Tracking Numbers need to be assigned a call endpoint or routing steps to ...