LiveChat_BannedVisitor

You need the Manage Ban List to manage Banned Visitors.

LiveChat_BannedVisitors
- LiveChat_BannedVisitors Manage
GET livechat/bannedVisitors
GET livechat/bannedVisitors/{id}
POST livechat/bannedVisitors
PUT livechat/bannedVisitors/{id}
DELETE livechat/bannedVisitors/{id}
Model
LiveChat_BannedVisitor JSON Format

LiveChat_BannedVisitor is represented as simple flat JSON objects with the following keys:

Name Type Description
id guid Id of the ban.
comment string Comment of the ban.
visitorId guid Id of the visitor.
lastUpdatedTime timestamp Last updated time of the ban.
createdTime datetime Created time of the ban.
agentId guid Id of the agent.
Endpoint
Get the list of LiveChat_BannedVisitors

GET livechat/bannedVisitors

Parameters:
Name Type In Required Description
include string query no Allowed value is "agent".
Response:

An array of   LiveChat_BannedVisitor

Example

Sample Request:

curl https://api15.comm100.io/v4/livechat/bannedVisitors \
-X 'GET' \
-H 'Authorization: Bearer {access_token}' \

Response:

 HTTP/1.1 200 OK

{"bannedVisitors":[{"id":"66AE5329-7C46-EB11-8100-00155D081D0B","comment":"This visitor is a hacker.","visitorId":"6CAE5329-7C46-EB11-8100-00155D081D0B","lastUpdatedTime":"2021-04-07T07:26:40.867Z","createdTime":"2021-04-12T02:40:25.64Z","agentId":"66578086-4FBB-4098-80F2-8B0BCBA7DD33"}],"nextPage":null,"previousPage":null,"total":1}
Get a single LiveChat_BannedVisitor

GET livechat/bannedVisitors/{id}

Parameters:
Name Type In Required Description
include string query no Allowed value is "agent".
Response:
Example

Sample Request:

curl https://api15.comm100.io/v4/livechat/bannedVisitors/66AE5329-7C46-EB11-8100-00155D081D0B \
-X 'GET' \
-H 'Authorization: Bearer {access_token}' \

Response:

 HTTP/1.1 200 OK

{"id":"66AE5329-7C46-EB11-8100-00155D081D0B","comment":"This visitor is a hacker.","visitorId":"6CAE5329-7C46-EB11-8100-00155D081D0B","lastUpdatedTime":"2021-04-07T07:26:40.867Z","createdTime":"2021-04-12T02:40:25.64Z","agentId":"66578086-4FBB-4098-80F2-8B0BCBA7DD33"}
Create a new LiveChat_BannedVisitor

POST livechat/bannedVisitors

Parameters:
Name Type In Required Description
comment string body no Comment of the ban.
visitorId guid body yes Id of the visitor.
agentId guid body no Id of the agent.
Response:
Example

Sample Request:

curl https://api15.comm100.io/v4/livechat/bannedVisitors \
-X 'POST' \
-H 'Authorization: Bearer {access_token}' \
-H 'Content-Type: application/json' \
-D '{"comment":"This visitor is a hacker.","visitorId":"6CAE5329-7C46-EB11-8100-00155D081D0B","agentId":"66578086-4FBB-4098-80F2-8B0BCBA7DD33"}'

Response:

 HTTP/1.1 201 Created

{"id":"66AE5329-7C46-EB11-8100-00155D081D0B","comment":"This visitor is a hacker.","visitorId":"6CAE5329-7C46-EB11-8100-00155D081D0B","lastUpdatedTime":"2021-04-07T07:26:40.867Z","createdTime":"2021-04-12T02:40:25.64Z","agentId":"66578086-4FBB-4098-80F2-8B0BCBA7DD33"}
Update the LiveChat_BannedVisitor

PUT livechat/bannedVisitors/{id}

Parameters:
Name Type In Required Description
comment string body no Comment of the ban.
visitorId guid body yes Id of the visitor.
agentId guid body no Id of the agent.
Response:
Example

Sample Request:

curl https://api15.comm100.io/v4/livechat/bannedVisitors/66AE5329-7C46-EB11-8100-00155D081D0B \
-X 'PUT' \
-H 'Authorization: Bearer {access_token}' \
-H 'Content-Type: application/json' \
-D '{"comment":"This visitor is a hacker.","visitorId":"6CAE5329-7C46-EB11-8100-00155D081D0B","agentId":"66578086-4FBB-4098-80F2-8B0BCBA7DD33"}'

Response:

 HTTP/1.1 200 OK

{"id":"66AE5329-7C46-EB11-8100-00155D081D0B","comment":"This visitor is a hacker.","visitorId":"6CAE5329-7C46-EB11-8100-00155D081D0B","lastUpdatedTime":"2021-04-07T07:26:40.867Z","createdTime":"2021-04-12T02:40:25.64Z","agentId":"66578086-4FBB-4098-80F2-8B0BCBA7DD33"}
Remove the LiveChat_BannedVisitor

DELETE livechat/bannedVisitors/{id}

Parameters:
No Parameters
Response:

No Content

Example

Sample Request:

curl https://api15.comm100.io/v4/livechat/bannedVisitors/66AE5329-7C46-EB11-8100-00155D081D0B \
-X 'DELETE' \
-H 'Authorization: Bearer {access_token}' \

Response:

 HTTP/1.1 204 No Content