Sv translation

language	en

Table of Contents

maxLevel	1

Retrieve all AcdEvents

This function retrieves all AcdEvents from the client account.

URL

Translations Ignore

Code Block
GET {baseURL}/acd/events

Parameters

None

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 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	AcdEvent []	An array of AcdEvents.
count	Integer	The number of records returned.
orderBy	String	The field used to sort the records.
ascending	Boolean	Whether the array of records is sorted ascending or descending.
status	Integer	The return code (also provided by the http status code).

Example

Translations Ignore

Code Block

language	js

{
    "filter": "",
    "limitStart": 0,
    "limitPageSize": -1,
    "records": [
        {
            "SkillsValue2": null,
            "SkillsValue1": null,
            "ChatConnectorsID": 1,
            "UserData": "123456",
...
            "AcdEventStatusID": 20,
            "dtLastModified": "2020-08-09T02:33:50.347"
        }
    ],
    "count": 374,
    "orderBy": "dtCreated",
    "ascending": true,
    "status": 200
}

Retrieve an AcdEvent by ID

This function retrieves one AcdEvent by ID from the client account.

URL

Translations Ignore

Code Block
GET {baseURL}/acd/events/event/{AcdEventsID}

Parameters

Parameter	Where	Type	Data
AcdEventsID	URL	Integer	The ID of the AcdEvent.

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 following fields:

Field	Type	Data
records	AcdEvent []	An array of AcdEvents containing one AcdEvent.
count	Integer	1
status	Integer	The return code (also provided by the http status code).

Example

Translations Ignore

Code Block

language	js

{
    "records": [
        {
            "SkillsValue2": null,
            "SkillsValue1": null,
            "ChatConnectorsID": 1,
            "UserData": "123456",
...
            "AcdEventStatusID": 20,
            "dtLastModified": "2020-08-09T02:33:50.347"
        }
    ],
    "count": 1,
    "status": 200
}

Create an AcdEvent

This function creates an AcdEvent.

URL

Translations Ignore

Code Block
POST {baseURL}/acd/events/create

Parameters

None.

Post Data

A JSON structure containing the following parameters:

Parameter	Required	Supported in AcdEventTypes	Type	Data
AcdEventTypesID	Yes		Integer	The ID of the AcdEventType to create.
AcdGroupsID	Yes	All	Integer	The ID of the AcdGroup to which this event should be distributed.
UsersID	No	All	Integer	The ID of the User to which this event should be distributed. If not provided, the event is distributed via the group queue.
Sender	Yes	All	String	A string identifying the sender. For telephone related events this should be a telephone number in E.164 format (Voice Mail and Callback Requests). For other events the data may be context specific - for example an email address.
Receiver	No	All	String	A string identifying the receiver. For telephone related events this should be a telephone number which is available in the system as a configured service number in E.164 format (Voice Mail and Callback Requests). For other events, the data may be context specific - for example an email address.
Subject	Yes	All	String	A string subject to associate with the event. Can be any text.
Body	No	Callback	String	A body which will be added to the event body data.
CrmURL	No	All	String	An URL which will be associated with the event. This should correspond to a well formed URL.
UserData	No	All	String	An optional user data field which will be associated with the event. For Ticket (Workflow) events, this will correspond to the foreign system ticket number.

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 following fields:

Field	Type	Data
records	AcdEvent []	An array of AcdEvents containing the created AcdEvent.
count	Integer	1
status	Integer	The return code (also provided by the http status code).

Example Post Data

Create a callback event:

Translations Ignore

Code Block

{  
	"AcdEventTypesID": 3,
	"AcdGroupsID": 235,
	"UsersID": null,
	"Sender" : "49199123456789",
	"Receiver" : "4919900112233",
	"Subject": "Callback request from 49199123456789 on 2020.08.09 at 09:00",
	"Body": "This is an automatically generated callback request via the REST API.\r\nCongratulations!\r\n",
	"CrmURL": "https://www.jtel.de",
	"UserData": "987654"
}

Create a callback event for a specific user:

Translations Ignore

Code Block

{  
	"AcdEventTypesID": 3,
	"AcdGroupsID": 235,
	"UsersID": 3,
	"Sender" : "49199123456789",
	"Receiver" : "4919900112233",
	"Subject": "Callback request from 49199123456789 on 2020.08.09 at 09:00",
	"Body": "This is an automatically generated callback request via the REST API.\r\nCongratulations!\r\n",
	"CrmURL": "https://www.jtel.de",
	"UserData": "987654"
}

Create a ticket event:

Translations Ignore

Code Block

{  
	"AcdEventTypesID": 6,
	"AcdGroupsID": 235,
	"UsersID": null,
	"Sender" : "info@example.com",
	"Receiver" : "support@jtel.de",
	"Subject": "A new ticket 123456 has been created via the REST API. Congratulations!",
	"CrmURL": "https://www.jtel.de",
	"UserData": "123456"
}

Example response:

Translations Ignore

Code Block

language	js

{
    "records": [
        {
            "SkillsValue2": null,
            "SkillsValue1": null,
            "ChatConnectorsID": null,
            "UserData": "987654",
            "SkillsValue3": null,
            "dtReceived": null,
            "AcdGroupsID": 235,
            "dtRemind": null,
            "EventData": "<eventData><callbackNumber>49199123456789</callbackNumber><body html=\"true\"><content>This is an automatically generated callback request via the REST API.\r\nCongratulations!\r\n</content></body></eventData>",
            "AcdWorkFlowConnectorsID": null,
            "AcdInboxesID": null,
            "ID": 1633,
            "LastAgentTime": null,
            "CrmURL": "https://www.jtel.de",
            "WorkFlowMonitorPointsID": null,
            "AcdReplyingTypesID": null,
            "AcdEventTypesID": 3,
            "dtModified": "2020-08-09T03:37:19.314",
            "bCloseByForeignSystem": false,
            "Receiver": "4919900112233",
            "Subject": "Callback request from 49199123456789 on 2020.08.09 at 09:00",
            "UsersID": null,
            "Sender": "49199123456789",
            "ForeignSystemNumber": null,
            "dtCreated": "2020-08-09T03:37:19.249",
            "UserData2": null,
            "UserData3": null,
            "SkillsID3": null,
            "SkillsID1": null,
            "SkillsID2": null,
            "AcdEventStatusID": 1,
            "dtLastModified": "2020-08-09T03:37:19.336"
        }
    ],
    "count": 1,
    "status": 200
}

Sv translation

language	de

Table of Contents

maxLevel	1

Retrieve all Dialler Campaigns

This function retrieves all dialler campaigns from the client account.

URL

Translations Ignore

Code Block
GET {baseURL}/dialler/campaigns

Parameters

None

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 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).

Example

Note, the dialler campaign array has been shortened for readability.

Translations Ignore

Code Block

language	js

{
    "filter": "",
    "limitStart": 0,
    "limitPageSize": -1,
    "records": [
        {
            "ContactPreviewTime": 5,
            "nMaxParallelLines": null,
            "bCloseContactsOnIncomingCallsMatchCallerID": true,
            "dtTo": null,
            "LanguagesID": 2,
            "bCallerIDActive": false,
            "Name": "Campaign 1000",
...
            "ClientsID": 1,
            "AbortOnNoTelNumberResultCodesID": 2492,
            "IncomingCallResultCodesID": 2494
        }
    ],
    "count": 1,
    "orderBy": "Name",
    "ascending": true,
    "status": 200
}

Retrieve a specific Dialler Campaign by ID

This function retrieves a specific dialler campaign by ID.

URL

Code Block
GET {baseURL}/dialler/campaigns/{DiallerCampaignsID}

Parameters

Parameter	Where	Type	Data
DiallerCampaignsID	URL	Integer	The ID of the Dialler Campaign.

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 campaign.

Field	Type	Data
records	DiallerCampaigns []	An array of dialler campaigns, containing one campaign.
count	Integer	1
status	Integer	The return code (also provided by the http status code).

Example

Note, the dialler campaign array has been shortened for readability.

Translations Ignore

Code Block

language	js

{
     "records": [
        {
            "ContactPreviewTime": 5,
            "nMaxParallelLines": null,
            "bCloseContactsOnIncomingCallsMatchCallerID": true,
            "dtTo": null,
            "LanguagesID": 2,
            "bCallerIDActive": false,
            "Name": "Campaign 1000",
...
            "ClientsID": 1,
            "AbortOnNoTelNumberResultCodesID": 2492,
            "IncomingCallResultCodesID": 2494
        }
    ],
    "count": 1,
    "status": 200
}

Retrieve Dialler Campaigns by Name

This function retrieves one or more dialler campaigns, depending on the passed name. If more than one campaign is available which matches the name passed (partial match), then all corresponding campaigns will be returned.

URL

Translations Ignore

Code Block
GET {baseURL}/dialler/campaigns/campaign?name={DiallerCampaignsName}

Parameters

Parameter	Where	Type	Data
DiallerCampaignsName	Query	String	The name of the dialler campaign(s) to retrieve.

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 campaign.

Field	Type	Data
records	DiallerCampaigns []	An array of dialler campaigns, containing one campaign.
count	Integer	1
status	Integer	The return code (also provided by the http status code).

Example

Note, the dialler campaign data has been shortened for readability.

Translations Ignore

Code Block

language	js

{
     "records": [
        {
            "ContactPreviewTime": 5,
            "nMaxParallelLines": null,
            "bCloseContactsOnIncomingCallsMatchCallerID": true,
            "dtTo": null,
            "LanguagesID": 2,
            "bCallerIDActive": false,
            "Name": "Campaign 1000",
...
            "ClientsID": 1,
            "AbortOnNoTelNumberResultCodesID": 2492,
            "IncomingCallResultCodesID": 2494
        }
    ],
    "count": 1,
    "status": 200
}

Retrieve the Result Codes from a Dialler Campaign

This function retrieves all result codes from a particular dialler campaign.

URL

Translations Ignore

Code Block
GET {baseURL}/dialler/campaigns/campaign/{DiallerCampaignsID}/resultCodes?languagesID={LanguagesID}

Parameters

Parameter

Where

Type

Data

DiallerCampaignsID

URL

Integer

The ID of the dialler campaign for which to retrieve the result codes.

languagesID

Query

Integer

The ID of the language in which to retrieve the result codes.

Currently supported:

1 = English

2 = German

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 result codes.

Field	Type	Data
records	DiallerCampaigns []	An array of dialler campaign result codes.
count	Integer	The number of returned result codes.
status	Integer	The return code (also provided by the http status code).

Example

Note, the dialler campaign result codes array has been shortened for readability.

Translations Ignore

Code Block

language	js

{
    "records": [
        {
            "bDone": true,
            "DiallerResultCodesTypesContent": "Abschluss",
            "bDelay": false,
            "DiallerCampaignsID": 535,
            "DiallerResultCodesTypesShortText": "DiallerResultCodesTypes.1",
            "bAllowDelete": true,
            "ExportKey": "ABG",
            "Content": "Abgeschlossen",
            "ShortText": "DiallerCampaignsResultCodes.2695",
            "bAborted": false,
            "ID": 2695,
            "bAgentBound": null,
            "TimeOffset": null,
            "bAppointment": false,
            "DiallerResultCodesTypesID": 1
        },
        ...
        {
            "bDone": false,
            "DiallerResultCodesTypesContent": "Abbruch",
            "bDelay": false,
            "DiallerCampaignsID": 535,
            "DiallerResultCodesTypesShortText": "DiallerResultCodesTypes.2",
            "bAllowDelete": true,
            "ExportKey": "Aufleger",
            "Content": "Aufleger",
            "ShortText": "DiallerCampaignsResultCodes.2698",
            "bAborted": true,
            "ID": 2698,
            "bAgentBound": null,
            "TimeOffset": null,
            "bAppointment": false,
            "DiallerResultCodesTypesID": 2
        }
    ],
    "count": 7,
    "status": 200

Clone a Dialler Campaign

This function clones a dialler campaign including all related data except for the contacts in the campaign.

URL

Translations Ignore

Code Block
POST {baseURL}/dialler/campaigns/clone

POST Data

A JSON Structure containing the following parameters:

Field	Type	Value
source	String	The name of the dialler campaign to clone.
destination	String	The name of the new destination campaign to create.
userData	String	UserData which can be associated with the newly cloned dialler campaign.

Example:

Translations Ignore

Code Block
{ "source": "Campaign 1000", "destination": "My New Campaign", "userData": "UserData Field Contents" }

Responses

If the request is performed, 200 OK is returned.

If the source campaign does not exist, 404 Not Found is returned.

If the destination campaign already exists, 409 Conflict is returned.

See Return Codes for further possible status codes.

Returned Data (200 OK)

A JSON Structure containing the cloned campaign.

Field	Type	Data
records	DiallerCampaigns []	An array of dialler campaigns, containing one campaign.
count	Integer	1
status	Integer	The return code (also provided by the http status code).

Example

Note, the dialler campaign data has been shortened for readability.

Translations Ignore

Code Block

language	js

{
     "records": [
        {
            "ContactPreviewTime": 5,
            "nMaxParallelLines": null,
            "bCloseContactsOnIncomingCallsMatchCallerID": true,
            "dtTo": null,
            "LanguagesID": 2,
            "bCallerIDActive": false,
            "Name": "Campaign 1000",
...
            "ClientsID": 1,
            "AbortOnNoTelNumberResultCodesID": 2492,
            "IncomingCallResultCodesID": 2494
        }
    ],
    "count": 1,
    "status": 200
}

Delete a Dialler Campaign by ID

This function deletes a dialler campaign including all related data.

URL

Translations Ignore

Code Block
DELETE {baseURL}/dialler/campaigns/campaign/{DiallerCampaignsID}

Parameters

Parameter	Where	Type	Data
DiallerCampaignsID	URL	Integer	The ID of the dialler campaign to delete.

Responses

If the request is performed, 200 OK is returned.

If the campaign 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
status	Integer	The return code (also provided by the http status code).

Delete a Dialler Campaign by Name

This function deletes a dialler campaign including all related data.

URL

Translations Ignore

Code Block
DELETE {baseURL}/dialler/campaigns/campaign?name=DiallerCampaignsName

Parameters

Parameter	Where	Type	Data
DiallerCampaignsName	Query	String	The name of the dialler campaign to delete.

Responses

If the request is performed, 200 OK is returned.

If the campaign 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
status	Integer	The return code (also provided by the http status code).

Page tree

Page History

Versions Compared

Old Version 5

New Version 6

Key

Retrieve all AcdEvents

URL

Parameters

Responses

Returned Data (200 OK)

Example

Retrieve an AcdEvent by ID

URL

Parameters

Responses

Returned Data (200 OK)

Example

Create an AcdEvent

URL

Parameters

Post Data

Responses

Returned Data (200 OK)

Example Post Data

Retrieve all Dialler Campaigns

URL

Parameters

Responses

Returned Data (200 OK)

Example

Retrieve a specific Dialler Campaign by ID

URL

Parameters

Responses

Returned Data (200 OK)

Example

Retrieve Dialler Campaigns by Name

URL

Parameters

Responses

Returned Data (200 OK)

Example

Retrieve the Result Codes from a Dialler Campaign

URL

Parameters

Responses

Returned Data (200 OK)

Example

Clone a Dialler Campaign

URL

POST Data

Responses

Returned Data (200 OK)

Example

Delete a Dialler Campaign by ID

URL

Parameters

Responses

Returned Data (200 OK)

Delete a Dialler Campaign by Name

URL

Parameters

Responses

Returned Data (200 OK)