Transfer Chat Session
Request to send the session to another user.
If the session does not belong to the user, nothing happens. NsApiSlow threshold: 5000 ms.
Headers
Convert string references and multi-language values into a specified language (iso2) code.
Convert string references and multi-language values into a specified language (iso2) code. Overrides Accept-Language value.
Number, date formatting in a specified culture (iso2 language) code. Partially overrides SO-Language/Accept-Language value. Ignored if no Language set.
Specify the timezone code that you would like date/time responses converted to.
The application token that identifies the partner app. Used when calling Online WebAPI from a server.
Query Parameters
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.
Body
ChatSessionId, ToAssociate
Response
OK
Chat sessions belong to a chat topic, and contain messages to/from users Carrier object for ChatSessionEntity. Services for the ChatSessionEntity Carrier is available from the Chat Agent.
The primary key (auto-incremented)
The reference to the associated chat topic.
Carrier object for Associate. Services for the Associate Carrier is available from the Associate Agent.
Carrier object for Person. Services for the Person Carrier is available from the Person Agent.
The alias for the customer.
The hostname or IP address for the customer.
The name of customer, if provided
The email address of the customer, if provided
The phone number of the customer, if provided
The customer consented when starting the session
The name of the customers company, if provided
Enum indicating the status for the session (pending, active, closed, etc).
Invalid, PreChatForm, Faq, OfflineForm, InQueue, CustomerLast, UserLast, Finished, Deleted, Closed, RequestPosted, ClosedFromQueue A copy of the first message in the chat session
A copy of the last message in the chat session
When the session was requested by the customer.
When the session was accepted by a user.
When the session was ended.
The last time anyone sent a message for this session.
The last time the customer's client refetched the data. Used to detect 'dead' session.
Key used to authenticate the session.
The initial queue pos (i.e. the number of pending sessions + 1) when the session was requested.
The alert level for this chat session.
Lowest possible unique number for active sessions for user. User for color index. Starting at 1.
Various flags for the chat session
CustomerIsTyping, UserIsTyping Carrier object for Contact. Services for the Contact Carrier is available from the Contact Agent.
Carrier object for Project. Services for the Project Carrier is available from the Project Agent.
Carrier object for Sale. Services for the Sale Carrier is available from the Sale Agent.
The ticket carrier is used for representing a service request. Carrier object for Ticket. Services for the Ticket Carrier is available from the Ticket Agent.
Carrier object for Associate. Services for the Associate Carrier is available from the Associate Agent.
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 of this chat conversation given by the customer
Wraps a table right together with an explanatory reason. Code can indicate why access is restricted.
Field property dictionary mapping field names to field access rights.
Related topics
Transfer Chat SessionSuperOffice.WebApi.Data.Chat TransferChatSessionRequestNSChatAgentSuperOffice.WebApi.Agents.ChatAgentSuperOffice.WebApi.Agents.IChatAgentAccept Chat Session Transfer