GET

The POST and GET methods return a URL in the location header of a successful create response. This URL is used to poll the task request status.

When you send a poll request, the "estimatedWaitTime" is returned only if the contact state is Queued. The "taskID" and "agentID" are returned only if the contact state is Handled or Reserved.

URL:

https://<server>:<port>/ccp/rest/task/contact/<contactId>

HTTPS method:

GET

Parameters:

See Task Submission API Parameters.

Example XML response:


<Task>
   <estimatedWaitTime>No_Of_Seconds</estimatedWaitTime>
   <status>QUEUED</status>
   <statusReason>STATUS_REASON</statusReason>
   <taskID>12345_23678_2</taskID>
   <agentID>12345<agentID>
</Task>

See Contact States and Reason Codes for contact state and state reason codes.

A reference URL to the contact is returned in the location field in the header:

https://<server>:<port>/ccp/rest/task/contact/6EEF968810000132000015F60A568DFB

Note	The URL returned in the GET or POST create request is available for polling until the request is cancelled or until there has been no polling for at least five minutes.

Response codes:

200 OK

404 Not Found

For more information about the response codes, see HTTPS Responses.