Recording Controls

This section describes the FACE commands used to start and stop ISR recordings.

Start Recording with From/To URIs

Example Request:

$ curl -k -X POST --data 'filename=startstoptest.wav' "https://<FACE_host_name_or_IP>:8443/Face/audioRecording/start?token=8c29980c-7400-4129-8813-e58aa1eecd3c&from=sipp_g711_ulaw&to=rss_g711_ulaw"

Example Response:

<result><code>0</code><message>ACK</message><recording><tmpRecordingId>11</tmpRecordingId><ani>sipp_sd_siprec_1</ani><dnis>rss_sd_siprec</dnis><account>1</account><duration>0</duration><startTime>2018-08-30 14:58:57.149</startTime><rss>1</rss><route>1</route><agentId/><sensitive>0</sensitive><deleteFlag>false</deleteFlag><isrUcid>x-isr-ucid-1-7490@10.10.248.119</isrUcid><ingressCallId>1-7490@10.10.248.119</ingressCallId><customDataSets/><segments><segment><tmpSegmentId>14</tmpSegmentId><recordingId>11</recordingId><sequence>2</sequence><filename>rss_sd_siprec-1-7490@10.10.248.119.seg1.rpdd</filename><fileStatus>0</fileStatus><location>1</location><accountId>1</accountId><routeId>1</routeId><start>2018-08-30 14:59:36.21</start><checksumMismatch>false</checksumMismatch><pauseLength>0</pauseLength><pausedWithSilence>false</pausedWithSilence><securedMedia>0</securedMedia><hasVideo>false</hasVideo><archived>0</archived><archivalFailCount>0</archivalFailCount><archiverMode>Primary</archiverMode><archiverAction>0</archiverAction><conversionStatus>1</conversionStatus><customDataSets/><siprecDataSets><siprecData><session><startTime>2012-01-02 13:44:39.0</startTime><siprecCallId>1-7490@10.10.248.119</siprecCallId><siprecSessionId>sIbybsXtQ7pivcNTRvEN4A1==</siprecSessionId><extensionDataSets><extensionData><name>apkt:callerOrig</name><values><value>true</value></values></extensionData><extensionData><name>apkt:ucid</name><values><value>x-isr-ucid-1-7490@10.10.248.119</value></values></extensionData></extensionDataSets></session><participants>
<participant><siprecParticipantId>fhpR4z4qSy5x4H7aEzbsPg1==</siprecParticipantId><aor>sip:sipp_sd_siprec_1@10.10.248.119:5060</aor><name>sipp_sd_siprec_1</name><startTime>2012-01-02 13:44:39.0</startTime><extensionDataSets><extensionData><name>apkt:callingParty</name><values><value>true</value></values></extensionData></extensionDataSets></participant><participant><siprecParticipantId>PdDRRcWbSzl0nE7mP5W9Vg1==</siprecParticipantId><aor>sip:rss_sd_siprec@10.10.248.113:5060</aor><name>rss_sd_siprec</name><startTime>2012-01-02 13:44:39.0</startTime><extensionDataSets><extensionData><name>apkt:callingParty</name><values><value>false</value></values></extensionData></extensionDataSets></participant></participants><streams><stream><mode/><participantId>4157</participantId><siprecStreamId>4MNYDBh8R8JK+ULKGHBapw1==</siprecStreamId><startTime>2012-01-02 13:44:40.0</startTime><label>65537</label><extensionDataSets/></stream><stream><mode/><participantId>4158</participantId><siprecStreamId>vPwZND2gStZcASJPa40xhQ1==</siprecStreamId><startTime>2012-01-02 13:44:40.0</startTime><label>65536</label><extensionDataSets/></stream></streams></siprecData></siprecDataSets></segment></segments></recording></result>

Stop Recording with From/To URIs

Example Request:

$ curl -k -X POST --data 'filename=startstoptest.wav' "https://<FACE_host_name_or_IP>:8443/Face/audioRecording/stop?token=7653a545-9815-4e85-970a-14ff53b84a80&from=sipp_g711_ulaw&to=rss_g711_ulaw"

Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<result><code>0</code><message>ACK</message><recording><recordingId>673</recordingId><filename>startstoptest.wav</filename><fileStatus>0</fileStatus><ani>sipp_g711_ulaw</ani><dnis>rss_g711_ulaw</dnis><account>1</account><duration>19958</duration><startTime>2017-03-22 16:02:17.558</startTime><rss>1</rss><archived>0</archived><route>1</route><archivalFailCount>0</archivalFailCount><archiverMode>Primary</archiverMode><sensitive>0</sensitive><pauseLength>0</pauseLength><deleteFlag>false</deleteFlag><location>1</location><previousFilename>startstoptest.wav</previousFilename><archiverAction>2</archiverAction><conversionStatus>0</conversionStatus><isrUcid>x-isr-ucid-1-4355@10.10.248.107</isrUcid><ingressCallId>1-4355@10.10.248.107</ingressCallId><pausedWithSilence>false</pausedWithSilence><customDataSets/><siprecDataSets/><dtmfDigits/></recording></result>

Split Session Recording into Segments (Using UCID)

Example Request:

$ curl -k -X POST --data 'isrUcid=<e.g. isr-ucid-1-31237@10.10.248.123>' "https://
<FACE_host_name_or_IP>:8443/Face/audioRecording/split?
token=7653a545-9815-4e85-970a-14ff53b84a80"

Example Response:

<result><code>0</code><message>ACK</message><recording><tmpRecordingId>11</tmpRecordingId><ani>sipp_sd_siprec_1</ani><dnis>rss_sd_siprec</dnis><account>1</account><duration>0</duration><startTime>2018-08-30 14:58:57.149</startTime><rss>1</rss><route>1</route><agentId/><sensitive>0</sensitive><deleteFlag>false</deleteFlag><isrUcid>x-isr-ucid-1-7490@10.10.248.119</isrUcid><ingressCallId>1-7490@10.10.248.119</ingressCallId><customDataSets/><segments><segment><tmpSegmentId>14</tmpSegmentId><recordingId>11</recordingId><sequence>2</sequence><filename>rss_sd_siprec-1-7490@10.10.248.119.seg1.rpdd</filename><fileStatus>0</fileStatus><location>1</location><accountId>1</accountId><routeId>1</routeId><start>2018-08-30 14:59:36.21</start><checksumMismatch>false</checksumMismatch><pauseLength>0</pauseLength><pausedWithSilence>false</pausedWithSilence><securedMedia>0</securedMedia><hasVideo>false</hasVideo><archived>0</archived><archivalFailCount>0</archivalFailCount><archiverMode>Primary</archiverMode><archiverAction>0</archiverAction><conversionStatus>1</conversionStatus><customDataSets/><siprecDataSets><siprecData><session><startTime>2012-01-02 13:44:39.0</startTime><siprecCallId>1-7490@10.10.248.119</siprecCallId><siprecSessionId>sIbybsXtQ7pivcNTRvEN4A1==</siprecSessionId><extensionDataSets><extensionData><name>apkt:callerOrig</name><values><value>true</value></values></extensionData><extensionData><name>apkt:ucid</name><values><value>x-isr-ucid-1-7490@10.10.248.119</value></values></extensionData></extensionDataSets>
<participant><siprecParticipantId>fhpR4z4qSy5x4H7aEzbsPg1==</siprecParticipantId><aor>sip:sipp_sd_siprec_1@10.10.248.119:5060</aor><name>sipp_sd_siprec_1</name><startTime>2012-01-02 13:44:39.0</startTime><extensionDataSets><extensionData><name>apkt:callingParty</name><values><value>true</value></values></extensionData></extensionDataSets></participant><participant><siprecParticipantId>PdDRRcWbSzl0nE7mP5W9Vg1==</siprecParticipantId><aor>sip:rss_sd_siprec@10.10.248.113:5060</aor><name>rss_sd_siprec</name><startTime>2012-01-02 13:44:39.0</startTime><extensionDataSets><extensionData><name>apkt:callingParty</name><values><value>false</value></values></extensionData></extensionDataSets></participant></participants><streams><stream><mode/><participantId>4157</participantId><siprecStreamId>4MNYDBh8R8JK+ULKGHBapw1==</siprecStreamId><startTime>2012-01-02 13:44:40.0</startTime><label>65537</label><extensionDataSets/></stream><stream><mode/><participantId>4158</participantId><siprecStreamId>vPwZND2gStZcASJPa40xhQ1==</siprecStreamId><startTime>2012-01-02 13:44:40.0</startTime><label>65536</label><extensionDataSets/></stream></streams></siprecData></siprecDataSets></segment><segment><segmentId>2059</segmentId><recordingId>11</recordingId><sequence>1</sequence><filename>rss_sd_siprec-1-7490@10.10.248.119.seg0.rpdd</filename><fileStatus>0</fileStatus><location>1</location><accountId>1</accountId><routeId>1</routeId><start>2018-08-30 14:58:57.149</start><end>2018-08-30 14:59:36.21</end><checksumMismatch>false</checksumMismatch><pauseLength>0</pauseLength><pausedWithSilence>false</pausedWithSilence><securedMedia>0</securedMedia><hasVideo>false</hasVideo><archived>0</archived><archivalFailCount>0</archivalFailCount><archiverMode>Primary</archiverMode><archiverAction>0</archiverAction><conversionStatus>1</conversionStatus><customDataSets/><dtmfDigits/><siprecDataSets><siprecData>
<session><startTime>2012-01-02 13:44:39.0</startTime><siprecCallId>1-7490@10.10.248.119</siprecCallId><siprecSessionId>sIbybsXtQ7pivcNTRvEN4A1==</siprecSessionId><extensionDataSets><extensionData><name>apkt:callerOrig</name><values><value>true</value></values></extensionData><extensionData><name>apkt:ucid</name><values><value>x-isr-ucid-1-7490@10.10.248.119</value></values></extensionData></extensionDataSets></session><participants><participant><siprecParticipantId>fhpR4z4qSy5x4H7aEzbsPg1==</siprecParticipantId><aor>sip:sipp_sd_siprec_1@10.10.248.119:5060</aor><name>sipp_sd_siprec_1</name><startTime>2012-01-02 13:44:39.0</startTime><extensionDataSets><extensionData><name>apkt:callingParty</name><values><value>true</value></values></extensionData></extensionDataSets></participant><participant><siprecParticipantId>PdDRRcWbSzl0nE7mP5W9Vg1==</siprecParticipantId><aor>sip:rss_sd_siprec@10.10.248.113:5060</aor><name>rss_sd_siprec</name><startTime>2012-01-02 13:44:39.0</startTime><extensionDataSets><extensionData><name>apkt:callingParty</name><values><value>false</value></values></extensionData></extensionDataSets></participant></participants><streams><stream><mode/><participantId>4157</participantId><siprecStreamId>4MNYDBh8R8JK+ULKGHBapw1==</siprecStreamId><startTime>2012-01-02 13:44:40.0</startTime><label>65537</label><extensionDataSets/></stream><stream><mode/><participantId>4158</participantId><siprecStreamId>vPwZND2gStZcASJPa40xhQ1==</siprecStreamId><startTime>2012-01-02 13:44:40.0</startTime><label>65536</label><extensionDataSets/></stream></streams></siprecData></siprecDataSets></segment></segments></recording></result>