POST Agents/Chat/ChatSessionsForUser

• 5 minutes to read
 • 5 minutes to read 
POST /api/v1/Agents/Chat/ChatSessionsForUser

Get all chat sessions which this user is a member of.

Members means that you have at least one of: Can Respond, Notifications, Listen or Manager

Query String Parameters

Parameter Name Type Description
$select string Optional comma separated list of properties to include in the result. Other fields are then nulled out to reduce payload size: "Name,department,category". Default = show all fields. 
POST /api/v1/Agents/Chat/ChatSessionsForUser?$select=name,department,category/id

Request Headers

Parameter Name Description
Authorization Supports 'Basic', 'SoTicket' and 'Bearer' schemes, depending on installation type.
X-XSRF-TOKEN If not using Authorization header, you must provide XSRF value from cookie or hidden input field
Accept Content-type(s) you would like the response in: application/json, text/json, application/xml, text/xml, application/json-patch+json, application/merge-patch+json
Accept-Language Convert string references and multi-language values into a specified language (iso2) code.
SO-Language Convert string references and multi-language values into a specified language (iso2) code. Overrides Accept-Language value.
SO-Culture Number, date formatting in a specified culture (iso2 language) code. Partially overrides SO-Language/Accept-Language value. Ignored if no Language set.
SO-TimeZone Specify the timezone code that you would like date/time responses converted to.
SO-AppToken The application token that identifies the partner app. Used when calling Online WebAPI from a server.

Response:array

OK

Response Description
200 OK

Response body: array

Property Name Type Description
ChatSessionId int32 The primary key (auto-incremented)
TopicId int32 The reference to the associated chat topic.
User Associate User agent handling this session
Person Person Customer person in this session - could be empty if we don't know exactly.
CustomerAlias string The alias for the customer.
CustomerHost string The hostname or IP address for the customer.
CustomerName string The name of customer, if provided
CustomerEmail string The email address of the customer, if provided
CustomerPhone string The phone number of the customer, if provided
CustomerConsented bool The customer consented when starting the session
CustomerCompanyName string The name of the customers company, if provided
Status string Enum indicating the status for the session (pending, active, closed, etc).
FirstMessage string A copy of the first message in the chat session
LastMessage string A copy of the last message in the chat session
WhenRequested date-time When the session was requested by the customer.
WhenStarted date-time When the session was accepted by a user.
WhenEnded date-time When the session was ended.
WhenIdle date-time The last time anyone sent a message for this session.
WhenFetched date-time The last time the customer's client refetched the data. Used to detect 'dead' session.
SessionKey string Key used to authenticate the session.
InitialQueuePos int32 The initial queue pos (i.e. the number of pending sessions + 1) when the session was requested.
AlertLevel int32 The alert level for this chat session.
Rank int32 Lowest possible unique number for active sessions for user. User for color index. Starting at 1.
Flags string Various flags for the chat session
Contact Contact Contact this session is connected to - could be empty if we don't know exactly.
Project Project Project the session is connectedto - could be empty if we don't know exactly.
Sale Sale Sale the session is connected to - could be empty if we don't know exactly.
Ticket Ticket Ticket the session is connected to - could be empty if we don't know exactly.
TransferTo Associate User agent that has a pending transfer of the chat session
ChatbotIsActive bool Indicates that a chatbot is active on the session. This will cause bot triggers to fire. Set to 0 when bot hands off to user.
Rating int32 Rating of this chat conversation given by the customer
TableRight TableRight The carrier's table right
FieldProperties object Field property dictionary mapping field names to field access rights.

Sample request

POST /api/v1/Agents/Chat/ChatSessionsForUser
Authorization: Basic dGplMDpUamUw
Accept: application/json; charset=utf-8
Accept-Language: en

Sample response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

[
  {
    "ChatSessionId": 659,
    "TopicId": 260,
    "User": null,
    "Person": null,
    "CustomerAlias": "sit",
    "CustomerHost": "quia",
    "CustomerName": "Hilll, Powlowski and Wolf",
    "CustomerEmail": "greta@hoppemacejkovic.us",
    "CustomerPhone": "1-211-892-9693",
    "CustomerConsented": false,
    "CustomerCompanyName": "Vandervort, Bergstrom and Boehm",
    "Status": "Closed",
    "FirstMessage": "est",
    "LastMessage": "voluptas",
    "WhenRequested": "2002-05-24T17:54:02.7108516+02:00",
    "WhenStarted": "2019-05-21T17:54:02.7108516+02:00",
    "WhenEnded": "2018-10-29T17:54:02.7108516+01:00",
    "WhenIdle": "2010-05-14T17:54:02.7108516+02:00",
    "WhenFetched": "2023-07-10T17:54:02.7108516+02:00",
    "SessionKey": "ducimus",
    "InitialQueuePos": 214,
    "AlertLevel": 37,
    "Rank": 661,
    "Flags": "CustomerIsTyping",
    "Contact": null,
    "Project": null,
    "Sale": null,
    "Ticket": null,
    "TransferTo": null,
    "ChatbotIsActive": true,
    "Rating": 936,
    "TableRight": null,
    "FieldProperties": {
      "fieldName": {
        "FieldRight": null,
        "FieldType": "System.Int32",
        "FieldLength": 273
      }
    }
  }
]