Тема
Встречи
Семейство meetings.
norm_meetings_list
Встречи компании за интервал дат. Фильтры from и to — дни включительно, за один день from = to. Порядок от свежих к старым; фильтр действует на всех страницах одного обхода. Поле range — окно, за которое у реализации вообще есть встречи: за его пределами встреч нет независимо от фильтра. total — сколько встреч подошло под фильтр до применения страницы. Идентификатор встречи из поля id идёт в norm_meeting_get и norm_meeting_transcript.
Доступ: чтение · Списковый: да · Версии контракта: 1
Аргументы
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
cursor | нет | string | Какую страницу прислать: next_cursor из прошлого ответа. Без него — первую. |
from | нет | string (date) | С какого дня искать встречи, включительно. |
limit | нет | integer | Сколько записей прислать на одной странице. |
to | нет | string (date) | По какой день искать встречи, включительно; за один день передайте тот же день, что во from. |
Данные ответа (data)
| Поле | При успехе | Тип | Зачем |
|---|---|---|---|
meetings | да | список MeetingItem | Найденные встречи этой страницы, от свежих к старым. |
range | да | DateRange | За какие дни у сервера вообще есть встречи: за этими границами искать бесполезно. |
total | да | integer | Сколько встреч подошло под фильтр всего, на всех страницах. |
Пример: успешный ответ
json
{
"source_refs": [
{
"source": "company-data",
"ref": "meetings:2026-09-15..2026-09-21",
"label": "Встречи недели"
}
],
"freshness": {
"as_of": "2026-09-21T06:00:00.000Z",
"ttl_sec": 604800,
"stale": false
},
"page": {
"has_more": true,
"next_cursor": "eyJvIjoyfQ"
},
"data": {
"range": {
"from": "2026-08-22",
"to": "2026-09-21"
},
"total": 37,
"meetings": [
{
"id": "01K9F2QH7T8ZRC4M0X5B2VNJ3D",
"title": "Планёрка отдела продаж",
"date": "2026-09-21",
"started_at": "2026-09-21T09:00:00+03:00",
"ended_at": "2026-09-21T09:47:00+03:00",
"recorded": true,
"content_status": "ready",
"participant_emails": [
"a.novikova@example.com",
"m.petrov@example.com"
],
"organizer_email": "a.novikova@example.com"
},
{
"id": "01K9F0YB3M6QA8T2WD7E4RSKPN",
"title": "Разбор рекламации",
"date": "2026-09-20",
"started_at": "2026-09-20T14:30:00+03:00",
"ended_at": "2026-09-20T15:05:00+03:00",
"recorded": true,
"content_status": "no_content",
"participant_emails": [
"m.petrov@example.com"
]
}
]
}
}norm_meeting_get
Карточка одной встречи по id: название, время, участники, организатор, повестка и ссылка — шапка протокола. Участников сопоставляйте с людьми из norm_people_list по почте: имя из конференции бывает логином или названием устройства. В attendees есть и приглашённые, которые не пришли (attended: false) — в состав встречи их не включайте. Содержания разговора ответ не несёт: сам текст, кто говорил и его размер — в norm_meeting_transcript. Контента нет — это не сбой: content_status говорит, что сообщил источник, retryable — есть ли смысл повторять.
Доступ: чтение · Списковый: нет · Версии контракта: 1
Аргументы
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
id | да | string | Какую встречу открыть: id из norm_meetings_list. |
Данные ответа (data)
| Поле | При успехе | Тип | Зачем |
|---|---|---|---|
content_status | да | ContentStatus | Есть ли у встречи материал; нет — это не сбой. |
date | да | string (date) | День встречи: идёт в дату протокола. |
id | да | string | Идентификатор встречи: тот же, что передан во входе. |
retryable | да | boolean | Есть ли смысл спросить позже: материал может ещё появиться. |
title | да | string | Название встречи: идёт в заголовок протокола и помогает распознать тип встречи. |
agenda | нет | string | Повестка встречи, если она была. |
agenda_sources | нет | список string | Откуда взята повестка: приглашение, документ и так далее. |
attendees | нет | список Attendee | Участники с почтой и отметкой, пришли ли они; не пришедших в состав встречи не включают. |
ended_at | нет | string (date-time) | Когда встреча закончилась, если источник это знает. |
note | нет | string | Пояснение сервера к ответу, например почему материала нет. |
organizer_email | нет | string | Почта организатора: по ней находят организатора среди сотрудников. |
participant_emails | нет | список string | Почты участников: по ним участников находят среди сотрудников. |
participants | нет | список string | Имена участников, как их показала конференция; для сопоставления берите почты. |
platform | нет | string | Где прошла встреча: название сервиса конференций. |
platform_meeting_id | нет | string | Номер встречи в сервисе конференций, чтобы найти её там. |
started_at | нет | string (date-time) | Когда встреча началась, если источник это знает. |
url | нет | string (uri) | Ссылка на встречу в системе-источнике, чтобы человек мог её открыть. |
Пример: успешный ответ
json
{
"source_refs": [
{
"source": "company-data",
"ref": "meeting:01K9F2QH7T8ZRC4M0X5B2VNJ3D",
"label": "Планёрка отдела продаж"
}
],
"freshness": {
"as_of": "2026-09-21T06:00:00.000Z",
"ttl_sec": 604800,
"stale": false
},
"data": {
"id": "01K9F2QH7T8ZRC4M0X5B2VNJ3D",
"title": "Планёрка отдела продаж",
"date": "2026-09-21",
"started_at": "2026-09-21T09:00:00+03:00",
"ended_at": "2026-09-21T09:47:00+03:00",
"url": "https://meetings.example.com/01K9F2QH7T8ZRC4M0X5B2VNJ3D",
"content_status": "ready",
"retryable": false,
"participants": [
"Анна Новикова",
"Михаил Петров"
],
"attendees": [
{
"name": "Анна Новикова",
"email": "a.novikova@example.com",
"invited": true,
"attended": true
},
{
"name": "Михаил Петров",
"email": "m.petrov@example.com",
"invited": true,
"attended": true
},
{
"name": "Сергей Ильин",
"email": "s.ilin@example.com",
"invited": true,
"attended": false
}
],
"participant_emails": [
"a.novikova@example.com",
"m.petrov@example.com"
],
"organizer_email": "a.novikova@example.com",
"agenda": "1. Воронка за неделю. 2. Правило квалификации лида. 3. Разное.",
"agenda_sources": [
"calendar",
"conference"
],
"platform": "conference",
"platform_meeting_id": "884 2210 9931"
}
}Пример: случай «no_content»
json
{
"source_refs": [
{
"source": "company-data",
"ref": "meeting:01K9F0YB3M6QA8T2WD7E4RSKPN"
}
],
"freshness": {
"as_of": "2026-09-21T06:00:00.000Z",
"ttl_sec": 604800,
"stale": false
},
"data": {
"id": "01K9F0YB3M6QA8T2WD7E4RSKPN",
"title": "Разбор рекламации",
"date": "2026-09-20",
"started_at": "2026-09-20T14:30:00+03:00",
"content_status": "no_content",
"retryable": true,
"note": "Источник не отдал контент этой встречи и причину не называет. Встреча прошла недавно, отчёт, скорее всего, ещё готовится."
}
}norm_meeting_transcript
Расшифровка встречи окном — единственный источник содержания встречи. Первое окно сразу говорит, кто говорил и какой длины текст: по total_chars видно, сколько окон ещё впереди. max_chars — размер окна в символах (умолчание 12000, максимум 24000; значения в разделе limits слепка). Для следующего окна передайте page.next_cursor как cursor. Повторный вызов с тем же курсором вернёт тот же текст. У встречи без расшифровки вызов успешен и возвращает пустой text: это не сбой, менять аргументы бесполезно.
Доступ: чтение · Списковый: нет · Версии контракта: 1
Аргументы
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
id | да | string | Чью расшифровку читать: id встречи из norm_meetings_list. |
cursor | нет | string | Откуда продолжить чтение: next_cursor из прошлого ответа. Без него — с начала. |
max_chars | нет | integer | Сколько символов прислать за раз. |
Данные ответа (data)
| Поле | При успехе | Тип | Зачем |
|---|---|---|---|
content_status | да | ContentStatus | Есть ли у встречи материал. |
date | да | string (date) | День встречи. |
id | да | string | Идентификатор встречи: тот же, что передан во входе. |
retryable | да | boolean | Есть ли смысл спросить позже: расшифровка может ещё появиться. |
speakers | да | список string | Кто говорил на встрече. |
text | да | string | Сам текст расшифровки в этом окне; пустой — расшифровки нет, и это не сбой. |
title | да | string | Название встречи, чтобы не перепутать, чью расшифровку читаете. |
total_chars | да | integer | Длина всей расшифровки: по ней видно, сколько ещё осталось. |
note | нет | string | Пояснение сервера к ответу, например почему текста нет. |
Пример: успешный ответ
json
{
"source_refs": [
{
"source": "company-data",
"ref": "meeting:01K9F2QH7T8ZRC4M0X5B2VNJ3D:0..12000"
}
],
"freshness": {
"as_of": "2026-09-21T06:00:00.000Z",
"ttl_sec": 604800,
"stale": false
},
"page": {
"has_more": true,
"next_cursor": "eyJvIjoxMjAwMH0"
},
"data": {
"id": "01K9F2QH7T8ZRC4M0X5B2VNJ3D",
"title": "Планёрка отдела продаж",
"date": "2026-09-21",
"speakers": [
"Анна Новикова",
"Михаил Петров"
],
"total_chars": 48213,
"text": "Анна Новикова: Начнём с воронки. За неделю сорок два лида, квалифицировано двадцать девять…",
"content_status": "ready",
"retryable": false,
"note": "Это первое окно из четырёх. Не делайте выводов обо всей встрече по одному окну."
}
}Объекты семейства
Объекты, из которых состоят аргументы и ответы инструментов этого семейства.
MeetingItem
Встреча в списке. Идентификатор, название, день, время начала и конца, наличие записи, состояние контента, почты участников и организатора.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
content_status | да | ContentStatus | Готов ли материал встречи, чтобы решить, брать ли её в работу. |
date | да | string (date) | В какой день прошла встреча. |
id | да | string | Чтобы запросить карточку или расшифровку этой встречи. |
recorded | да | boolean | Была ли у встречи запись. |
title | да | string | Чтобы узнать встречу в списке и распознать её тип по названию. |
ended_at | нет | string (date-time) | Когда встреча закончилась, если источник это знает. |
organizer_email | нет | string | Почта организатора: по ней встречи разбивают по организаторам, не открывая карточку каждой. |
participant_emails | нет | список string | Почты участников: по ним видно, кто был, не открывая карточку. |
started_at | нет | string (date-time) | Когда встреча началась, если источник это знает. |
ContentStatus
Состояние контента. ready — контент есть; no_content — предмет найден, контента нет; deleted — предмета в источнике больше нет.
Значения: ready, no_content, deleted.
DateRange
Окно дат. Начало и конец включительно.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
from | да | string (date) | Первый день окна. |
to | да | string (date) | Последний день окна. |
Attendee
Участник встречи. Имя, почта и флаги приглашения и присутствия. attended: false — приглашённый, который не пришёл: в состав встречи он не входит.
| Поле | Обязательно | Тип | Зачем |
|---|---|---|---|
name | да | string | Как человека назвала конференция; бывает логином или названием устройства. |
attended | нет | boolean | Пришёл ли человек; false — не пришёл, в состав встречи его не включают. |
email | нет | string | Чтобы найти этого человека среди сотрудников: сопоставляйте по почте, а не по имени. |
invited | нет | boolean | Был ли человек в приглашении на встречу. |