Событие (event)

bolt #8B5CF6

Тип event — для системных событий, изменений статусов, вебхуков от внешних сервисов. Каждое событие создаёт уведомление в ленте и привязывается к коду события для группировки и аналитики.

Как работает

Внешняя система (склад, CRM, доставка) отправляет событие через Webhook
Уведомление попадает в ленту, система регистрирует event_code
Все уведомления с одинаковым event_code группируются
Push-уведомление приходит на телефон (можно отключить флагом push: false)

Webhook API

POST /api/v1/webhook

{
  "title": "Обновление склада",
  "body": "Товар «Футболка мужская» перемещён на склад «Коледино»",
  "notification_type": "event",
  "priority": "normal",
  "push": true,
  "tags": ["склад", "логистика"],
  "payload": {
    "event_code": "warehouse_update",
    "event_title": "Обновление склада",
    "properties": [
      { "title": "Склад", "value": "Коледино" },
      { "title": "Товар", "value": "Футболка мужская" },
      { "title": "Количество", "value": "120 шт." }
    ]
  }
}

Обязательные поля: event_code — уникальный код события (строка).
Опциональные: event_title — название (если не передано, берётся event_code), properties — массив свойств {title, value}.

JS SDK — ручная отправка

notix.notify({
  title: 'Обновление склада',
  type: 'event',
  priority: 'normal',
  push: false,
  payload: {
    event_code: 'warehouse_update',
    event_title: 'Обновление склада',
    properties: [
      { title: 'Склад', value: 'Коледино' },
      { title: 'Товар', value: 'Футболка мужская' }
    ]
  }
});

Event не работает через data-атрибуты

Тип event не поддерживает авто-захват через data-notify на формах. Используйте только ручную отправку: notix.notify() (JS) или прямые запросы к Webhook API.

Коды событий

Коды событий (event_code) хранятся в справочнике. При первом появлении нового event_code он автоматически регистрируется. Вы можете управлять кодами через API:

# Просмотр кодов
curl -H "Authorization: Bearer ntx_..." \
  https://notix-hub.ru/api/v1/event-codes

# Добавить событие
curl -X POST -H "Authorization: Bearer ntx_..." \
  -H "Content-Type: application/json" \
  -d '{"event_code":"refund_request","title":"Запрос возврата"}' \
  https://notix-hub.ru/api/v1/event-codes

# Удалить событие
curl -X DELETE -H "Authorization: Bearer ntx_..." \
  https://notix-hub.ru/api/v1/event-codes/<id>

Что видно в ленте

Иконка: bolt (молния)
Цвет: #8B5CF6 (фиолетовый)
Заголовок: title уведомления
Код события: event_code + event_title
Свойства: таблица title → value из properties