Jump to: navigation, search

Client-Initiated CometD Channels

Create Session

CometD Channel /service/session/create
Description Creates a new co-browse session.

Request:

{}

Response:

{
  "sessionToken": "123"
}

Join Session

CometD Channel /service/session/join
Description Allows the user to join the session.

Request:

{
  "sessionToken": "123",
  "role": 2, // 1 - customer, 2 - agent, 3 - controller
  "name": "Bob" //optional (for controller it does not make sense at all)
}

Response:

{
  "userToken": "abc789",
  "userId": 2,
  "users": [
    {
      "userId": "1",
      "role": 1,
      "name": "John"
    }
  ],
  "sessionHistoryId": "abc789"
}

Every connected user receives a userToken providing personalized session access.

Exit Session

CometD Channel /service/session/exit
Description Allows the user to exit the session explicitly. The CometD disconnection should be handled via session deactivated notification.

Request:

{
    userToken: "abc123"
}

Response:

{}

Stop Session

CometD Channel /service/session/stop
Description Stops the co-browse session. This is available for the Controller only. The session is deactivated and all users receive the session deactivated notification.

Request:

{
    userToken: "abc123"
}

Response:

{}
This page was last edited on August 31, 2020, at 22:05.
Comments or questions about this documentation? Contact us for support!