Skip to Content

VendorChatApi

All URIs are relative to https://business.apis.kesk.app/v1 

MethodHTTP requestDescription
vendorGetChatGET /vendors/{vendor_id}/chats/{session_id}Get chat session details
vendorGetChatMediaGET /vendors/{vendor_id}/chats/{session_id}/media/{media_id}Get a specific media item from a vendor chat session
vendorGetChatMessagesGET /vendors/{vendor_id}/chats/{session_id}/messagesGet chat messages
vendorListChatMediaGET /vendors/{vendor_id}/chats/{session_id}/mediaList all media in a vendor chat session
vendorListChatsGET /vendors/{vendor_id}/chatsList vendor chat sessions
vendorSendChatMessagePOST /vendors/{vendor_id}/chats/{session_id}/messagesSend a message in chat
vendorUploadChatMediaPOST /vendors/{vendor_id}/chats/{session_id}/mediaUpload media for a vendor chat session

vendorGetChat

VendorChatSessionResponse vendorGetChat(vendor_id, session_id)

Get chat session details

Retrieves details of a specific chat session including metadata.

Parameters

NameTypeDescriptionNotes
vendor_idLong[default to null]
session_idLong[default to null]

Return type

VendorChatSessionResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8

vendorGetChatMedia

VendorChatMediaResponse vendorGetChatMedia(vendor_id, session_id, media_id)

Get a specific media item from a vendor chat session

Retrieves information about a specific media file in a chat session.

Parameters

NameTypeDescriptionNotes
vendor_idLong[default to null]
session_idLong[default to null]
media_idLong[default to null]

Return type

VendorChatMediaResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8

vendorGetChatMessages

VendorChatMessagesResponse vendorGetChatMessages(vendor_id, session_id, limit, before_message_id)

Get chat messages

Retrieves messages from a chat session with pagination support.

Parameters

NameTypeDescriptionNotes
vendor_idLong[default to null]
session_idLong[default to null]
limitInteger[optional] [default to null]
before_message_idLong[optional] [default to null]

Return type

VendorChatMessagesResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8

vendorListChatMedia

List vendorListChatMedia(vendor_id, session_id, limit, offset)

List all media in a vendor chat session

Retrieves a paginated list of all media files in a chat session.

Parameters

NameTypeDescriptionNotes
vendor_idLong[default to null]
session_idLong[default to null]
limitInteger[optional] [default to null]
offsetInteger[optional] [default to null]

Return type

List

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8

vendorListChats

VendorChatSessionListResponse vendorListChats(vendor_id, limit, before)

List vendor chat sessions

Retrieves all chat sessions for the specified vendor with pagination support. Returns chat sessions ordered by most recent activity.

Parameters

NameTypeDescriptionNotes
vendor_idLong[default to null]
limitInteger[optional] [default to null]
beforeString[optional] [default to null]

Return type

VendorChatSessionListResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8

vendorSendChatMessage

VendorChatMessageResponse vendorSendChatMessage(vendor_id, session_id, VendorSendMessageRequest)

Send a message in chat

Sends a message in the chat session as a vendor representative.

Parameters

NameTypeDescriptionNotes
vendor_idLong[default to null]
session_idLong[default to null]
VendorSendMessageRequestVendorSendMessageRequest

Return type

VendorChatMessageResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: application/json; charset=utf-8
  • Accept: application/json; charset=utf-8

vendorUploadChatMedia

VendorChatMediaUploadResponse vendorUploadChatMedia(vendor_id, session_id, file)

Upload media for a vendor chat session

Uploads a file (image, audio, video, or document) to be used in a chat message. Returns media information including the URL to include in the message payload.

Parameters

NameTypeDescriptionNotes
vendor_idLong[default to null]
session_idLong[default to null]
fileFileThe file to upload[default to null]

Return type

VendorChatMediaUploadResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json; charset=utf-8