KronclAPI
Мои приложения
Введение
Публичные методы
Аккаунт
Компания
Базовые действия
Хранилище
Тарификация
Участники
Логи
Документы
Поддержка
GET Список тикетов
POST Создать тикет
GET Тикет
PATCH Обновить статус
GET Сообщения
POST Отправить
PATCH Прочитатать
Персонал (HRM)
Финансы (FM)
Клиенты (CRM)
Склад (WM)
Сделки (DM)
Создать приложение
Документация API платформы. Последняя сборка v1.5.30

Поддержка

Методы для работы с тикетами технической поддержки.

Лимиты

SUPPORT_LIMITS:
no-format
max_pending_ticketsrequired
int
Макс. открытых
Максимальное количество открытых тикетов (10)
max_messages_in_rowrequired
int
Макс. сообщений подряд
Максимальное количество сообщений подряд от одного аккаунта (3)

# Получение тикетов

GET
/companies/{id}/modules/support/tickets

Возвращает список тикетов организации с пагинацией.

Структура ответа

RESPONSE_DATA:
application/json
ticketsrequired
array
Тикеты
Список тикетов (Ticket[])
paginationrequired
array
pagination

Тикет

TICKET:
application/json
idrequired
string
ID
Уникальный идентификатор тикета
company_idrequired
string
ID компании
Идентификатор организации
initiator_idrequired
string
ID инициатора
Идентификатор создателя тикета
themerequired
enum
technical_issuebilling_paymentaccess_rightsfeature_requestconsultation
Тема
Тема обращения
statusrequired
enum
pendingclosedrevoked
Статус
Статус тикета
last_messagerequired
array
Последнее сообщение
Последнее сообщение в тикете (Message)
created_atrequired
string
Создан
Дата создания (RFC 3339)
updated_atrequired
string
Обновлён
Дата последнего обновления (RFC 3339)

Примеры ответов

200
{
    "status": true,
    "message": "Tickets retrieved successfully",
    "data": {
        "tickets": [
            {
                "id": "cc0e8400-e29b-41d4-a716-446655440110",
                "company_id": "660e8400-e29b-41d4-a716-446655440020",
                "initiator_id": "550e8400-e29b-41d4-a716-446655440001",
                "theme": "technical_issue",
                "status": "pending",
                "created_at": "2026-06-14T12:00:00Z",
                "updated_at": "2026-06-14T12:00:00Z",
                "last_message": {
                    "id": "dd0e8400-e29b-41d4-a716-446655440120",
                    "account_id": "550e8400-e29b-41d4-a716-446655440001",
                    "ticket_id": "cc0e8400-e29b-41d4-a716-446655440110",
                    "text": "Проблема с доступом к модулю финансов",
                    "read": true,
                    "is_tech": false,
                    "created_at": "2026-06-14T12:00:00Z",
                    "updated_at": "2026-06-14T12:00:00Z"
                }
            }
        ],
        "pagination": {
            "total": 1,
            "page": 1,
            "limit": 20,
            "pages": 1
        }
    },
    "meta": {
        "timestamp": "2026-06-14T12:00:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/support/tickets",
        "method": "GET"
    }
}

# Создание тикета

POST
/companies/{id}/modules/support/tickets

Создаёт новый тикет. Первое сообщение передаётся в теле запроса.

Структура запроса

CREATE_REQUEST:
application/json
themerequired
enum
technical_issuebilling_paymentaccess_rightsfeature_requestconsultation
Тема
Тема обращения
textrequired
string
Текст
Текст первого сообщения

Структура ответа

TICKET:
application/json
idrequired
string
ID
Уникальный идентификатор тикета
company_idrequired
string
ID компании
Идентификатор организации
initiator_idrequired
string
ID инициатора
Идентификатор создателя тикета
themerequired
enum
technical_issuebilling_paymentaccess_rightsfeature_requestconsultation
Тема
Тема обращения
statusrequired
enum
pendingclosedrevoked
Статус
Статус тикета
last_messagerequired
array
Последнее сообщение
Последнее сообщение в тикете (Message)
created_atrequired
string
Создан
Дата создания (RFC 3339)
updated_atrequired
string
Обновлён
Дата последнего обновления (RFC 3339)

Примеры ответов

201
{
    "status": true,
    "message": "Ticket created successfully",
    "data": {
        "id": "cc0e8400-e29b-41d4-a716-446655440110",
        "company_id": "660e8400-e29b-41d4-a716-446655440020",
        "initiator_id": "550e8400-e29b-41d4-a716-446655440001",
        "theme": "technical_issue",
        "status": "pending",
        "created_at": "2026-06-14T12:00:00Z",
        "updated_at": "2026-06-14T12:00:00Z",
        "last_message": {
            "id": "dd0e8400-e29b-41d4-a716-446655440120",
            "account_id": "550e8400-e29b-41d4-a716-446655440001",
            "ticket_id": "cc0e8400-e29b-41d4-a716-446655440110",
            "text": "Проблема с доступом к модулю финансов",
            "read": true,
            "is_tech": false,
            "created_at": "2026-06-14T12:00:00Z",
            "updated_at": "2026-06-14T12:00:00Z"
        }
    },
    "meta": {
        "timestamp": "2026-06-14T12:00:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/support/tickets",
        "method": "POST"
    }
}

# Получение тикета

GET
/companies/{id}/modules/support/tickets/{ticketId}

Возвращает один тикет по идентификатору.

Структура ответа

TICKET:
application/json
idrequired
string
ID
Уникальный идентификатор тикета
company_idrequired
string
ID компании
Идентификатор организации
initiator_idrequired
string
ID инициатора
Идентификатор создателя тикета
themerequired
enum
technical_issuebilling_paymentaccess_rightsfeature_requestconsultation
Тема
Тема обращения
statusrequired
enum
pendingclosedrevoked
Статус
Статус тикета
last_messagerequired
array
Последнее сообщение
Последнее сообщение в тикете (Message)
created_atrequired
string
Создан
Дата создания (RFC 3339)
updated_atrequired
string
Обновлён
Дата последнего обновления (RFC 3339)

Примеры ответов

200
{
    "status": true,
    "message": "Ticket retrieved successfully",
    "data": {
        "id": "cc0e8400-e29b-41d4-a716-446655440110",
        "company_id": "660e8400-e29b-41d4-a716-446655440020",
        "initiator_id": "550e8400-e29b-41d4-a716-446655440001",
        "theme": "technical_issue",
        "status": "pending",
        "created_at": "2026-06-14T12:00:00Z",
        "updated_at": "2026-06-14T12:00:00Z",
        "last_message": {
            "id": "dd0e8400-e29b-41d4-a716-446655440120",
            "account_id": "550e8400-e29b-41d4-a716-446655440001",
            "ticket_id": "cc0e8400-e29b-41d4-a716-446655440110",
            "text": "Проблема с доступом к модулю финансов",
            "read": true,
            "is_tech": false,
            "created_at": "2026-06-14T12:00:00Z",
            "updated_at": "2026-06-14T12:00:00Z"
        }
    },
    "meta": {
        "timestamp": "2026-06-14T12:00:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/support/tickets/...",
        "method": "GET"
    }
}

# Обновление статуса тикета

PATCH
/companies/{id}/modules/support/tickets/{ticketId}

Изменяет статус тикета: закрыть или отозвать.

Структура запроса

UPDATE_STATUS:
application/json
statusrequired
enum
pendingclosedrevoked
Статус
Новый статус тикета

Структура ответа

TICKET:
application/json
idrequired
string
ID
Уникальный идентификатор тикета
company_idrequired
string
ID компании
Идентификатор организации
initiator_idrequired
string
ID инициатора
Идентификатор создателя тикета
themerequired
enum
technical_issuebilling_paymentaccess_rightsfeature_requestconsultation
Тема
Тема обращения
statusrequired
enum
pendingclosedrevoked
Статус
Статус тикета
last_messagerequired
array
Последнее сообщение
Последнее сообщение в тикете (Message)
created_atrequired
string
Создан
Дата создания (RFC 3339)
updated_atrequired
string
Обновлён
Дата последнего обновления (RFC 3339)

Примеры ответов

200
{
    "status": true,
    "message": "Ticket status updated successfully",
    "data": {
        "id": "cc0e8400-e29b-41d4-a716-446655440110",
        "company_id": "660e8400-e29b-41d4-a716-446655440020",
        "initiator_id": "550e8400-e29b-41d4-a716-446655440001",
        "theme": "technical_issue",
        "status": "closed",
        "created_at": "2026-06-14T12:00:00Z",
        "updated_at": "2026-06-14T12:05:00Z",
        "last_message": {
            "id": "dd0e8400-e29b-41d4-a716-446655440120",
            "account_id": "550e8400-e29b-41d4-a716-446655440001",
            "ticket_id": "cc0e8400-e29b-41d4-a716-446655440110",
            "text": "Проблема с доступом к модулю финансов",
            "read": true,
            "is_tech": false,
            "created_at": "2026-06-14T12:00:00Z",
            "updated_at": "2026-06-14T12:00:00Z"
        }
    },
    "meta": {
        "timestamp": "2026-06-14T12:05:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/support/tickets/...",
        "method": "PATCH"
    }
}

# Сообщения тикета

GET
/companies/{id}/modules/support/tickets/{ticketId}/messages

Возвращает список сообщений тикета с пагинацией.

Структура ответа

RESPONSE_DATA:
application/json
messagesrequired
array
Сообщения
Список сообщений (Message[])
paginationrequired
array
pagination

Сообщение

MESSAGE:
application/json
idrequired
string
ID
Уникальный идентификатор сообщения
account_idrequired
string
ID аккаунта
Идентификатор автора
ticket_idrequired
string
ID тикета
Идентификатор тикета
textrequired
string
Текст
Текст сообщения
readrequired
boolean
Прочитано
Статус прочтения
is_techrequired
boolean
Техподдержка
Отправлено техподдержкой
created_atrequired
string
Создано
Дата создания (RFC 3339)
updated_atrequired
string
Обновлено
Дата последнего обновления (RFC 3339)

Примеры ответов

200
{
    "status": true,
    "message": "Messages retrieved successfully",
    "data": {
        "messages": [
            {
                "id": "dd0e8400-e29b-41d4-a716-446655440120",
                "account_id": "550e8400-e29b-41d4-a716-446655440001",
                "ticket_id": "cc0e8400-e29b-41d4-a716-446655440110",
                "text": "Проблема с доступом к модулю финансов",
                "read": true,
                "is_tech": false,
                "created_at": "2026-06-14T12:00:00Z",
                "updated_at": "2026-06-14T12:00:00Z"
            }
        ],
        "pagination": {
            "total": 1,
            "page": 1,
            "limit": 20,
            "pages": 1
        }
    },
    "meta": {
        "timestamp": "2026-06-14T12:00:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/support/tickets/.../messages",
        "method": "GET"
    }
}

# Создание сообщения

POST
/companies/{id}/modules/support/tickets/{ticketId}/messages

Отправляет новое сообщение в тикет.

Структура запроса

CREATE_MESSAGE:
application/json
textrequired
string
Текст
Текст сообщения

Структура ответа

MESSAGE:
application/json
idrequired
string
ID
Уникальный идентификатор сообщения
account_idrequired
string
ID аккаунта
Идентификатор автора
ticket_idrequired
string
ID тикета
Идентификатор тикета
textrequired
string
Текст
Текст сообщения
readrequired
boolean
Прочитано
Статус прочтения
is_techrequired
boolean
Техподдержка
Отправлено техподдержкой
created_atrequired
string
Создано
Дата создания (RFC 3339)
updated_atrequired
string
Обновлено
Дата последнего обновления (RFC 3339)

Примеры ответов

201
{
    "status": true,
    "message": "Message created successfully",
    "data": {
        "id": "dd0e8400-e29b-41d4-a716-446655440121",
        "account_id": "550e8400-e29b-41d4-a716-446655440001",
        "ticket_id": "cc0e8400-e29b-41d4-a716-446655440110",
        "text": "Дополнительная информация по проблеме",
        "read": false,
        "is_tech": false,
        "created_at": "2026-06-14T12:05:00Z",
        "updated_at": "2026-06-14T12:05:00Z"
    },
    "meta": {
        "timestamp": "2026-06-14T12:05:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/support/tickets/.../messages",
        "method": "POST"
    }
}

# Прочитать сообщение

PATCH
/companies/{id}/modules/support/tickets/{ticketId}/messages/{messageId}

Изменяет статус прочтения сообщения.

Структура запроса

UPDATE_READ:
application/json
readrequired
boolean
Прочитано
Новый статус прочтения

Структура ответа

MESSAGE:
application/json
idrequired
string
ID
Уникальный идентификатор сообщения
account_idrequired
string
ID аккаунта
Идентификатор автора
ticket_idrequired
string
ID тикета
Идентификатор тикета
textrequired
string
Текст
Текст сообщения
readrequired
boolean
Прочитано
Статус прочтения
is_techrequired
boolean
Техподдержка
Отправлено техподдержкой
created_atrequired
string
Создано
Дата создания (RFC 3339)
updated_atrequired
string
Обновлено
Дата последнего обновления (RFC 3339)

Примеры ответов

200
{
    "status": true,
    "message": "Message read status updated successfully",
    "data": {
        "id": "dd0e8400-e29b-41d4-a716-446655440121",
        "account_id": "550e8400-e29b-41d4-a716-446655440001",
        "ticket_id": "cc0e8400-e29b-41d4-a716-446655440110",
        "text": "Дополнительная информация по проблеме",
        "read": true,
        "is_tech": false,
        "created_at": "2026-06-14T12:05:00Z",
        "updated_at": "2026-06-14T12:10:00Z"
    },
    "meta": {
        "timestamp": "2026-06-14T12:10:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/support/tickets/.../messages/...",
        "method": "PATCH"
    }
}