Versions Compared

Key

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

Terminates an active chat.

Status
colourYellow
titleHTTP POST
/livechat/:domain/endContactByChatID

Path Variables:

Name

Mandatory

Type

Description

domain

Status
titleno

Status
titlestring

Unique domain identifier

Headers:

Authorization: see Authentication mechanisms

Request Body:

Type:
Status
titleJSON

Name

Mandatory

Type

Description

ctlivetoken

chatID

Status
colourRed
titleYES

Status
titleSTRING

Unique

ctlive session

Name

Mandatory

Type

Description

chatID

Status

Chat identifier

Request Body:

Type:
Status
titleJSON

reason

Status
colourRed
titleYES

Status
titleSTRING

Unique Chat identifier

Reason for closing the chat. Any reason different from “success” is considered a failure reason

Response:

Type:
Status
titleJSON

Name

Type

Description

result

Status
titleBOOLEAN

If true, the service response was performed correctly

error

Status
titleNULL
/
Status
titleSTRING

Contains the error description if an error has occurred in the request

Example:

Request

http://<hostname>:<port>/livechat/default/endContactByChatID

...

Code Block
languagejson
{
	"chatID" : "CHAT_1b434365-0229-4b64-a56c-2942cae63a90",
	"reason" : "success"
}

Response

Code Block
languagejson
{
    "result": true,
    "error": null
}