Recording Pause/Resume

After creating a Service User within the Chronicall UI, you will be given an authentication key.
Anytime a request is made to the API, an authentication key must be present.

Add the following header to your API request:

 Authorization : Bearer {authentication_key}

By having the authorization key present, you will be able to access everything that the Service User is set up in Chronicall to have access to.

Note: For this feature, you must be updated to version 4.0.9 or newer.

Use Cases

Programmatically pause/unpause audio recording when an agent is accepting sensitive information (like a credit card number) over the phone.

Obtaining Agent Mapping

GET /rest/api/v1/agents/mapping

An endpoint to get the agent mappings.

Response

If a successful request is made, then a json result is returned.

{ 
  "nthatcher": "Nate Thatcher(123)",
   ...
}

Potential Errors

Status CodeFailure

401 Unauthorized

The authorization header wasn't valid.



403 Forbidden




The authenticated user doesn't have Chronicall access to the mapping.

Managing Active Recording for an Agent

GET /rest/api/v1/agents/{AgentId}/active-recording

An endpoint to get the active recording state for an agent.

Arguments

AgentId


The AgentId of the desired agent.

Response

If a successful request is made then a json result is returned. Possible values for state are NO_RECORDING, RECORDING, and PAUSED.

{ 
  "state": "RECORDING"
}

Potential Errors

Status CodeFailure

401 Unauthorized

The authorization header wasn't valid.



403 Forbidden



The authenticated user doesn't have Chronicall access to the mapping.



404 Not Found




There is no agent found for the given AgentId.

POST /rest/api/v1/agents/{AgentId}/active-recording/pause

An endpoint to pause the active recording of an agent.

Arguments

AgentId


The AgentId of the desired agent.

Response

If a successful request is made then a json result is returned. Possible values for state are NO_RECORDING, RECORDING, and PAUSED.

{ 
  "state": "PAUSED"
}

Potential Errors

Status CodeFailure

401 Unauthorized

The authorization header wasn't valid.



403 Forbidden



The authenticated user doesn't have Chronicall access to the mapping.



404 Not Found




There is no agent found for the AgentId.

POST /rest/api/v1/agents/{AgentId}/active-recording/resume

An endpoint to resume the active recording of an agent.

Arguments

AgentId

The AgentId of the desired agent.

Response

If a successful request is made, then a json result is returned. This result indicates the new state for the active recording for the agent. Possible values for state are NO_RECORDING, RECORDING, and PAUSED.

{ 
  "state": "RECORDING"
}

Potential Errors

Status CodeFailure

401 Unauthorized

The authorization header wasn't valid.



403 Forbidden



The authenticated user doesn't have Chronicall access to the mapping.



404 Not Found




There is no agent found for the given AgentId.

Debugging

There is a Log Filter named “Recording Client Debug” that can be used to find issues with the pause/resume requests.