Export API
The Export API allows users to download or email audio and video recordings so they can be played independently of inContact WFO. The Export API currently exists only in Hosted inContact WFO installations.
When export requests are sent to the API, it verifies that the user account not only has permissions to export calls, but also validates that the user has permission to access the phone IDs in each recording requested for export. Any that do not pass the permissions check are omitted from the export.
For more information, see API Overview.
Web Export
Web export requests provide the requested file(s) in a compressed zip archive as a direct download.
SingleExport | |
---|---|
Description |
Exports audio based on the supplied parameters. If the specified parameters are not unique and match multiple records, the most recent record is returned. |
HTTP Method | GET |
URI |
http://[ExportApiServerAddress]/api/WebExport/SingleExport |
Required Parameters |
|
Optional Parameters |
|
Example(s): |
http://[ExportApiServerAddress]/api/WebExport/SingleExport?uniquefield=ident&uniquevalue265&mediaformat=WAV&encrypt=true&password=****** |
Possible Returns |
|
MultiExport | |
---|---|
Description |
Multiple files in one compressed zip archive. |
HTTP Method | POST |
URI |
http://[ExportApiServerAddress]/api/WebExport/MultiExport |
Required Parameters |
|
Optional Parameters |
|
Example(s): |
http://[ExportApiServerAddress]/api/WebExport/MultiExport?mediaformat=MP3&idents=1,5,34,767 or http://[ExportApiServerAddress]/api/WebExport/MultiExport?mediaformat=MP3 {“idents”:”1,5,34,767”} |
Possible Returns |
|
CombinedExport | |
---|---|
Description |
Exports multiple audio files merged into a single audio file, in order by recording ID, in a compressed zip archive. |
HTTP Method | POST |
URI |
http://[ExportApiServerAddress]/api/WebExport/CombinedExport |
Required Parameters |
|
Optional Parameters |
|
Example(s): |
http://[ExportApiServerAddress]/api/WebExport/CombinedExport?mediaformat=WAV&idents=1,5,6,32,7 or http://[ExportApiServerAddress]/api/WebExport/CombinedExport?mediaformat=WAV {“idents”:”1,5,6,32,7”} |
Possible Returns |
|
Email Export
Email export requests provide the requested file(s) in a compressed zip archive via email to the address specified.
SingleExport | |
---|---|
Description |
Emails the specified unique recording audio file in the indicated media format to the provided address within a compressed zip archive. |
HTTP Method | GET |
URI |
http://[ExportApiServerAddress]/api/EmailExport/SingleExport |
Required Parameters |
|
Optional Parameters |
|
Example(s): |
http://[ExportApiServerAddress]/api/EmailExport/SingleExport?uniquefield=ident&uniquevalue=331&mediaformat=CAV&emailaddress=user@email.com&encrypt=true&password=****** |
Possible Returns |
|
MultiExport | |
---|---|
Description |
Collects specified unique recording audio files in the indicated media format and emails them to the specified address as separate files contained in a single compressed zip archive. |
HTTP Method | POST |
URI |
http://[ExportApiServerAddress]/api/EmailExport/MultiExport |
Required Parameters |
|
Optional Parameters |
|
Example(s): |
http://[ExportApiServerAddress]/api/EmailExport/MultiExport?mediaformat=WAV&emailaddress=user@email.com&idents=2,5,3,34,67,543,12 or http://[ExportApiServerAddress]/api/EmailExport/MultiExport?mediaformat=WAV&emailaddress=user@email.com {”idents”:”2,5,3,34,67,543,12”} |
Possible Returns |
|
CombinedExport | |
---|---|
Description |
Merges specified unique recording audio files into a single recording file in the indicated media format in the order in which they appear in the database, then exports it via email within a compressed zip archive. |
HTTP Method | POST |
URI |
http://[ExportApiServerAddress]/api/EmailExport/CombinedExport |
Required Parameters |
|
Optional Parameters |
|
Example(s): |
http://[ExportApiServerAddress]/api/EmailExport/CombinedExport?mediaformat=MP3&emailaddress=user@email.com&idents=2,5,3,34,67,543,12 or http://[ExportApiServerAddress]/api/EmailExport/CombinedExport?mediaformat=MP3&emailaddress=user@email.com {”idents”:”2,5,3,34,67,543,12”} |
Possible Returns |
|