Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Please note the ACD Group Settings required are documented here: ACD Group - Parameters - REST Calls (Create Callback)

Request

POST

Parameters

The following parameters are provided in the REST request:

...

Parameter Name

...

Description

...

Caller

...

String

...

The caller number in E.164 format without a plus. For example 49199123456789

...

CallbackNumber

...

String

...

The number on which the caller requested the callback in E.164 format without a plus. For example: 49199123456789

...

ServiceNumbersNumber

...

String

...

The called service number in E.164 format without a plus.

...

ServiceNumbersName

...

String

...

The name of the service number. For example „Service Hotline“.

...

AcdGroupsID

...

Integer

...

The ID of the ACD Group in the jtel system, for which the callback request was generated.

...

AcdGroupsName

...

String

...

The Name of the ACD Group in the jtel system, for which the callback request was generated.

...

AcdGroupsForeignSystemID

...

String

...

The contents of the Foreign System ID field in the jtel ACD Group. This can be configured so as to provide a foreign reference to the Salesforce system. For example "SERVICE_B2B“.

...

dtCallStart

...

Timestamp

The date and time of the start of the call in the jtel system in local time, in the following format: yyyy-MM-ddTHH:MM:ss

...

dtCallEnd

...

Timestamp

...

The date and time of the end of the call in the jtel system in local time, in the following format: yyyy-MM-ddTHH:MM:ss

The time difference between dtCallStart and dtCallEnd is the total time spent in the jtel system by the caller, including IVR applications and all prompts and queueing time. 

...

AcdEventsID

...

Integer

...

The ID of the ACD event in the jtel system.

...

Subject

...

String

...

The subject of the callback event.

...

Body

...

String

...

The body of the callback event.

...

CreatingUsersID

...

Integer

...

The ID of the creating user in jtel, or NULL if the system created the event.

...

CreatingUsersUID

...

String

...

The UID of the creating user in jtel, or NULL if the system created the event.

...

CreatingUsersNickName

...

String

...

The Nick Name of the creating user in jtel, or NULL if the system created the event. This field can be used to create a connection between the object(s) created in Salesforce and the user who created the callback event in jtel.

...

TargetUsersID

...

Integer

...

The target user ID of the event, if the callback event was directly sent to a user. This will usually be NULL, if it is not, it corresponds to an event created manually ba another user.

...

TargetUsersUID

...

String

...

The target user UID of the event, if the callback event was directly sent to a user. This will usually be NULL, if it is not, it corresponds to an event created manually ba another user.

...

TargetUsersNickName

...

String

...

The NickName of the target user of the event, if the callback event was directly sent to a user. This will usually be NULL, if it is not, it corresponds to an event created manually ba another user.

generic AcdEvent JSON Structure is provided in the body of the REST request.

...

SalesforceId

...

String

...

The ID of the Salesforce record which was found in the routing application, and saved to the User Data field in jtel using the Save additional information IVR object.

...

SalesforceQueryResult

...

Integer

The result of the last getCallerInformation REST Apex call made:

0 = no data found

1 = one record found

2 = multiple records found

http Status Codes

The following status codes should be used:

Status Code

Meaning

200 – OK

The callback call was processed successfully (i.e. probably a Case object was created in Salesforce).

500 - Server Error

An internal error occurred processing the callback request.

...