Sv translation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Retrieve Dialler ContactsThis function retrieves all dialler contacts from the client account or from a specific dialler campaign. URL
Parameters
ResponsesIf the request is performed, 200 OK is returned. See Return Codes for further possible status codes. Returned Data (200 OK)A JSON Structure containing the following fields:
ExampleNote, the dialler contact array has been shortened for readability.
Retrieve a specific Dialler Contact by IDThis function retrieves a specific dialler contact by ID. URL
Parameters
ResponsesIf the request is performed, 200 OK is returned. See Return Codes for further possible status codes. Returned Data (200 OK)A JSON Structure containing the returned contact.
ExampleNote, the dialler campaign array has been shortened for readability.
Retrieve Dialler Contacts by User DataThis function retrieves the dialler contacts given the UserData value to search for. URL
Parameters
ResponsesIf the request is performed, 200 OK is returned. See Return Codes for further possible status codes. Returned Data (200 OK)A JSON Structure containing the returned contacts.
ExampleNote, the dialler contact data has been shortened for readability.
Import a Dialler ContactThis function imports a dialler contact into a specific dialler campaign specified by either the ID or name of the Dialler Campaign. URL
Parameters
Post DataA JSON structure containing the contact to import. Note that the following fields are mandatory:
The other fields may be provided or left empty. Example (all fields, provide DiallerCampaignsID):
Example (shortened, provide DiallerCampaignsName):
ResponsesIf the request is performed, 200 OK is returned, returning the imported or already existing contact if it was a duplicate. See Return Codes for further possible status codes. Returned Data (200 OK)A JSON Structure containing the imported contact.
ExampleNote, the dialler contact data has been shortened for readability.
Delete a Dialler Contact by IDThis function deletes a dialler contact including all related data by ID. URL
Parameters
ResponsesIf the request is performed, 200 OK is returned. If the contact does not exist, 404 Not Found is returned. See Return Codes for further possible status codes. Returned Data (200 OK)A JSON Structure containing the status code.
Delete a Dialler Contact by UserDataThis function deletes a dialler contact including all related data by providing the UserData for the record to delete. Note, if more than one record contains the same user data, the first one found in the database will be deleted. It is not possible to determine which contact this will actually be. URL
Parameters
ResponsesIf the request is performed, 200 OK is returned. If the contact does not exist, 404 Not Found is returned. See Return Codes for further possible status codes. Returned Data (200 OK)A JSON Structure containing the status code.
Lock a Dialler Contact by IDThis function locks a dialler contact by ID. URL
Parameters
ResponsesIf the request is performed, 200 OK is returned. If the contact does not exist, 404 Not Found is returned. See Return Codes for further possible status codes. Returned Data (200 OK)A JSON Structure containing the status code.
Lock a Dialler Contact by UserDataThis function locks a dialler contact by UserData. Note, if more than one record contains the same user data, the first one found in the database will be locked. It is not possible to determine which contact this will actually be. URL
Parameters
ResponsesIf the request is performed, 200 OK is returned. If the contact does not exist, 404 Not Found is returned. See Return Codes for further possible status codes. Returned Data (200 OK)A JSON Structure containing the status code.
Unlock a Dialler Contact by IDThis function unlocks a dialler contact by ID. URL
Parameters
ResponsesIf the request is performed, 200 OK is returned. If the contact does not exist, 404 Not Found is returned. See Return Codes for further possible status codes. Returned Data (200 OK)A JSON Structure containing the status code.
Unlock a Dialler Contact by UserDataThis function unlocks a dialler contact by UserData. Note, if more than one record contains the same user data, the first one found in the database will be unlocked. It is not possible to determine which contact this will actually be. URL
Parameters
ResponsesIf the request is performed, 200 OK is returned. If the contact does not exist, 404 Not Found is returned. See Return Codes for further possible status codes. Returned Data (200 OK)A JSON Structure containing the status code.
|
Sv translation | |||||||
---|---|---|---|---|---|---|---|
| |||||||
Retrieve all Dialler ContactsThis function retrieves all dialler contacts from the client account. URL Translations Ignore |
ParametersNone ResponsesIf the request is performed, 200 OK is returned. See Return Codes for further possible status codes. Returned Data (200 OK)A JSON Structure containing the following fields: | ||||||
Field | Type | Data | |||||
filter | String | The applied filter. This is reserved for future use. | |||||
limitStart | Integer | The first record index. Currently 0, reserved for future use. | |||||
limitPageSize | Integer | The number of records. -1 indicates all records. Reserved for future use. | |||||
records | DiallerCampaigns [] | An array of dialler campaigns. | |||||
count | Integer | The number of dialler campaigns returned. | |||||
orderBy | String | The field used to sort the dialler campaigns. | |||||
ascending | Boolean | Whether the array of campaigns is sorted ascending or descending. | |||||
status | Integer | The return code (also provided by the http status code). | |||||
Translations Ignore |
Code Block | ||
---|---|---|
| ||
{
"filter": "",
"limitStart": 0,
"limitPageSize": -1,
"records": [
{
"bLastResultMailbox": null,
"bPhoneNumber3Invalid": null,
"bPhoneNumber4Invalid": null,
"Company": "Musterfirma GmbH",
"ExternalSystemLink": "https://crm.mycrm.com?uid=123456789",
"Email": null,
"LastAcdAgentEndReasonsID": null,
"Address": "Kunde",
"bPhoneNumber6Invalid": null,
"PhoneNumber2LastAcdAgentEndReasonsID": null,
"dtNextTry": null,
"bPhoneNumber5Invalid": null,
"bPhoneNumber1Invalid": null,
"bPhoneNumber2Invalid": null,
"Name": "Mustermann",
...
"nPhoneNumber4LastCause": null,
"Model": null,
"PhoneNumber3LastAcdAgentEndReasonsID": null,
"Tag": null
}
],
"count": 147,
"orderBy": "Name",
"ascending": true,
"status": 200
} |
Retrieve a specific Dialler Contact by ID
This function retrieves a specific dialler contact by ID.
URL
Code Block |
---|
GET {baseURL}/dialler/contacts/{DiallerContactsID} |
Parameters
Responses
If the request is performed, 200 OK is returned. See Return Codes for further possible status codes.
Returned Data (200 OK)
A JSON Structure containing the returned contact.
Example
Note, the dialler campaign array has been shortened for readability.
Code Block | ||
---|---|---|
| ||
{
"records": [
{
"bLastResultMailbox": null,
"bPhoneNumber3Invalid": null,
"bPhoneNumber4Invalid": null,
"Company": "Musterfirma GmbH",
"ExternalSystemLink": null,
"Email": null,
"LastAcdAgentEndReasonsID": null,
"Address": null,
"bPhoneNumber6Invalid": null,
"PhoneNumber2LastAcdAgentEndReasonsID": null,
"dtNextTry": null,
"bPhoneNumber5Invalid": null,
"bPhoneNumber1Invalid": null,
"bPhoneNumber2Invalid": null,
"Name": "Mustermann",
"nTriesPhoneNumber5": 0,
"nTriesPhoneNumber4": 0,
"nTriesPhoneNumber6": 0,
...
"nPhoneNumber6LastCause": null,
"Model": null,
"PhoneNumber3LastAcdAgentEndReasonsID": null,
"Tag": null
}
],
"count": 1,
"status": 200
} |
Retrieve Dialler Contacts by User Data
This function retrieves the dialler contacts given the UserData value to search for.
URL
Code Block |
---|
GET {baseURL}/dialler/contacts/contact?userData={userData} |
Parameters
Responses
If the request is performed, 200 OK is returned. See Return Codes for further possible status codes.
Returned Data (200 OK)
A JSON Structure containing the returned contacts.
Example
Note, the dialler contact data has been shortened for readability.
Code Block | ||
---|---|---|
| ||
{
"records": [
{
"bLastResultMailbox": null,
"bPhoneNumber3Invalid": null,
"bPhoneNumber4Invalid": null,
"Company": "Musterfirma GmbH",
"ExternalSystemLink": null,
"Email": null,
"LastAcdAgentEndReasonsID": null,
"Address": null,
"bPhoneNumber6Invalid": null,
"PhoneNumber2LastAcdAgentEndReasonsID": null,
"dtNextTry": null,
"bPhoneNumber5Invalid": null,
"bPhoneNumber1Invalid": null,
"bPhoneNumber2Invalid": null,
"Name": "Mustermann",
"nTriesPhoneNumber5": 0,
"nTriesPhoneNumber4": 0,
"nTriesPhoneNumber6": 0,
...
"nPhoneNumber6LastCause": null,
"Model": null,
"PhoneNumber3LastAcdAgentEndReasonsID": null,
"Tag": null
}
],
"count": 1,
"status": 200
} |
Import a Dialler Contact
This function imports a dialler contact into a specific dialler campaign specified by either the ID or name of the Dialler Campaign.
URL
Code Block |
---|
POST {baseURL}/dialler/contacts/import?overwriteDuplicates={overwriteDuplicates} |
Parameters
Whether to overwrite duplicate contacts.
If this is true, existing contact data will be overwritten when a match on the UserData field is detected.
If this is false, the new contact will be created whether a matching record is found or not.
Post Data
A JSON structure containing the contact to import.
Note that the following fields are mandatory:
- Name
- DiallerCampaignsID OR the DiallerCampaignsName
- At least one of
- PhoneNumber1
- ...
- PhoneNumber6
The other fields may be provided or left empty.
Example (all fields, provide DiallerCampaignsID):
Code Block |
---|
{
"DiallerCampaignsID": 538,
"RandomSortOrder": null,
"UserData": "testUserData",
"Client": "Client",
"Service": "Service",
"ReferenceNumber": "ReferenceNumber",
"Name" : "Name",
"FirstName" : "FirstName",
"Salutation" : "Salutation",
"Title" : "Title",
"Company" : "Company",
"Address" : "Address",
"PostalCode" : "PostalCode",
"City" : "City",
"Country" : "Country",
"AccountOwner" : "AccountOwner",
"AccountBank" : "AccountBank",
"AccountNationalBankCode" : "AccountNationalBankCode",
"AccountBIC" : "AccountBIC",
"AccountNumber" : "AccountNumber",
"AccountIBAN" : "AccountIBAN",
"Amount": 0.0,
"PhoneNumber1" : "PhoneNumber1",
"PhoneNumber2" : "PhoneNumber2",
"PhoneNumber3" : "PhoneNumber3",
"PhoneNumber4" : "PhoneNumber4",
"PhoneNumber5" : "PhoneNumber5",
"PhoneNumber6" : "PhoneNumber6",
"FaxNumber" : "FaxNumber",
"Email" : "Email",
"Website" : "Website",
"Comment" : "Comment",
"ReservedUsersUID" : "ReservedUsersUID",
"FollowUpUsersUID" : "FollowUpUsersUID",
"FollowUpDateTime" : null,
"dtBeginDate" : "2020-01-01T00:00:00",
"dtEndDate" : "2020-03-01T00:00:00",
"Manufacturer" : "Manufacturer",
"Model" : "Model",
"Tag": "Tag",
"ExternalSystemLink": "http://test.external.link/"
} |
Example (shortened, provide DiallerCampaignsName):
Code Block |
---|
{
"DiallerCampaignsName": "My Campaign",
"RandomSortOrder": null,
"UserData": "testUserData",
"Client": "Client",
"Service": "Service",
"ReferenceNumber": "ReferenceNumber",
"Name" : "Name",
...
"ExternalSystemLink": "http://test.external.link/"
} |
|
Responses
If the request is performed, 200 OK is returned, returning the imported or already existing contact if it was a duplicate.
See Return Codes for further possible status codes.
Returned Data (200 OK)
A JSON Structure containing the imported contact.
Example
Note, the dialler contact data has been shortened for readability.
Code Block | ||
---|---|---|
| ||
{
"records": [
{
"bLastResultMailbox": null,
"bPhoneNumber3Invalid": null,
"bPhoneNumber4Invalid": null,
"Company": "Company",
"ExternalSystemLink": "http://test.external.link/",
"Email": "Email",
"LastAcdAgentEndReasonsID": null,
...
"PhoneNumber3LastAcdAgentEndReasonsID": null,
"Tag": "Tag"
}
],
"count": 1,
"status": 200
} |
Delete a Dialler Contact by ID
This function deletes a dialler contact including all related data by ID.
URL
Code Block |
---|
DELETE {baseURL}/dialler/contacts/contact/{DiallerContactsID} |
Parameters
Parameter
Where
Type
Data
Responses
If the request is performed, 200 OK is returned.
If the contact does not exist, 404 Not Found is returned.
See Return Codes for further possible status codes.
Returned Data (200 OK)
A JSON Structure containing the status code.
Field
Type
Data
Delete a Dialler Contact by UserData
This function deletes a dialler contact including all related data by providing the UserData for the record to delete.
Note, if more than one record contains the same user data, the first one found in the database will be deleted. It is not possible to determine which contact this will actually be.
URL
Code Block |
---|
DELETE /dialler/contacts/contact?userData={userData} |
Parameters
Parameter
Where
Type
Data
Responses
If the request is performed, 200 OK is returned.
If the contact does not exist, 404 Not Found is returned.
See Return Codes for further possible status codes.
Returned Data (200 OK)
A JSON Structure containing the status code.
Field
Type
Data
Lock a Dialler Contact by ID
This function locks a dialler contact by ID.
URL
Code Block |
---|
PATCH {baseURL}/dialler/contacts/contact/{DiallerContactsID}/lock |
Parameters
Parameter
Where
Type
Data
Responses
If the request is performed, 200 OK is returned.
If the contact does not exist, 404 Not Found is returned.
See Return Codes for further possible status codes.
Returned Data (200 OK)
A JSON Structure containing the status code.
Field
Type
Data
Lock a Dialler Contact by UserData
This function locks a dialler contact by UserData.
Note, if more than one record contains the same user data, the first one found in the database will be locked. It is not possible to determine which contact this will actually be.
URL
Code Block |
---|
PATCH {baseURL}/dialler/contacts/contact/lock?userData={userData} |
Parameters
Parameter
Where
Type
Data
Responses
If the request is performed, 200 OK is returned.
If the contact does not exist, 404 Not Found is returned.
See Return Codes for further possible status codes.
Returned Data (200 OK)
A JSON Structure containing the status code.
Field
Type
Data
Unlock a Dialler Contact by ID
This function unlocks a dialler contact by ID.
URL
Code Block |
---|
PATCH {baseURL}/dialler/contacts/contact/{DiallerContactsID}/unlock |
Parameters
Parameter
Where
Type
Data
Responses
If the request is performed, 200 OK is returned.
If the contact does not exist, 404 Not Found is returned.
See Return Codes for further possible status codes.
Returned Data (200 OK)
A JSON Structure containing the status code.
Field
Type
Data
Unlock a Dialler Contact by UserData
This function unlocks a dialler contact by UserData.
Note, if more than one record contains the same user data, the first one found in the database will be unlocked. It is not possible to determine which contact this will actually be.
URL
Code Block |
---|
PATCH {baseURL}/dialler/contacts/contact/unlock?userData={userData} |
Parameters
Parameter
Where
Type
Data
Responses
If the request is performed, 200 OK is returned.
If the contact does not exist, 404 Not Found is returned.
See Return Codes for further possible status codes.
Returned Data (200 OK)
A JSON Structure containing the status code.
Field
Type
Data