справочник API · v1

События

Лента событий компании за 30 дней — те же, что уходят в исходящие вебхуки. Чтобы догнать пропущенное или обойтись без вебхуков.

get/events— Лента событий

Ресурс `Event`

Поле	Описание
`id`string (uuid)	Id события — тот же, что в X-ChatNeuron-Webhook-Id.
`event`string	Тип: `lead.created`, `lead.updated`, `dialog.started`, `dialog.handed_off`, `dialog.closed`, `message.created`.
`createdAt`string (date-time)	Когда произошло.
`data`object	Как `data` в вебхуке этого события — см. справочник событий.

Лента событий

get/api/v1/events

События компании за 30 дней по порядку — старые первыми. Запомните id последнего обработанного и продолжайте с него через cursor; since — с какой даты начать. type — только одно событие, например lead.created.

Право ключа: Лента событий · events:read

curl "https://app.chatneuron.ru/api/v1/events?since=2026-10-01T00%3A00%3A00Z&limit=50" \
  -H "Authorization: Bearer cn_live_…"

Параметры запроса

Параметр	Описание
`since`string (date-time)	Брать записи с этой даты (ISO 8601).
`type`string	Только события этого типа. · одно из: lead.created, lead.updated, dialog.started, dialog.handed_off, dialog.closed, message.created
`limit`integer	Сколько записей на странице. · 1–100 · по умолчанию 50
`cursor`string	`nextCursor` из прошлого ответа.

Ответ 200

Страница событий.

JSON

{
  "data": [
    {
      "id": "9b2f6c1e-4a7d-4f0e-9c3b-1d2e3f4a5b6c",
      "event": "lead.created",
      "createdAt": "2026-10-27T09:15:02.114Z",
      "data": {
        "id": "cmv8k2x1q0001abcd",
        "name": "Анна",
        "phone": "+79991234567"
      }
    }
  ],
  "nextCursor": null
}

Ошибки

Статус	code	Когда
400	`invalid_request`	Некорректные параметры или тело запроса.
401	`unauthorized`	Нет ключа, ключ неверный или отозван.
403	`forbidden`	У ключа нет нужного права — оно указано в тексте ошибки.
429	`rate_limited`	Больше 120 запросов в минуту. Повторите через Retry-After секунд.

Дальше

Общие правила — ключи, лимиты, ошибки, страницы — в обзоре API. Узнавать о событиях сразу, без опроса, — через исходящие вебхуки.