...
Detailed description of the API request elements:
URL parameter | Example | Description | Requirements |
---|---|---|---|
action | action=AttachMetaData | Name of the HTTP API request. | Mandatory |
apiKey | apiKey=74c8eea0-50c6-40b2-9f3e-252ed501c3c8 | API key used to identify the application. | Mandatory |
token | token=09835e02-6c10-11e0-bb22-ba324924019b | Unique identifier for authenticated sessions. After successful authentication, the API sends back a token, which has to be used for each request. | Mandatory if authentication is configured for the given API key. |
responseType | responseType=HTML | Defines the format of the response of the API request. The following valid values apply:
| If the parameter is missing, it defaults to XML. |
callID | callID=a8343631-9f35-4a3a-83f0-9e81592339fb | Defines the internal ID of the call, which the metadata is attached to. | Either the callID or either the number parameter is mandatory |
extension | extension=8856 | Defines the phone number that is a participant of the call which the metadata is attached to. The API will look for a call with the status defined, where the number is either the calling party or the called party. If the API, for some reason, finds more than 1 record, it will respond with error. | Either the callID or either the number parameter is mandatory |
status | status=ongoing,next | Defines the status of the requested call. Comma separated values can be specified.The following valid values and value combinations apply:
| Mandatory if the number parameter is specified |
customVariable1 | customVariable1=ACME | Key-value pair defining the identifier of the custom field variable and the data itself. The custom variable field identifier has to match exactly the ID defined in the Custom Meta Data Designer. | - |
customVariable2 | customVariable2=John%20Smith | Key-value pair defining the identifier of the custom field variable and the data itself. | - |
Additional reserved parameters for appending Conference Participants only from Verba 8.2 | |||
meetingID | meetingID=T0MZJ99J | Defines the conference ID, which will define every conference leg in Verba. This parameter can be used for simple metadata attaching. | - |
participants | participants=3564,customer@company.com | List of the participating phone numbers or SIP URIs | - |
startTimes | startTimes=2015-02-22 23:00:00.000,2015-02-22 23:10:00.000 | List of the participants' join time. The sequence of join times has to match with the participants parameter sequence to insert the proper join time of the participant. Format is either "YYYY-MM-DD hh:mm:ss.SSS", "YYYY-MM-DD hh:mm:ss" or "YYYY-MM-DD hh:mm" | - |
endTimes | endTimes=2015-02-22 23:15:00.000,2015-02-22 23:16:00.000 | List of the participants' leave time. The sequence of end times has to match with the participants parameter sequence to insert the proper leave time of the participant. Format is either "YYYY-MM-DD hh:mm:ss.SSS", "YYYY-MM-DD hh:mm:ss" or "YYYY-MM-DD hh:mm" | - |
Response
XML based response sample on success:
Info | ||
---|---|---|
| ||
<?xml version="1.0" encoding="UTF-8"?> <VerbaApi> <Response code="0" type="AttachMetaData"/> </VerbaApi> |
XML based response sample on error:
Info | ||
---|---|---|
| ||
<?xml version="1.0" encoding="UTF-8"?> <VerbaApi> <Response code="2" type="AttachMetaData"> <ErrorMessage description="Error">Unable <ErrorMessage>Unable to attach the metadata to the call, because the call cannot be found.</ErrorMessage> </Response> </VerbaApi> |
HTML based response sample:
Info | ||
---|---|---|
| ||
<html> <body> <p>The system successfully attached the metadata to the defined call.</p> </body> </html> |
...
TEXT based response sample:
...