Skip to content

Встречи ​

Семейство 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"
        ]
      },
      {
        "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)Когда встреча закончилась, если источник это знает.
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Был ли человек в приглашении на встречу.