Chat

All the endpoints that can be called on the Chat controller.

All endpoints require the API_CHAT permission.

requestChatConfig

post

Requests chat configuration by this chat's details.

Authorizations

Body

chatServerstring · min: 5RequiredPattern: ^[a-zA-Z0-9\.\:\/\-]+$

chatAccountTokenstring · min: 10RequiredPattern: ^[a-zA-Z0-9]+$

Responses

post

HTTPcURLJavaScriptPython

POST /api/v2/chat/requestChatConfig HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 47

{
  "chatServer": "text",
  "chatAccountToken": "text"
}

200Success

No content

notifyUserNewChatMessage

post

Notifies the user of a new chat message.

Authorizations

Body

chatServerstring · min: 5RequiredPattern: ^[a-zA-Z0-9\.\:\/\-]+$

chatSessionIDstring · min: 10 · max: 65RequiredPattern: ^\+?[a-zA-Z0-9\-]+$

chatAccountTokenstring · min: 10RequiredPattern: ^[a-zA-Z0-9]+$

channelIDnumber · min: 1OptionalDefault: 8

messagestring · min: 1RequiredDefault: ""

urlstring · min: 1OptionalDefault: ""

messageNumbernumber · min: 1 · max: 50OptionalDefault: 1

usedPredefinedUserInputstring · min: 1OptionalDefault: false

additionalDatastring · min: 1OptionalDefault: ""

externalAddressOverwritestring · min: 1OptionalDefault: ""

customerNamestringOptionalPattern: ^[a-zA-Z 0-9]+$

emailAddressstring · emailOptional

phoneNumberstringOptionalPattern: ^\+[0-9]+$

Responses

post

HTTPcURLJavaScriptPython

POST /api/v2/chat/notifyUserNewChatMessage HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 298

{
  "chatServer": "text",
  "chatSessionID": "text",
  "chatAccountToken": "text",
  "channelID": 1,
  "message": "text",
  "url": "text",
  "messageNumber": 1,
  "usedPredefinedUserInput": "text",
  "additionalData": "text",
  "externalAddressOverwrite": "text",
  "customerName": "text",
  "emailAddress": "[e-mail]",
  "phoneNumber": "text"
}

200Success

No content

notifyUserNewChatEvent

post

Notifies the user of a new chat event.

Authorizations

Body

chatServerstring · min: 5RequiredPattern: ^[a-zA-Z0-9\.\:\/\-]+$

chatSessionIDstring · min: 10RequiredPattern: ^[a-zA-Z0-9\-]+$

eventstring · enumRequiredPossible values:

Responses

post

HTTPcURLJavaScriptPython

POST /api/v2/chat/notifyUserNewChatEvent HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 68

{
  "chatServer": "text",
  "chatSessionID": "text",
  "event": "startedtyping"
}

200Success

No content

notifyUserVisited

post

Notifies the user of a new chat URL visited.

Authorizations

Body

chatServerstring · min: 5RequiredPattern: ^[a-zA-Z0-9\.\:\/\-]+$

chatSessionIDstring · min: 10RequiredPattern: ^[a-zA-Z0-9\-]+$

urlstring · min: 4Required

Responses

post

HTTPcURLJavaScriptPython

POST /api/v2/chat/notifyUserVisited HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 57

{
  "chatServer": "text",
  "chatSessionID": "text",
  "url": "text"
}

200Success

No content

notifyUserEndChat

post

Notifies the user that the chat has ended.

Authorizations

Body

chatServerstring · min: 5RequiredPattern: ^[a-zA-Z0-9\.\:\/\-]+$

chatSessionIDstring · min: 10RequiredPattern: ^[a-zA-Z0-9\-]+$

Responses

post

HTTPcURLJavaScriptPython

POST /api/v2/chat/notifyUserEndChat HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 44

{
  "chatServer": "text",
  "chatSessionID": "text"
}

200Success

No content

addAttachment

post

Adds an attachment to the chat.

Authorizations

Query parameters

chatServerstring · min: 5RequiredPattern: ^[a-zA-Z0-9\.\:\/\-]+$

chatSessionIDstring · min: 10RequiredPattern: ^\+?[a-zA-Z0-9\-]+$

chatAccountTokenstring · min: 10RequiredPattern: ^[a-zA-Z0-9]+$

phoneNumberstringOptionalPattern: ^\+?[0-9]+$

messageNumbernumberOptional

Body

filestring · byteRequired

Responses

post

HTTPcURLJavaScriptPython

POST /api/v2/chat/addAttachment?chatServer=text&chatSessionID=text&chatAccountToken=text HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 19

{
  "file": "Ynl0ZXM="
}

200Success

No content

checkOriginAndIP

post

Checks the origin and IP address of this user.

Authorizations

Body

chatServerstring · min: 5RequiredPattern: ^[a-zA-Z0-9\.\:\/\-]+$

chatAccountTokenstring · min: 10RequiredPattern: ^[a-zA-Z0-9]+$

originstring · min: 1Required

The hostname from the domain to be checked.

Pattern: ^[a-zA-Z0-9\.\-]+$

ipstring · min: 5Required

Responses

post

HTTPcURLJavaScriptPython

POST /api/v2/chat/checkOriginAndIP HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 75

{
  "chatServer": "text",
  "chatAccountToken": "text",
  "origin": "text",
  "ip": "text"
}

200Success

No content

whitelistedDomainsAndBlacklistedIPs

get

Returns all the whitelisted domains and blacklisted IP addresses.

Authorizations

Responses

get

HTTPcURLJavaScriptPython

GET /api/v2/chat/whitelistedDomainsAndBlacklistedIPs HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Accept: */*

200Success

No content

requestChatQueue

post

Returns the chat queue.

Authorizations

Body

chatAccountTokenstring · min: 10RequiredPattern: ^[a-zA-Z0-9]+$

Responses

post

HTTPcURLJavaScriptPython

POST /api/v2/chat/requestChatQueue HTTP/1.1
Host: {{base_url}}
apiKey: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 27

{
  "chatAccountToken": "text"
}

200Success

No content