API & DOCS

My Account            

Used to get a report of all voice broadcasts in a given date range.

Use the Broadcast Report API to get voice broadcast results

API used to get a report of all voice broadcasts in a given date range.

📘

Base URL for Broadcast Report

https://secure.dialogtech.com/ibp_api.php

Parameter List

ParameterRequiredAcceptsMax LengthNotesUsage
actionYesString: report.broadcastn/aOnly accepts report.broadcast for Broadcast ReportDefines the API Call as "Broadcast Report" type
access_keyYesStringn/aAccess Key from the Key Manager within a DialogTech accountCredentials used for access to the API for a particular DialogTech account
secret_access_keyYesStringn/aSecret Access Key from the Key Manager within a DialogTech accountCredentials used for access to the API for a particular DialogTech account
start_dateYesDate8Date format should be YYYYMMDDDefines the start of the date-range for records to be returned from
end_dateYesDate8Date format should be YYYYMMDDDefines the end of the date-range for records to be returned from
formatNoxml - or csv3xml - XML format
csv - csv format
Determines the output format for the response, as either xml or csv
numberNoString: Unformatted Phone Numbern/aA number that was broadcasted to within the date range specifiedFilters the response to only return records where the Numer_Called matches the number provided.
broadcast_idNoBroadcast IDn/aBroadcast ID within the specified date range

Default is all broadcasts
Filters the response to only return records where the Broadcast_ID matches the broadcast_id provided.
typeNosurvo or basic or alln/asurvo - Only return records for Smart Broadcasts
basic - Only return records from basic audio broadcasts
all - Return records from all broadcats

This value is ignored if a broadcast_id is provided
Filters the response to only return records where the broadcast type matches the type provided.

Using this API

These code examples are meant to show a basic method of accessing DialogTech's bradcast.report API.

<?php
    /*
        Broadcast Report EX:
        This example will request a Broadcast 
    report. It will then create an html 
    table to display on the page with all 
    available Broadcast Report fields.
    */

    // Create cURL resource
    $ch = curl_init(); 
    $baseuri = "https://secure.dialogtech.com/ibp_api.php?";

    // API Specific Static Parameters
    $action = "report.broadcast";

    // Required User Parameters To Request the API
    $access_key = "foo";
    $secret_access_key = "bar";
    $start_date = "20170101";
    $end_date = "20170131";
    $broadcast_type = "all";
    $format = "csv";

    // Construct the full URL
    $full_url = $baseuri . "&action=" . $action .
        "&access_key=" . $access_key .
        "&secret_access_key=" . $secret_access_key .
        "&start_date=" . $start_date .
        "&end_date=" . $end_date .
        "&broadcast_type=" . $broadcast_type .
        "&format=" . $format;

    // Set the URL
    curl_setopt($ch, CURLOPT_URL, $full_url);

    // Sets the return options of the cURL to return the actual result from the curl request, and FALSE on failure
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

    // Sets the $output variable to the result of the curl
    $output = curl_exec($ch);

    // Close curl resource to free up system resources
    curl_close($ch);

    // Basic CSS for the table formatting
    $page_html = "<style>
    td
    {
        border-left:1px solid black;
        border-top:1px solid black;
        text-align:center;
    }
    table
    {
        border-right:1px solid black;
        border-bottom:1px solid black;
    }
</style>\n\n";


    // Create the table
    $table = "<table>\n";
    $rows = str_getcsv($output, "\n");

    foreach($rows as &$row) {
        // Add new row
        $table .= " <tr>\n";
        $cells = str_getcsv($row);

        foreach($cells as &$cell) {
            // Add a new cell
            $table .= "     <td>$cell</td>\n";
        }

        // Complete the new row
        $table .= " </tr>\n";
    }

    // Complete the table
    $table .= "</table>";

    // Echo the CSS and table on the page
    echo $page_html . $table;
?>
curl -X ""

Example Response

<?xml version='1.0' encoding='iso-8859-1'?>
<!DOCTYPE data [
  <!ELEMENT data (record+)>
  <!ELEMENT record (Scheduled_Time,Actual_Time,Delay_if_any,Number_Called,Result_of_Call,Response_ID,Broadcast_Parameters,Broadcast_ID)>
  <!ELEMENT Scheduled_Time (#PCDATA)>
  <!ELEMENT Actual_Time (#PCDATA)>
  <!ELEMENT Delay_if_any (#PCDATA)>
  <!ELEMENT Number_Called (#PCDATA)>
  <!ELEMENT Result_of_Call (#PCDATA)>
  <!ELEMENT Response_ID (#PCDATA)>
  <!ELEMENT Broadcast_Parameters (#PCDATA)>
  <!ELEMENT Broadcast_ID (#PCDATA)>
  ]>
<data>
    <record>
        <Scheduled_Time>2017-01-01 09:00:00</Scheduled_Time>
        <Actual_Time>2017-01-01 09:01:35</Actual_Time>
        <Delay_if_any>00:01:35</Delay_if_any>
        <Number_Called>8772955100</Number_Called>
        <Result_of_Call>Live Person</Result_of_Call>
        <Response_ID></Response_ID>
        <Broadcast_Parameters>12345</Broadcast_Parameters>
        <Broadcast_ID>01234567</Broadcast_ID>
    </record>
    <record>
        <Scheduled_Time>2017-01-02 09:00:00</Scheduled_Time>
        <Actual_Time>2017-01-01 09:01:20</Actual_Time>
        <Delay_if_any>00:01:20</Delay_if_any>
        <Number_Called>5556667777</Number_Called>
        <Result_of_Call>Live Person</Result_of_Call>
        <Response_ID></Response_ID>
        <Broadcast_Parameters>12345</Broadcast_Parameters>
        <Broadcast_ID>01234568</Broadcast_ID>
    </record>
    <record>
        <Scheduled_Time>2017-01-04 10:54:00</Scheduled_Time>
        <Actual_Time>2017-01-04 10:55:36</Actual_Time>
        <Delay_if_any>00:01:36</Delay_if_any>
        <Number_Called>7083725264</Number_Called>
        <Result_of_Call>Live Person</Result_of_Call>
        <Response_ID>2955551112</Response_ID>
        <Broadcast_Parameters>usr_survey_id=973214</Broadcast_Parameters>
        <Broadcast_ID>01234569</Broadcast_ID>
    </record>
</data>
"Scheduled_Time","Actual_Time","Delay_if_any","Number_Called","Result_of_Call","Response_ID","Broadcast_Parameters","Broadcast_ID"
"2017-01-01 09:00:00","2017-01-01 09:01:35","00:01:35","8772955100","Live Person","","12345","01234567"
"2017-01-02 09:00:00","2017-01-01 09:01:20","00:01:20","5556667777","Live Person","","12345","01234568"
"2017-03-01 10:54:00","2017-03-01 10:55:36","00:01:36","7083725264","Live Person","2955551112","usr_survey_id=973214","01234569"

Response Appendix

This is a list of each value returned by the Broadcast Report API and a simple description of what that value represents.

ParameterDescription
Scheduled_TimeThe time the call was scheduled to be broadcasted from DialogTech
Actual_TimeThe time the call was actually broadcasted from DialogTech
Delay_if_anyThe time DialogTech queued up the call and waited for the appropriate broadcast ports to become available
Number_CalledThe number that was broadcasted to
Result_of_CallThe result of DialogTech's Voicemail Detection which attempts to determine the difference between a Live Person and an Answering Machine
Response_IDA unique ID assigned to one call as part of a broadcast
Broadcast_ParametersA list of any user-generated parameters utilized as part of a smart broadcast
Broadcast_IDA unique ID assigned the entire broadcast