К содержанию
sapportlydocs
Панель

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

Совместимые добавления публичного контракта. Мажор пути /v1 не ломаем без анонса.

1.6.0 — 2026-09-19

  • Вложения стали первым классом сообщений: presigned upload, проверка типа и размера, безопасный download и поддержка нескольких attachment_ids в одном ответе.
  • Добавлены публичные операции назначения, передачи и истории назначения диалога. Передача сохраняет аудит и не меняет ключ треда.
  • Вебхуки поддерживают несколько endpoint-ов с тарифным лимитом, независимым включением, тестовой доставкой и неизменяемым после создания secret.
  • Visitor API получил безопасный identify, статус шифрования канала и E2EE-handshake. Приватные ключи посетителя никогда не выдаются API-ключу интегратора.
  • Realtime-контракт уточнён: одноразовый ticket, дедупликация по message/event id и восстановление истории через REST после reconnect.

1.5.0 — 2026-08-20

  • Треды custom-каналов: приём входящих с identity.external_id или thread_id пишет в namespace:slug:{uuid}. Источник в реестре и аналитике без изменений. Без identity — прежняя общая лента источника.
  • Accept при приёме входящих: channel, source_channel, thread_id. Саммари диалога: те же поля плюс external_id.
  • Ответ из панели адресует тред. Интеграторский WS / вебхук исходящего несёт external_id для доставки человеку.

1.4.0 — 2026-08-19

  • Структурированные ошибки: type, code, message, request_id, docs_url. Поле error сохранено.
  • Заголовки X-Request-Id, X-RateLimit-Limit, X-RateLimit-Remaining.
  • Опциональный конверт списков: ?envelope=true или X-Sapportly-List-Envelope: 1.
  • Idempotency-Key на приём входящих и ответ (тело побеждает заголовок).
  • GET/PUT /v1/contacts, публичные /v1/webhooks, JSON /v1/rag/documents.
  • Саммари диалога дополнено данными назначения, посетителя, непрочитанных и уровня шифрования. Закрытие и архивирование остаются отдельными операциями панели.
  • POST /v1/conversations/{channel}/messages принимает любой канал-источник (custom:shop, не только widget:{uuid}).
  • Из публичной спеки убраны ops (/health, /metrics) и billing callback.

Страница полезна?

/docs/api/changelog
История изменений публичного API — совместимые добавления · Sapportly Docs