Dialogi
Начать бесплатно

Справочник · Вебхуки

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

События, отправленные на адреса вебхуков компании за последние 30 дней. Лента нужна, чтобы догнать пропущенное: например, если ваш сервер был недоступен. В ней только события, на которые подписан хотя бы один адрес компании, - то же тело, что ушло на адрес. Ключ видит события только тех ресурсов, которые может читать, и только своих проектов.

Объект события

Событие - то же тело, что Dialogi присылает на адрес вебхуков. См. События.

iduuidобязателен

id события. Одно и то же во всех повторах отправки - по нему отсекайте дубли.

objectстрокаобязателен

Тип объекта, всегда event.

Значения: event

typeстрокаобязателен

Тип события, например lead.created. Список типов пополняется: незнакомый тип пропускайте. См. События.

created_atдата и время с зонойобязателен

Когда произошло событие, UTC.

project_iduuidобязателен

id проекта события.

testлогическоеобязателен

true - тестовое событие с образцом объекта. В ленте событий тестовых нет.

dataобъектобязателен

Данные события.

Вложенные поля: 1
objectобъектобязателен

Объект события - такой же, как в ответе GET этого ресурса: диалог, сообщение, контакт, заявка или запись. Это снимок на момент, когда событие сформировано: актуальное состояние - через GET. У contact.deleted - только object, id и deleted: true. Тело больше 256 КБ приходит без полей объекта, только object и id.

Вложенные поля: 3
objectстрокаобязателен

Тип объекта: conversation, message, contact, lead или appointment.

iduuidобязателен

id объекта.

Остальные поля

Остальные поля объекта - как в GET этого ресурса.

Объект события 
{
  "id": "01926f3c-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
  "object": "event",
  "type": "lead.created",
  "created_at": "2026-09-28T11:01:30Z",
  "project_id": "01926f3c-0000-7000-8000-000000000001",
  "test": false,
  "data": {
    "object": {
      "object": "lead",
      "id": "01926f3c-2b3c-7d4e-8f5a-6b7c8d9e0f1a"
    }
  }
}
GET/v1/events

Список событий

Право: webhooks:manage

События от новых к старым, по страницам. Фильтры можно сочетать.

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

limitцелое числоможет быть null

Сколько событий на странице, от 1 до 100.

По умолчанию: 20

starting_afteruuidможет быть null

id последнего события предыдущей страницы: страница начнётся после него. См. Пагинация.

project_iduuidможет быть null

Только события этого проекта. Проекта нет в ключе - ошибка 403.

typeстрокаможет быть null

Только события этого типа, точное совпадение.

Ответы

  • 200Страница списка событий.
  • 401Нет ключа, ключ неверный, истёк или отозван (unauthenticated).
  • 402У компании не подключено дополнение «Публичный API» (api-addon-required).
  • 403У ключа нет нужного права или доступа к проекту (forbidden).
  • 422Данные запроса не прошли проверку (validation). Какие поля и почему - в errors.
  • 429Превышен лимит запросов (rate-limited). Повторите через столько секунд, сколько указано в Retry-After.
  • 503Сервис временно недоступен (unavailable). Повторите позже.
Запрос 
curl https://api.ru.dialogi.io/v1/events \
  -H "Authorization: Bearer dk_live_…"
Ответ 200
{
  "object": "list",
  "data": [
    {
      "id": "01926f3c-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
      "object": "event",
      "type": "lead.created",
      "created_at": "2026-09-28T11:01:30Z",
      "project_id": "01926f3c-0000-7000-8000-000000000001",
      "test": false,
      "data": {
        "object": {
          "object": "lead",
          "id": "01926f3c-2b3c-7d4e-8f5a-6b7c8d9e0f1a"
        }
      }
    }
  ],
  "has_more": true
}
GET/v1/events/{event}

Получить событие

Право: webhooks:manage

Событие по id. Событие старше 30 дней, тестовое, недоступное ключу или не отправленное ни на один адрес - ответ 404.

Параметры пути

eventuuidобязателен

id события.

Ответы

  • 200Событие.
  • 401Нет ключа, ключ неверный, истёк или отозван (unauthenticated).
  • 402У компании не подключено дополнение «Публичный API» (api-addon-required).
  • 403У ключа нет нужного права или доступа к проекту (forbidden).
  • 404Объекта с таким id нет или он в проекте, которого нет в ключе (not-found).
  • 429Превышен лимит запросов (rate-limited). Повторите через столько секунд, сколько указано в Retry-After.
  • 503Сервис временно недоступен (unavailable). Повторите позже.
Запрос 
curl https://api.ru.dialogi.io/v1/events/0192d3a1-7b2c-7c3e-9a51-2f6b8e4d1c90 \
  -H "Authorization: Bearer dk_live_…"
Ответ 200
{
  "id": "01926f3c-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
  "object": "event",
  "type": "lead.created",
  "created_at": "2026-09-28T11:01:30Z",
  "project_id": "01926f3c-0000-7000-8000-000000000001",
  "test": false,
  "data": {
    "object": {
      "object": "lead",
      "id": "01926f3c-2b3c-7d4e-8f5a-6b7c8d9e0f1a"
    }
  }
}