История изменений

Что менялось в публичном API.

Как мы меняем API

Добавления не ломают ничего и выходят без предупреждения. Новое поле в ответе, новый необязательный параметр, новый метод, новое событие вебхука — всё это может появиться в любой момент. Ваш код должен спокойно относиться к незнакомым полям в ответе.

Ломающие изменения означают новую версию — /v2/. Старая версия проживёт не меньше шести месяцев после выхода новой, и мы предупредим заранее.

Что мы считаем ломающим изменением: удаление или переименование поля, метода, кода ошибки, области доступа или события вебхука; новое обязательное поле в запросе; изменение типа поля.

v1.4.0 — 13 сентября 2026

Подключение ассистента стало проще. Старые подключения продолжают работать.

• Ключ для подключения больше не нужен. Вы входите под собой, и ассистент

действует вашими правами — включая ограничение видимости диалогов, если оно у вас есть. Раньше сначала требовалось завести ключ и расставить тринадцать галочек.

• Права подключения — переключатель «Чтение» / «Чтение и запись». Меняется в

кабинете, без переподключения.

• Ключ остался для одного случая: дать ассистенту меньше, чем есть у вас.

На экране согласия это свёрнутая строка.

• Адрес один. /mcp/readonly продолжает работать у тех, кто уже его вставил,

но из кабинета убран: переключатель делает то же самое понятнее.

v1.3.0 — 13 сентября 2026

Свой MCP-сервер. Дополнение: в REST-части не изменилось ничего.

• Два адреса: /mcp — всё, что разрешает ключ, и /mcp/readonly — только

чтение, где ни одно действие недоступно даже ключу, который их разрешает.

• 19 инструментов, собранных как задачи целиком, а не как методы API. Список,

который видит программа, собирается под конкретный ключ: чего ключ не разрешает, того в списке нет.

• Вход через OAuth 2.1 с PKCE — программа сама регистрируется, человек в

кабинете выбирает ключ и подтверждает. Обычный ключ API в заголовке тоже работает, без экрана согласия.

• Ответ клиенту не отправляется сразу: инструмент возвращает ссылку, по

которой человек видит точный текст и нажимает «Отправить». Проверка на нашей стороне, обойти её нельзя.

• Текст, написанный клиентом, приходит модели помеченным как чужой.
• Подключённые программы видны в Настройках → API, отключаются одной кнопкой.

Подробности — в руководстве «Подключение ассистента (MCP)».

v1.2.0 — 13 сентября 2026

Запись в справку и встречи. Дополнение: ничего существующего не изменилось.

• Область доступа kb:write — создание и правка статей и категорий. Тело

статьи принимается в Markdown. Удаления нет и права на него у ключа нет: убрать опубликованное может только человек в кабинете.

• Новая статья создаётся черновиком. Публикация — отдельным параметром, и она

же кладёт статью в поиск ИИ-оператора.

• Область доступа conferences:read — встречи со сводками, решениями и

расшифровками. Требует и права на встречи, и права на расшифровки.

• Два события вебхука: conference.ended (разговор закончился — всегда) и

conference.transcript_ready (расшифровка и сводка готовы — только там, где была запись).

Подробности — в руководствах «Запись в справку» и «Встречи».

v1.1.0 — 13 сентября 2026

Аналитика. Дополнение: ничего существующего не изменилось и не удалено.

• Новая область доступа analytics:read. Она включает и денежные отчёты,

поэтому создать такой ключ может только сотрудник, у которого есть права и на аналитику, и на выручку, и который видит все диалоги.

• Семь отчётов: сводка, каналы, команды, сотрудники, выручка, качество диалогов

и работа ИИ-оператора. Плюс filters — допустимые значения фильтров.

• У всех отчётов одинаковые параметры: период from/to и фильтры по каналам,

командам и сотрудникам. Период — не длиннее 366 дней.

• Курсора в отчётах нет: отчёт это готовый ответ целиком, а не страница списка.

Подробности — в руководстве «Аналитика».

v1.0.0 — 12 сентября 2026

Первая версия.

• Ключи проекта с правами вида ресурс:действие.
• Чтение: диалоги, сообщения, контакты, компании клиентов, теги, сотрудники, команды, справка.
• Изменение: статус и назначение диалога, теги, ответ клиенту и внутренняя заметка, создание и правка контактов и компаний.
• Вебхуки: восемь событий, подпись HMAC-SHA256, повторы, журнал отправок за 7 дней.
• Постраничная выдача курсором, единый формат ошибок с номером запроса, Idempotency-Key, лимиты запросов с заголовками.