Use call recording to improve transparency and for regulatory compliance, training, quality monitoring and customer insight gathering.


Steps to Getting Started with Call Recording

  1. Activate and Configure Call Recording 
  2. View Completed Recordings
  3. Download Completed Recordings
  4. Delete Completed Recordings

All setup is done in Mission Control or through the Telnyx API.


1. Activate and Configure Call Recording

Call recording is set on the phone number for inbound calls and on the outbound profile for outbound calls. If you would like to record all calls for a number, you’ll need to turn recording on for both the number and the outbound profile that it is associated with.

Inbound Calls

Mission Control:
In the Numbers section of the Mission Control portal, find the number for which you would like to record incoming calls. If you do not have a number serviced by Telnyx, either purchase a number or port a number from another carrier.

For that number, click the Record icon under Services. Turn Inbound Call Recording to On

Configure the recording settings in this screen. The default configuration for call recording is:

  1. File Format: WAV
  2. File Type: Single Channel Recording
  3. Recording Start: Recordings begin when the call is answered.

Call recording configuration options include (or will soon include):

  1. File Format: WAV or MP3
  2. File Type (Coming Soon!): Single Channel Recording and Dual Channel Recording.
  3. Recording Start (Coming Soon!): Recordings begin when call is ringing or answered.

Click Save, and you’re ready to record inbound calls.

Telnyx API:
Disable:

                 curl -X PUT --header "Content-Type: application/json" --header
                 "Accept: application/json" -d '{
                     "inbound_call_recording_enabled": false
                 }' "https://api.telnyx.com/origination/numbers/{id}"

Enable:
                 curl -X PUT --header "Content-Type: application/json" --header
                 "Accept: application/json" -d '{
                     "inbound_call_recording_enabled": true
                 }' "https://api.telnyx.com/origination/numbers/{id}"


Outbound Calls

Mission Control:
In the Outbound section of the Mission Control portal, find the outbound profile that calls you’d like to record will originate from. Next, select the gear icon, and click Advanced Options. Finally, click on the Recording tab.

Outbound profiles have 3 call recording options: 

Option 1: Do Not Record — No calls made from connections in this outbound profile will be recorded.
Option 2: Record Outbound Calls — All outbound calls made from connections in your outbound profile will be recorded.
Option 3: Record Outbound Calls by ANI — Define specific phone numbers associated with this profile . You can add as many as you’d like.

Select Option 2 or Option 3.


Configure the recording settings in this screen. The default configuration for call recording is:

  1. Record Calls (Inbound or Outbound): Do Not Record
  2. File Format: WAV
  3. File Type: Single Channel Recording
  4. Recording Start: Recordings begin when the call is answered.

Call recording configuration options include (or will soon include):

  1. File Format: WAV or MP3
  2. File Type (Coming Soon!): Single Channel Recording and Dual Channel Recording 
  3. Recording Start (Coming Soon!): Recordings begin when call is ringing or answered

Click Save, and you’re ready to record outbound calls.


Telnyx API

Option 1:
                 curl -X PUT --header "Content-Type: application/json" --header
                 "Accept: application/json" -d '{
                     "call_recording_type": "none"
                 }' "https://api.telnyx.com/termination/endpoints/{id}"

Options 2:
                 curl -X PUT --header "Content-Type: application/json" --header
                 "Accept: application/json" -d '{
                     "call_recording_type": "all"
                 }' "https://api.telnyx.com/termination/endpoints/{id}"

Option 3:
                 curl -X PUT --header "Content-Type: application/json" --header
                 "Accept: application/json" -d '{
                     "call_recording_type": "by_caller_phone_number",
                     "call_recording_caller_phone_numbers": ["+13125550100"]
                 }' "https://api.telnyx.com/termination/endpoints/{id}"


Reminders:

  • All recordings begin when the call is answered.
  • If you activate call recording for an inbound number, it will NOT record outbound calls placed from that number.
  • Similarly, if you activate call recording on an outbound profile, it will not record inbound calls made to that number.


2. View Completed Recordings

Call recordings are accessible from Mission Control or through the API for download.

Mission Control
:
In the Reporting section of the Mission Control portal, click on the Recordings tab. All completed recordings that have not been deleted will be displayed.

You can search for recorded calls based on the start time or end time that the recording was made.

Telnyx API:

Retrieve all:
                 curl -X GET --header "Content-Type: application/json" --header
                 "Accept: application/json" "https://api.telnyx.com/recordings"


3. Download Completed Recordings


Mission Control
:
Once you've located the correct recording in the Recordings tab of the Reporting section of the Mission Control portal, click the WAV or MP3 download button.

Telnyx API:

Step 1:

                 curl -X GET --header "Content-Type: application/json" --header
                 "Accept: application/json" "https://api.telnyx.com/recordings/{id}"

Response:

                 {
                   "data": {
                     "updated_at": "2017-12-05T04:28:04.182049",
                     "record_type": "recording",
                     "id": "169dc06e-9c2c-421c-82a2-2039cfda6173",
                     "download_urls": {
                       "wav": <DOWNLOAD_WAV_URL>
                     },
                     "created_at": "2017-12-05T04:26:16.615278",
                     "call": {
                       "start_time": "2017-12-05T04:26:03.748739Z",
                       "end_time": "2017-12-05T04:26:15.808740Z",
                       "duration": 12060,
                       "to": "+13122700000",
                       "telnyx_session_uuid": "67745a42-d974-11e7-9633-
                       02420a1f010f",
                       "id": "67777c17-d974-11e7-96d5-02420a1f010f",
                       "from": "xx9744",
                       "connection_id": "644835420858414259"
                     }
                   }
                 }

Step 2:

                 curl -X GET "<DOWNLOAD_WAV_URL>" -o “{id}.wav”


4. Delete Completed Recordings

Mission Control:
Once you've located the correct recording in the Recordings tab of the Reporting section of the Mission Control portal, click the delete icon.

Telnyx API:

                 curl -X DELETE --header "Content-Type: application/json" --header
                 "Accept: application/json" "https://api.telnyx.com/recordings/{id}"

Did this answer your question?