Upload a new soundclip for use with our telephony services, for example with (this is not necessarily a complete list):
When you upload the sound clip data, the sound file is automatically converted to the required format for use with our telephony appliances. If this step was unsuccessful, the API will return an error. Because this step has to be done on the fly, there may be a small delay before the API accepts your sound file.
| arg | required? | syntax | info |
|---|---|---|---|
custID | N | posint | custID of account that is to use the new soundclip (default is your own account) |
desc | N | string | a brief textual description of your soundclip |
roles | Y | list | a list of role names |
audioformat | Y | enum:wav | sound file format of file being uploaded; only wav is supported at this time |
b64audiodata | Y | base64 data | string containing base64 encoded binary audio data |
A list of roles to which this soundclip can be applied. This can be a comma separated list or an array of values.
Use telecoms.soundclip.roletype.list to fetch a list of available role types.
The function will return the soundclipID that can be then used in other functions that need a soundclipID in one or more of their arguments.