Get single interaction content file

The GET /interactions/{guid}/content/{contentKey} endpoint enables you to get a single interaction content file after specifying the interaction GUID and the content key.

Headers

Header parameters in Requests (Interaction Content API) apply to this endpoint.

Authorization scopes supported:

Parameters

Path parameters

The endpoint accepts the following path parameters:

guid

The unique identifier of the interaction you want to get content for.

contentKey

The identifier of the content you want to get from the interaction. Supported values are:

• callRecording. The call recording files in audio/wav format.
• transcript. The transcript of a call recording in application/json format.
• categorizationResult. The categorization result of the transcript in application/json format.
• screenRecording. The screen recording covering the timeframe of the interaction in video/webm format.

Header parameters

range

bytes=0-1023

This parameter is optional. You can request a specific part of a file from an interaction, for example the first 20MB of a call recording. For information on the standard accepted, see HTTP range requests.

Requests

Request call recording for an interaction

curl -L -X GET "https://***.api.newvoicemedia.com/interaction-content/interactions/017d8f64-945e-4eb4-9bcb-98b7bec78f24/content/callrecording" \
-H "Accept: application/vnd.newvoicemedia.v3+json" \
-H "Authorization: Bearer <ACCESS_TOKEN>"

Request first 1024 bytes of call recording for an interaction

curl -L -X GET "https://***.api.newvoicemedia.com/interaction-content/interactions/017d8f64-945e-4eb4-9bcb-98b7bec78f24/content/callrecording" \
-H "Accept: application/vnd.newvoicemedia.v3+json" \
-H "Range: bytes=0-1023" \
-H "Authorization: Bearer <ACCESS_TOKEN>"

Request screen recording for an interaction

curl -L -X GET "https://***.api.newvoicemedia.com/interaction-content/interactions/017d8f64-945e-4eb4-9bcb-98b7bec78f24/content/screenRecording" \
-H "Accept: application/vnd.newvoicemedia.v3+json" \
-H "Authorization: Bearer <ACCESS_TOKEN>"

Responses

A response to the endpoint returns a file.

Successful response

A response to a valid request contains a binary content file such as an audio, video or json file. The way the file is presented depends on individual client settings. The types of content returned in a response are defined in the Content-Type header. The GET interaction content endpoint supports the following types:

• callRecording (audio/wav)
• transcript, categorizationResult (application/json)
• screenRecording (video/webm)

For information about successful responses, see Success response code and parameters in Responses (Interaction Content API).