API: получение результатов и управление встречей

После того как встреча создана — ботом или загрузкой файла — через API можно узнать статус обработки, забрать результат и управлять уже обработанной встречей. Во всех методах ниже авторизация идёт заголовком X-API-KEY; как альтернатива поддерживается параметр api_key в query-строке.

Статус обработки

GET https://backend.mymeet.ai/api/meeting/status?meeting_id=...

Два режима:

• Одна встреча — параметр meeting_id, ответ приходит простым текстом.
• Пачкой — параметр meeting_ids, до 100 идентификаторов через запятую, ответ в JSON.

Если переданы оба параметра, приоритет у meeting_ids. Для встреч, которые не удалось записать, статус содержит причину неудачи — то же значение приходит в уведомлении meeting.failed.

Вместо постоянного опроса статуса можно использовать вебхук: когда обработка закончится, mymeet сам пришлёт уведомление, а отчёт вы заберёте через GET /api/video/report. См. статью «API: вебхуки».

Получить транскрипт и отчёт в JSON

GET https://backend.mymeet.ai/api/video/report?meeting_id=...

Возвращает данные встречи: транскрипт и AI-отчёты. Возможные ответы: 200, 400, 401, 403 (нет доступа к этой встрече).

Скачать отчёт файлом

GET https://backend.mymeet.ai/api/storage/download?meeting_id=...&format=pdf

Параметры:

• meeting_id — обязателен.
• format — pdf (по умолчанию), docx, md или json.
• template_name — какой из применённых шаблонов отчёта выгружать.
• timezone — часовой пояс для дат в документе.

Список активных встреч пространства

GET https://backend.mymeet.ai/api/workspaces/active/all-meetings?page=0&perPage=50

Отдаёт постраничный список активных встреч рабочего пространства, к которому привязан ключ. Параметры page (нумерация с 0) и perPage обязательны.

Сгенерировать ещё один шаблон отчёта

POST https://backend.mymeet.ai/api/generate-new-template
{"meeting_id": "...", "template_name": "protocol"}

Применяет к уже обработанной встрече новый шаблон. Один и тот же шаблон можно применить к встрече несколько раз: каждому применению присваивается уникальный id, который возвращается в поле created_template_id. Именно этот id нужен, чтобы потом править саммари.

Отредактировать часть саммари

PUT https://backend.mymeet.ai/api/meeting/{meetingId}/summary
{"templateId": "...", "entityName": "...", "newSummaryText": "..."}

Обновляет конкретный блок отчёта. templateId — это id применённого шаблона: поле id элемента в followup_v2.templates, оно же created_template_id из предыдущего метода. Адресация по id, а не по названию шаблона, сделана специально: правка одного применённого отчёта не затрагивает другие отчёты с тем же названием шаблона.

Поле entityName указывает, какой блок правится. Допустимые значения: summary, summary_agenda, sales_general, sales_coach, hr_summary, questions_and_answers, research_insights, team_sync_agenda, summary_by_speaker, workshop-double, seo-article-double, one_to_one, med-anamnesis, protocol, template-recommendation.

Ответы: 200, 400, 401, 404 (шаблон с таким id не найден).

Переименовать встречу

PUT https://backend.mymeet.ai/api/meeting
{"meetingId": "...", "newName": "Новое название"}

Здесь поле называется meetingId (camelCase), а в большинстве остальных методов — meeting_id.

Удалить встречу

DELETE https://backend.mymeet.ai/api/video/report?meeting_id=...

Удаляет встречу вместе с отчётом. Ответы: 200, 400, 401, 403.

Примеры кода

Готовые примеры для всех методов: https://github.com/MyMeetAI/API-Docs