Search
Close this search box.

< / >

APIs

7. Real time reporting of campaigns

URL:

https://wv{{wolkvox_server}}.wolkvox.com/api/v2/real_time.php?api=campaigns

Description:

This report provides a complete real-time view of campaign management, providing information on contactability, status, penetration and other functional information for campaign management.

Benefit:

This report allows you to measure the quality of your campaigns according to standardized metrics.

How it works:

  • The consumption of this API is done by GET method.
  • To consume this API you must replace in the url {{{wolkvox_server}} by the nomenclature of the server of the operation.
  • The wolkvox-token header must be used to make use of the authorization token.
  • Note that the same token cannot be consumed simultaneously, so you can schedule the next API to be consumed when the result of the previous one is successful.
  • In terms of time, to keep track of your operation you can make a consumption every 5 minutes of the information.
  • Limit of records that can be downloaded per consumption: 60,000 records.
  • Limit of records that can be uploaded per consumption: 10,000 records.
  • Limit of days queried in dates: 31 days.
  • Limit of result weight: 256 MB.
  • API consumption time limit: 60 seconds.
  • Concurrent consumption limit of a token: 2 simultaneous requests.
  • Daily limit of tokens: Number of licenses multiplied by 1000 daily tokens.

Request

NAME DESCRIPTION TYPE
api Type of report required String

Response

NAME DESCRIPTION TYPE
campaign Displays information on campaign id, name and dialing percentage by phone String
speed Refers to the speed of the campaign String
status Details the campaign’s status. It can show “started” when it’s running or “stopped” when it’s halted. String
skill_id Indicates the number of skill linked to the campaign String
records Total number of registrations in the campaign String
clean Number of uncalled records String
dial Number of marked records String
answer Indicates the number of records answered String
no_answer Indicates the number of unanswered records String
busy/congestion/failed Refers to the number of records in “busy”, “congestion”, and “failed”. String
answer_machine Results of machine records String
penetration_day Campaign day penetration String
penetration_now Penetration of the momentum at the time of campaign consumption String
hits Indicates the number of records typified as “hits”. String
calls_x_min Calls per minute in the campaign String
recycled Number of times the campaign has been recycled String
Possible response codes

RESPONSE

				
					[
        {
            "campaign": "",
            "speed": "",
            "status": "",
            "skill_id": "",
            "records": "",
            "clean": "",
            "dial": "",
            "answer": "",
            "no_answer": "",
            "busy/congestion/failed": "",
            "answer_machine": "",
            "penetration_day": "",
            "penetration_now": "",
            "hits": "",
            "calls_x_min": "",
            "recycled": ""
        } 
]
				
			
We use cookies, if you continue browsing we will assume that you agree. You can read more about the use of cookies in our privacy policies and treatment of personal data