MOR API autodialer get campaign statistics

From Kolmisoft Wiki
Jump to navigationJump to search

Description

Retrieves autodialer campaingn statistics for selected time period.

Usage

  • From MOR X16: /api/autodialer_get_campaign_statistics



Parameters

Parameters which are included into hash:

  • u - User ID or Username in database
  • id - Caimpaign ID in database
  • period_start - Unix timestamp of stats period starting date. (Default: Today at 00:00).
  • period_end - Unix timestamp of stats period end date. (Default: Today at 23:59).

Note that parameters are shown in the same order as they have to be when generating the hash. Last parameter in a row is API_Secret_Key

Parameters which are not included into hash:


Request

If you want to get campaign statistics for admin, for campaign ID 2 from 06/01/2020 to 06/30/2020 and your API Secret Key = 456789

You send: 

HTML POST:  http://<SERVER_IP>/billing/api/autodialer_get_campaign_statistics?u=admin&id=2&period_start=1590969600&period_end=1593475200&hash=7f544a3f199563efce4dc5da5425cdd0d7a41999



Returns

Success: Everything is ok. You get the list of calls if there is any: 


<?xml version="1.0" encoding="UTF-8"?>
<page>
 <status>
   <campaign_name>Campaign Nr 2</campaign_name>
   <campaign_statistics>
     <period>
       <period_start>2020-06-01 03:00:00</period_start>
       <period_end>2020-06-30 03:00:00</period_end>
     </period>
     <total_numbers>2</total_numbers>
     <failed>1</failed>
     <completed>0</completed>
     <total_call_time></total_call_time>
     <total_call_time_longer_than_10s></total_call_time_longer_than_10s>
     <answered>
       <answered_calls>4</answered_calls>
       <answered_percent>40%</answered_percent>
     </answered>
     <no_answer>
       <no_answer_calls>3</no_answer_calls>
       <no_answer_percent>30%</no_answer_percent>
     </no_answer>
     <busy>
       <busy_calls>2</busy_calls>
       <busy_percent>20%</busy_percent>
     </busy>
     <failed>
       <failed_calls>1</failed_calls>
       <failed_percent>10%</failed_percent>
     </failed>
     <all_calls>
       <all_calls>10</all_calls>
       <all_calls_percent>100%</all_calls_percent>
     </all_calls>
   </campaign_statistics>
 </status>
</page>

Errors:

  • <error>Incorrect hash</error> - Hash was not correct. Check API_Secret_Key and order or params while concatenating hash_string.
  • <error>Access Denied</error> - Such username does not exist in the database or it was not specified.
  • <error>Campaign was not found</error> - Such Campaign ID does not exist in the database.
  • <error>Campaign does not have any Numbers</error> - Selected Campaign does not have any Numbers.
  • <error>Campaign does not have any Calls in selected time period</error> - Selected Campaign does not have any calls in selected period.
  • <error>Date from is greater than date till</error> - Date from is greater than date till

See also

Retrieved from "https://wiki.kolmisoft.com/index.php?title=MOR_API_autodialer_get_campaign_statistics&oldid=25649"