Starting a Recording
The recording api allows you to start a recording for a given extension or based on a unique call id. When starting a recording you can also stipulate a 'tag' that should be attached to the recording and which can later be used to retrieve the details of the recording.
START
Note: The API will only accept POST requests.
There are two forms of the start method; one which takes the extension number to start recording on and the other takes the uniquecallid generated by asterisk.
By Extension
This start method takes 3 arguments: extension and tag.
The extension is the telephone extension that is to be recorded and is resolved by stripping the tech and unique identifier from channel names. ie SIP/410-12FA7B becomes 410.
The tag is written to the call record in the database and appears as the "External Reference" field on a call record.
The agentLoginName is the NoojeeContact username which is used to determine if the user has permission to start a recording and records this against the recording record as the Agent Name.
The AgentLoginName is mandatory.
URL: https://<server host>/servicemanager/rest/CallManagementAPI/start?extenOrUniqueId=410&tag=22 &agentLoginName=Fred&apiKey=f863246a-973e-11e6-8784-08002718f5b5
This method returns the standard HTTP status '200' on success otherwise an error message is returned.
By uniquecallid
This start method takes 3 arguments: uniquecallid and tag.
The uniquecallid is the unique identifier that Asterisk assigns to each active call.
The tag is written to the call record in the database and appears as the "External Reference" field on a call record.
The agentLoginName is the NoojeeContact username which is used to determine if the user has permission to start a recording.
https://<server host>/servicemanager/rest/CallManagementAPI/start?extenOrUniqueId=410&tag=22 &agentLoginName=Fred&apiKey=f863246a-973e-11e6-8784-08002718f5b5
This method returns the standard HTTP status '200' on success otherwise an error message is returned.
Example
https://<server host>/servicemanager/rest/CallManagementAPI/start?extenOrUniqueId=410&tag=1234& agentLoginName=Fred&apiKey=f863246a-973e-11e6-8784-08002718f5b5