Grain
Записи, расшифровки и саммари встреч Grain в процессах Pailot
Grain — записи встреч: расшифровка, клипы и ИИ-саммари. Блок ходит в API (Application Programming Interface — программный интерфейс) по Personal Access Token (персональный токен доступа) и может принимать вебхуки (входящие HTTP-запросы).
С Grain в Pailot вы можете:
- Списки записей с фильтром по дате, участникам, команде и типу встречи
- Читать карточку записи, расшифровку и команды рабочего пространства
- Создавать, смотреть и удалять вебхуки (
recording_added, upload_status)
Нужен персональный токен доступа Grain. Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Токен — в переменных окружения рабочего пространства. Не публикуйте URL вебхука.
Список записей с фильтрами и постраничным выводом.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Grain (Personal Access Token) |
cursor | string | Нет | Курсор следующей страницы |
beforeDatetime | string | Нет | Только записи до этой метки ISO8601 |
afterDatetime | string | Нет | Только записи после этой метки ISO8601 |
participantScope | string | Нет | Фильтр: internal или external |
titleSearch | string | Нет | Поиск по названию записи |
teamId | string | Нет | Фильтр по UUID команды |
meetingTypeId | string | Нет | Фильтр по UUID типа встречи |
includeHighlights | boolean | Нет | Включить клипы в ответ |
includeParticipants | boolean | Нет | Включить список участников |
includeAiSummary | boolean | Нет | Включить ИИ-саммари |
| Параметр | Тип | Описание |
|---|
recordings | array | Массив записей |
↳ id | string | UUID записи |
↳ title | string | Название записи |
↳ start_datetime | string | Начало (ISO8601) |
↳ end_datetime | string | Конец (ISO8601) |
↳ duration_ms | number | Длительность в миллисекундах |
↳ media_type | string | audio, transcript или video |
↳ source | string | Источник записи |
↳ url | string | Ссылка на запись в Grain |
↳ thumbnail_url | string | URL превью |
↳ tags | array | Теги |
↳ teams | array | Команды записи |
↳ meeting_type | object | Тип встречи |
cursor | string | Курсор следующей страницы (null, если страниц больше нет) |
Карточка одной записи по ID.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Grain (Personal Access Token) |
recordingId | string | Да | UUID записи |
includeHighlights | boolean | Нет | Включить клипы |
includeParticipants | boolean | Нет | Включить участников |
includeAiSummary | boolean | Нет | Включить ИИ-саммари |
includeCalendarEvent | boolean | Нет | Включить данные события календаря |
includeHubspot | boolean | Нет | Включить связи HubSpot |
| Параметр | Тип | Описание |
|---|
id | string | UUID записи |
title | string | Название записи |
start_datetime | string | Начало (ISO8601) |
end_datetime | string | Конец (ISO8601) |
duration_ms | number | Длительность в миллисекундах |
media_type | string | audio, transcript или video |
source | string | Источник (zoom, meet, teams и др.) |
url | string | Ссылка на запись в Grain |
thumbnail_url | string | URL превью |
tags | array | Теги |
teams | array | Команды записи |
meeting_type | object | Тип встречи (id, name, scope) |
highlights | array | Клипы (если включены) |
participants | array | Участники (если включены) |
ai_summary | object | ИИ-саммари (если включено) |
calendar_event | object | Событие календаря (если включено) |
hubspot | object | Связи HubSpot (если включены) |
Полная расшифровка записи.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Grain (Personal Access Token) |
recordingId | string | Да | UUID записи |
| Параметр | Тип | Описание |
|---|
transcript | array | Сегменты расшифровки |
↳ participant_id | string | UUID участника (может быть пустым) |
↳ speaker | string | Имя говорящего |
↳ start | number | Начало сегмента в мс |
↳ end | number | Конец сегмента в мс |
↳ text | string | Текст сегмента |
Список команд рабочего пространства.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Grain (Personal Access Token) |
| Параметр | Тип | Описание |
|---|
teams | array | Массив команд |
↳ id | string | UUID команды |
↳ name | string | Название команды |
Список типов встреч рабочего пространства.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Grain (Personal Access Token) |
| Параметр | Тип | Описание |
|---|
meeting_types | array | Массив типов встреч |
↳ id | string | UUID типа встречи |
↳ name | string | Название типа |
↳ scope | string | internal или external |
Создать вебхук событий записи.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Grain (Personal Access Token) |
hookUrl | string | Да | URL вебхука (должен отвечать 2xx) |
hookType | string | Да | Тип: recording_added или upload_status |
filterBeforeDatetime | string | Нет | Фильтр: записи до этой даты |
filterAfterDatetime | string | Нет | Фильтр: записи после этой даты |
filterParticipantScope | string | Нет | Фильтр: internal или external |
filterTeamId | string | Нет | Фильтр: UUID команды |
filterMeetingTypeId | string | Нет | Фильтр: тип встречи |
includeHighlights | boolean | Нет | Включить клипы в тело вебхука |
includeParticipants | boolean | Нет | Включить участников в тело вебхука |
includeAiSummary | boolean | Нет | Включить ИИ-саммари в тело вебхука |
| Параметр | Тип | Описание |
|---|
id | string | UUID хука |
enabled | boolean | Хук активен |
hook_url | string | URL вебхука |
hook_type | string | Тип: recording_added или upload_status |
filter | object | Применённые фильтры |
include | object | Включённые поля |
inserted_at | string | Когда хук создали (ISO8601) |
Список вебхуков аккаунта.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Grain (Personal Access Token) |
| Параметр | Тип | Описание |
|---|
hooks | array | Массив хуков |
↳ id | string | UUID хука |
↳ enabled | boolean | Хук активен |
↳ hook_url | string | URL вебхука |
↳ hook_type | string | Тип: recording_added или upload_status |
↳ filter | object | Применённые фильтры |
↳ include | object | Включённые поля |
↳ inserted_at | string | Когда хук создали |
Удалить вебхук по ID.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Grain (Personal Access Token) |
hookId | string | Да | UUID хука |
| Параметр | Тип | Описание |
|---|
success | boolean | Вебхук удалён |
