Тема
Каталог инструментов
Каталог открытый: ни один инструмент не обязателен. Сервер реализует те семейства, данные для которых у бизнеса есть, и может добавлять собственные инструменты без префикса norm_.
| Инструмент | Семейство | Доступ | Назначение |
|---|---|---|---|
norm_meetings_list | Встречи | чтение | Встречи компании за интервал дат. |
norm_meeting_get | Встречи | чтение | Карточка одной встречи по id: название, время, участники, организатор, повестка и ссылка — шапка протокола. |
norm_meeting_transcript | Встречи | чтение | Расшифровка встречи окном — единственный источник содержания встречи. |
norm_calendar_events_list | Календарь | чтение | События календарей сотрудников за дни from–to: что запланировано, кто приглашён, что отменили. |
norm_protocol_types | Протоколы встреч | чтение | Типы встреч компании и подсказки к ним — весь справочник одним ответом, спрашивайте один раз за прогон. |
norm_protocols_list | Протоколы встреч | чтение | Протоколы компании страницами, от свежих к старым по дате встречи. |
norm_protocol_get | Протоколы встреч | чтение | Протокол одной встречи по meeting_id целиком: ядро, тело, дополнительные поля, ссылка. |
norm_protocol_upsert | Протоколы встреч | запись | Создать или переписать протокол встречи: ядро полей плюс тело в markdown. |
norm_meeting_reviews_list | Разборы встреч | чтение | Разборы встреч компании страницами, от свежих к старым по дню встречи. |
norm_meeting_reviews_upsert | Разборы встреч | запись | Записать разборы встреч пачкой — от 1 до 50 за вызов. |
norm_meeting_advice_get | Разборы встреч | чтение | Последний набор рекомендаций агента по встречам компании за период: до пяти шагов «что изменить» с эффектом в человеко-минутах. |
norm_meeting_advice_upsert | Разборы встреч | запись | Записать набор рекомендаций агента за период. |
norm_org_units | Люди и оргструктура | чтение | Дерево подразделений компании целиком. |
norm_people_list | Люди и оргструктура | чтение | Сотрудники компании страницами. |
norm_hour_costs_list | Люди и оргструктура | чтение | Стоимость часа сотрудников страницами: ставки «с — по — сумма в час». |
norm_roles_list | Люди и оргструктура | чтение | Роли компании страницами: то, чем занимаются её люди. |
norm_role_get | Люди и оргструктура | чтение | Карточка одной должности по id из norm_roles_list: должность целиком, руководящая должность и прямо подчинённые — ссылками с названиями, перечень версий описания со статусами и датами. |
norm_role_description | Люди и оргструктура | чтение | Текст описания должности в Markdown окнами. |
norm_person_get | Люди и оргструктура | чтение | Карточка одного сотрудника целиком. |
norm_person_upsert | Люди и оргструктура | запись | Создать или обновить карточку сотрудника. |
norm_documents_list | Документы компании | чтение | Документы, которые компания открыла агентам NORM: правила, регламенты, матрицы ролей, инструкции агентам. |
norm_document_get | Документы компании | чтение | Текст документа компании в Markdown окнами, по id из norm_documents_list. |
norm_violations_list | Реестр нарушений | чтение | Реестр нарушений правил компании страницами, от свежих к старым по дню фиксации. |
norm_violations_append | Реестр нарушений | запись | Добавить строки в реестр нарушений правил компании пачкой — от 1 до 50 за вызов. |
norm_notify | Уведомления | запись | Уведомить человека о том, что требует его внимания: о незаполненном, о неуверенно определённом, о готовности. |
В таблице «Данные ответа» у каждого инструмента колонка «При успехе» говорит, обязательно ли поле, когда в ответе нет data.error (подробнее — «Доменные состояния»).