From Bright Pattern Documentation
Jump to: navigation, search
(Created new topic from branched topic Documentation:ServicePattern:list-management-api-specification:Getallrecords:3.15)
 
 
Line 5: Line 5:
  
 
== URL ==
 
== URL ==
http[s]://<host>:<port>/admin/ws/t/
+
http[s]://<host>/admin/ws/t/<tenant_url>/callinglist/getAll/<list_name>/<campaign_name>
 
 
&lt;tenant_url&gt;/callinglist/getAll/&lt;list_name&gt;/&lt;campaign_name&gt;
 
  
 
== Method ==
 
== Method ==
Line 16: Line 14:
  
 
=== Example ===
 
=== Example ===
{|border="1" style="border-collapse:collapse" cellpadding="5"
+
{
|
+
        "fromIndex":"123456",
''{<br />
+
        "maxSize":"100"
        &quot;fromIndex&quot;:&quot;123456&quot;,<br />
+
}
        &quot;maxSize&quot;:&quot;100&quot;<br />
 
}''
 
|}
 
  
 
== Returns ==
 
== Returns ==
Line 33: Line 28:
  
 
=== Example ===
 
=== Example ===
{|border="1" style="border-collapse:collapse" cellpadding="5"
+
[
|
+
''[''
+
{
 
+
''{ ''
+
“index”:123000,
 
+
''“index”:123000,''
+
“entry”: {
 
+
        "fieldName_1":"value_1",
''“entry”: {<br />
+
        ...
        &quot;fieldName_1&quot;:&quot;value_1&quot;,<br />
+
        "fieldName_n":"value_n"
        ...<br />
+
        &quot;fieldName_n&quot;:&quot;value_n&quot;''
+
}
 
+
''}''
+
“status”: {
 
+
“completed”: <Boolean>, // Boolean true/false
''“status”: {<br />
+
“ lastDisposition” : <DispositionName>, // For completed records, final record disposition; otherwise, disposition of the last call attempt
“completed”: &lt;Boolean&gt;, // Boolean true/false<br />
+
“lastDate” : “2013-07-05T15:19:04.000” // Timestamp of the last call attempt (ISO 8601 format )
“ lastDisposition” : &lt;DispositionName&gt;, // For completed records, final record disposition; otherwise, disposition of the last call attempt<br />
+
“lastPhone” : <phone num> // Phone number used in the last call attempt
“lastDate” : “2013-07-05T15:19:04.000” // Timestamp of the last call attempt (ISO 8601 format )<br />
+
“lastCallDuration” : <sec> // Duration of the last call attempt
“lastPhone” : &lt;phone num&gt; // Phone number used in the last call attempt<br />
+
“lastAgent”: <login_id> // Username of the agent who handled the last call attempt if successful
“lastCallDuration” : &lt;sec&gt; // Duration of the last call attempt<br />
+
“totalAttempts”: <num> // Total number of call attempts made for the record
“lastAgent”: &lt;login_id&gt; // Username of the agent who handled the last call attempt if successful<br />
+
“totalAttempts”: &lt;num&gt; // Total number of call attempts made for the record''
+
}
 
+
},
''}<br />
+
},''
+
 
+
''''
+
]
 
 
'']''
 
|}
 
  
 
== Errors ==
 
== Errors ==
Line 77: Line 69:
  
  
<center>[[list-management-api-specification/Getupdatedrecords|< Previous]]  |  [[list-management-api-specification/AddrecordstoDNC|Next >]]</center>
+
 
 
</translate>
 
</translate>

Latest revision as of 23:19, 17 September 2018

• 3.10 • 3.11 • 3.12 • 3.13 • 3.14 • 3.15 • 3.16 • 3.17 • 3.18

Get all records

This returns all records of the specified calling list whose index is equal or greater than the specified number. Index is a record’s sequential number. Records are numbered in the order of insertion in the list starting from zero.

Time values are returned in the UTC time zone.

URL

http[s]://<host>/admin/ws/t/<tenant_url>/callinglist/getAll/<list_name>/<campaign_name>

Method

POST

Request body

Initial index and maximum size of returned list; current implementation limits the maximum size to 1000 records (content type: application/json)

Example

{
        "fromIndex":"123456",
        "maxSize":"100"
}

Returns

200 – Record content and its current status within the specified campaign.

Body

Record content and status (content type: application/json)

The status part contains the results of calling this record within the specified campaign. Field names in this part are predefined. The Completed field is always present, while other fields may be absent if the record was never attempted or never reached the agent.

Example

[

{

“index”:123000,

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

}

“status”: {
“completed”: <Boolean>, // Boolean true/false
“ lastDisposition” : <DispositionName>, // For completed records, final record disposition; otherwise, disposition of the last call attempt
“lastDate” : “2013-07-05T15:19:04.000” // Timestamp of the last call attempt (ISO 8601 format )
“lastPhone” : <phone num> // Phone number used in the last call attempt
“lastCallDuration” : <sec> // Duration of the last call attempt
“lastAgent”: <login_id> // Username of the agent who handled the last call attempt if successful
“totalAttempts”: <num> // Total number of call attempts made for the record

}
},

…

]

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 >