Изменения

REST API · Новое

Права ключа по ресурсам и журнал вызовов

Ключу можно выдать только нужные права: leads:read, leads:write, dialogs:read, customers:read, employees:read, connectors:read, events:read. Прежние ключи «чтение» и «чтение и запись» работают как раньше. В настройках у каждого ключа — журнал вызовов за 30 дней.

REST API · Новое

Клиенты, контрагенты, подключения, лента событий

GET /customers и GET /counterparties — клиенты и компании из модуля «Клиенты»; GET /connectors — каналы и системы компании; GET /events — события за 30 дней по порядку, чтобы догнать пропущенное без вебхуков.

Вебхуки · Новое

Событие message.created

Новая реплика в диалоге — клиента, AI-сотрудника или сотрудника компании — с id диалога. id реплики совпадает с GET /dialogs/{id}/messages.

REST API · Новое

Заявка по id и её изменение

GET /leads/{id}; PATCH /leads/{id} меняет обработку (status) и стадию (stage) — например, когда сделку закрыли в вашей CRM — и отправляет вебхук lead.updated.

REST API · Новое

Переписка диалога и AI-сотрудники

GET /dialogs/{id} и GET /dialogs/{id}/messages — реплики клиента, AI-сотрудника и сотрудников компании по порядку; GET /employees — AI-сотрудники компании.

REST API · Новое

Idempotency-Key

Повтор POST /leads и PATCH /leads/{id} с тем же заголовком Idempotency-Key в течение 24 часов возвращает прежний ответ и ничего не создаёт заново.

Вебхуки · Новое

Повторы и журнал доставок

Если адрес не ответил 2xx, событие отправляется снова — до 8 попыток за сутки. Заголовки X-ChatNeuron-Webhook-Id (одинаков во всех повторах) и X-ChatNeuron-Delivery-Attempt. В настройках — журнал доставок за 30 дней и «Отправить снова». После 3 дней сбоев вебхук выключается с уведомлением владельцу.

Вебхуки · Новое

События lead.updated, dialog.handed_off, dialog.closed

Заявка изменилась (стадия, статус, контакты — с полем changes), диалог передан человеку (с выжимкой разговора), диалог закрыт.

REST API · Новое

Спецификация OpenAPI

Полное описание API v1 и вебхуков в формате OpenAPI 3.1 — GET /api/v1/openapi.json, без ключа. По нему можно сгенерировать клиент на любом языке.

REST API · Новое

Заголовки лимита и id запроса

Каждый ответ несёт X-Request-Id, успешные — X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset.

Документация · Новое

Справочник API и событий

Страница на каждый раздел API: поля ресурса, параметры, примеры на cURL, Node.js и Python, ответы и ошибки. Справочник событий вебхуков.

REST API · Новое

REST API v1

Ключи cn_live_ с правами на чтение или запись, GET /me, GET /leads, POST /leads, GET /dialogs, курсорные страницы, 120 запросов в минуту на ключ.

Вебхуки · Новое

Исходящие вебхуки

События lead.created и dialog.started, подпись X-ChatNeuron-Signature (HMAC-SHA256), до 10 адресов на компанию.