Versions Compared

Key

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

Status
subtletrue
colourBlue
title3.28 30 upwards

This API works in tandem with special ACD Group Settings which cause callback requests voice mails generated in the ACD to be passed to an external REST interface.

...

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.

...

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

...

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

http Status Codes

The following status codes should be used:

...