Dealing with Livechat rooms

Get the Livechat room data or open a new room.

URL	Requires Auth	HTTP Method
`/api/v1/livechat/room`	`no`	`GET`

Query Parameters

Argument	Example	Required	Description
`token`	`iNKE8a6k6cjbqWhWd`	Required	The visitor `token`.
`rid`		Optional	The room `_id`.

Example Call

curl http://localhost:3000/api/v1/livechat/room?token=iNKE8a6k6cjbqWhWd

Example Result

{
  "room": {
    "_id": "onrMgdKbpX9Qqtvoi",
    "msgs": 0,
    "usersCount": 1,
    "lm": "2018-09-14T17:36:48.276Z",
    "fname": "Livechat Visitor",
    "t": "l",
    "ts": "2018-09-14T17:36:48.276Z",
    "v": {
      "_id": "YgEoq2djbGdjjZnsL",
      "username": "guest-4",
      "token": "iNKE8a6k6cjbqWhWd",
      "status": "online"
    },
    "servedBy": {
      "_id": "7Gm3PoFCJWTCJ68XR",
      "username": "livechat.agent"
    },
    "cl": false,
    "open": true,
    "waitingResponse": true,
    "jitsiTimeout": "2018-09-14T18:36:48.273Z",
    "_updatedAt": "2018-09-14T17:36:48.276Z"
  },
  "newRoom": true,
  "success": true
}

Change Log

Version	Description
0.70.0	Added

Close Livechat room

URL	Requires Auth	HTTP Method
`/api/v1/livechat/room.close`	`no`	`POST`

Payload

Argument	Example	Required	Description
`rid`	`XFzMqgn33DcsQkpJp`	Required	The room `_id`.
`token`	`iNKE8a6k6cjbqWhWd`	Required	The visitor `token`.

Example payload

{
  "rid": "XFzMqgn33DcsQkpJp",
  "token": "iNKE8a6k6cjbqWhWd"
}

Example Call

curl -X POST \
     -H "Content-type:application/json" \
     http://localhost:3000/api/v1/livechat/room.close \
     -d '{"rid": "XFzMqgn33DcsQkpJp", "token": "iNKE8a6k6cjbqWhWd"}'

Example Result

{
  "rid": "XFzMqgn33DcsQkpJp",
  "comment": "Closed by visitor",
  "success": true
}

Change Log

Version	Description
0.70.0	Added

Transfer Livechat room

URL	Requires Auth	HTTP Method
`/api/v1/livechat/room.transfer`	`no`	`POST`

Payload

Argument	Example	Required	Description
`rid`	`XFzMqgn33DcsQkpJp`	Required	The room `_id`.
`token`	`iNKE8a6k6cjbqWhWd`	Required	The visitor `token`.
`department`	`wXpPLofkffqWAwDNF`	Required	The new `department`.

Example payload

{
  "rid": "XFzMqgn33DcsQkpJp",
  "token": "iNKE8a6k6cjbqWhWd",
  "department": "wXpPLofkffqWAwDNF"
}

Example Call

curl -X POST \
     -H "Content-type:application/json" \
     http://localhost:3000/api/v1/livechat/room.transfer \
     -d '{"rid": "XFzMqgn33DcsQkpJp", "token": "iNKE8a6k6cjbqWhWd", "department": "wXpPLofkffqWAwDNF"}'

Example Result

{
  "room": {
    "_id": "XFzMqgn33DcsQkpJp",
    "servedBy": {
      "_id": "wiyTfFKXr5GhgRu9A",
      "username": "livechat.agent"
    },
    "open": true,
    "departmentId": "wXpPLofkffqWAwDNF"
  },
  "success": true
}

Change Log

Version	Description
0.70.0	Added

Send the Livechat survey

URL	Requires Auth	HTTP Method
`/api/v1/livechat/room.survey`	`no`	`POST`

Payload

Argument	Example	Required	Description
`rid`	`XFzMqgn33DcsQkpJp`	Required	The room `_id`.
`token`	`iNKE8a6k6cjbqWhWd`	Required	The visitor `token`.
`data`	`[{"name": "satisfaction", "value":"3"}]`	Required	The survey `data`.

Example payload

{
  "rid":"XFzMqgn33DcsQkpJp",
  "token": "iNKE8a6k6cjbqWhWd",
  "data": [
    {
      "name": "satisfaction",
      "value": "3"
    }
  ]
}

Example Call

curl -X POST \
     -H "Content-type:application/json" \
     http://localhost:3000/api/v1/livechat/room.survey \
     -d '{"rid":"XFzMqgn33DcsQkpJp", "token": "iNKE8a6k6cjbqWhWd", "data": "[{"name": "satisfaction", "value": "3"}]"}'

Example Result

{
  "rid": "XFzMqgn33DcsQkpJp",
  "data": {
    "satisfaction": "3",
    "agentResposiveness": "5"
  },
  "success": true
}

Change Log

Version	Description
0.70.0	Added

Contribute to our growth with your feedback