Семейство: notify

norm_notify

Уведомить человека о том, что требует его внимания: о незаполненном, о неуверенно определённом, о готовности. Получатель — идентификатор человека из norm_people_list; meeting_id связывает уведомление со встречей и её протоколом, канал доставки выбирает реализация. Уровень warning требует внимания, info — норма. Разница существенная: warning по той же встрече СНИМАЕТ ваши прежние предупреждения, а info накапливается как история. Поэтому в новом предупреждении перечисляйте всё нерешённое заново, а не только изменения. Если к следующему прогону всё дозаполнено и писать нечего — вызовите с clear_only: true и meeting_id: прежние предупреждения снимутся, новых не появится. Без clear_only обязательны recipient_id и text; при clear_only обязателен meeting_id. Умолчание уровня — warning. Ответ delivered: false — доставлять было некуда (протокол ещё не создан или удалён), это не сбой. Доменные состояния: unknown_user — получателя нет в системе компании; not_ready, temporary, rate_limited.

Доступ: запись · Списковый: нет · Версии: 1

Вход

Поле	Обязательно	Тип	Значение
clear_only	нет	boolean
level	нет	warning | info
meeting_id	нет	string
recipient_id	нет	string
text	нет	string

Данные ответа

Поле	При успехе	Тип	Значение
cleared	да	integer
delivered	да	boolean
error	нет	DomainError	Доменное состояние
level	да	warning | info
note	нет	string

Пример: успешный ответ

{
  "source_refs": [
    {
      "source": "company-data",
      "ref": "meeting:01K9F2QH7T8ZRC4M0X5B2VNJ3D:notify",
      "label": "Уведомление по встрече"
    }
  ],
  "freshness": {
    "as_of": "2026-09-21T09:32:00.000Z",
    "ttl_sec": 0,
    "stale": false
  },
  "data": {
    "delivered": true,
    "cleared": 1,
    "level": "warning"
  }
}

Пример: случай «domain_error»

{
  "source_refs": [
    {
      "source": "company-data",
      "ref": "meeting:01K9F2QH7T8ZRC4M0X5B2VNJ3D:notify"
    }
  ],
  "freshness": {
    "as_of": "2026-09-21T09:32:00.000Z",
    "ttl_sec": 0,
    "stale": false
  },
  "data": {
    "delivered": false,
    "error": {
      "code": "unknown_user",
      "message": "Получателя с таким идентификатором нет в системе компании.",
      "retryable": false
    }
  }
}