From Bright Pattern Documentation
< 3.16:List-management-api-specification
Revision as of 21:36, 5 June 2017 by Tracy (talk | contribs) (Created new topic from branched topic Documentation:ServicePattern:list-management-api-specification:Getupdatedrecords:3.15)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
• 3.10 • 3.11 • 3.12 • 3.13 • 3.14 • 3.15 • 3.16 • 3.17 • 3.18

Get updated records

This returns records of the specified calling list that have had any activity within the specified campaign since the specified date and time.

Time values are returned in the UTC time zone.

URL

http[s]://<host>:<port>/admin/ws/t/

<tenant_url>/callinglist/getChanged/<list_name>/<campaign_name>

Method

POST

Request body

Initial time in ISO format and maximum size of returned list; current implementation limits maximum size to 1000 records (content type: application/json)

Example

{
        "fromTime":"2013-03-01T13:15:06.456",
        "maxSize":"100"
}

Returns

200 – Content and detailed results of records updated within the specified campaign

Body

Content and details of call attempts of all records updated since the specified time (content type: application/json). The attempts part contains the attempts results in a format similar to the one used for detailed campaign result export. For more information, see the Reporting Reference Guide, section Campaign Results. Attempts are sorted by time, starting from the most recent one.

Example

{

“entry”: {
        "fieldName_1":"value_1",
        ...
        "fieldName_n":"value_n"

}

“completed”: false,
“recordDisposition” : <DispositionName>, // Record disposition name
“recordDispositionCode”:99,
“totalAttempts”: <num> // Total number of call attempts made for the record.

“attempts”: [
{
“call_attempted”:<true/false>, // Indication of whether there was an attempt to dial any of the record numbers, some actions like adding number to DNC are not actual call attempts
“ disposition” : <DispositionName>, // Call attempt disposition
“dispositionCode” : 88,
“date” : “2013-07-05T15:19:04.000”, // Date of call attempt
“phone” : <phone num>, // Phone number used in this attempt
“callNotes”: <text>, // Call notes provided by the agent for this call attempt if successful
“agent”: <login_id>, // Username of the agent who handled this call attempt if successful
“CPAResult”:<CPA result name>, // Result of call progress analysis
“dialingDuration”: <sec>, // Duration of dialing from initiation of the attempt till network signaling reported the call as answered
“CPADuration”: <sec>, // Duration of call progress analysis from the network answer signal till the decision about the type of answer
“callDuration” : <sec> // Duration of call from detection of live voice till call termination.
},

]
},

]

Errors

400 – Bad request (missing mandatory fields or incorrect format)

401 – Authentication failed

403 – Authentication succeeded, but authorization failed (no privileges)

404 – Calling list is not found, or campaign is not found, or URL is invalid



< Previous | Next >
< Previous | Next >