API и Zapier
API и Zapier
Каждая сводка, которую создает InterMIND, может попасть в инструмент, где вы работаете — вашу CRM, службу поддержки, трекер задач или таблицу — без ручного копирования. Три способа:
- Ваш ИИ-ассистент (Claude, ChatGPT, Copilot, Gemini и любой другой MCP-клиент): см. ИИ-ассистенты (MCP).
- Zapier (без кода): подключите InterMIND один раз с помощью API-ключа, затем создавайте Zaps на триггере Meeting Recap Ready и действии Create Meeting Link. Эта же интеграция работает из Make, n8n или Pipedream через их стандартные модули webhook и HTTP, используя API ниже.
- API (для разработчиков): персональный ключ, одно событие webhook и десяток эндпоинтов — встречи, сводки, транскрипты, каналы, документы.
Доступно для: каждого зарегистрированного аккаунта. Гости не могут создавать ключи. Где: Интеграции → API-ключи.
API-ключи
- Откройте Интеграции и найдите карточку API-ключей.
- Нажмите Create key, дайте ему метку (инструмент, который будет его использовать, например "Zapier") и скопируйте ключ. Он начинается с
imk_и отображается только один раз — InterMIND хранит только хэш. - Отозвать ключ можно из этой же карточки в любое время. Подписки на webhook, созданные с этим ключом, немедленно прекращают работу.
До 10 ключей на аккаунт. Отправляйте ключ как Bearer-токен:
Authorization: Bearer imk_…
Ключи работают только на эндпоинтах /api/v1, перечисленных ниже; они никогда не предоставляют доступ к собственному API веб-приложения.
Zapier
- В Zapier добавьте приложение InterMIND в Zap и вставьте свой API-ключ по запросу. Подключение помечается email вашего аккаунта.
- Триггер Meeting Recap Ready — срабатывает один раз для каждой завершенной встречи, которую вы провели, как только появляется сводка. Поля: заголовок и ссылка на встречу, ссылка на сводку, ссылка на транскрипт, резюме в Markdown, язык резюме, время начала и окончания, участники (имя, email), организатор.
- Действие Create Meeting Link — создает ad-hoc встречу, которой вы владеете, и возвращает ее URL. Поместите ее в сделку CRM, тикет службы поддержки или приглашение в календарь; любой, кто откроет ссылку, отправит запрос на вход, а вы одобряете его в комнате.
Типичные Zap-ы: сводка → новая заметка по сделке в HubSpot; сводка → внутренний комментарий к тикету в Zendesk; сводка → строка в Google Sheets; новая сделка в Pipedrive → ссылка на встречу, записанная обратно в сделку.
Эндпоинты
Базовый URL: https://intermind.com/api/v1. Все ответы — JSON. Машинночитаемый контракт (OpenAPI 3.1, для Make, n8n, Pipedream и ИИ-агентов): https://intermind.com/api/v1/openapi.json.
| Метод | Путь | Назначение |
|---|---|---|
GET | /me | Владелец ключа: { id, email, name } |
POST | /meetings | Создание ссылки на ad-hoc встречу. Тело { "title": "…" } (необязательно). Возвращает 201 { id, url, title, created_at }. С параметрами starts_at (YYYY-MM-DDTHH:mm), time_zone, необязательными duration_min и invitees, встреча также записывается в подключенный календарь; ответ добавляет окно и calendar: created / not_connected / failed |
GET | /meetings?kind=recent|upcoming&type=&limit=10 | Встречи, которые вы проводите или посещаете: recent по последней активности, upcoming запланированные в будущем |
GET | /meetings/{id}/transcript?session=&max_chars=60000 | Последний финализированный транскрипт в формате Markdown по спикерам, на языке речи (или ваш кэшированный перевод); truncated, если обрезан |
GET | /recaps?limit=3 | Ваши новейшие сводки (1–10), от новых к старым, в формате полезной нагрузки webhook |
GET | /recaps/search?q=&limit=5 | Сводки, в заголовке или текущем резюме которых упоминаются слова (с учетом словоформ), с выделенным фрагментом и ссылками |
GET | /channels?limit=20 | Командные чаты и входящие, в которых вы состоите |
GET | /channels/{id}/messages?limit=50&before= | Одна страница чата канала, от старых к новым, с кэшированным переводом на язык вашего чата, если он был создан в комнате |
POST | /channels/{id}/messages | Отправка { "text": "…" } от вашего имени → 201 { id, sent_at, text }; рассылается в реальном времени и переводится для каждого читателя |
GET | /documents?meeting_id=&limit=50 | Файлы, отправленные на ваших встречах — загрузки и прикрепленные файлы Drive / OneDrive |
GET | /webhooks | Ваши подписки на webhook |
POST | /webhooks | Подписка: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | Отписка → 204 |
Ключ несет права, с которыми он был создан: ключи, созданные до сентября 2026 года, открывают только /me, POST /meetings, /recaps и /webhooks — более новые эндпоинты возвращают 403, пока вы не создадите новый ключ (или не переподключите приложение). Чтение ограничено встречами, которые вы проводите или посещаете: на id другой встречи возвращается 404.
Ограничения: 10 ключей и 20 подписок на webhook на аккаунт. target_url должен быть https:// и общедоступным — адреса частных сетей отклоняются.
Webhook: recap.ready
Отправляется как POST JSON на каждый подписанный target_url в момент, когда сводка для встречи, которую вы провели, финализируется с непустым резюме. Отправляется один раз за сессию встречи. Заголовки:
| Заголовок | Значение |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | Уникальный идентификатор этого события (<meeting id>.<session id>) — используйте для дедупликации |
X-InterMIND-Signature | sha256=<HMAC-SHA256 необработанного тела запроса с секретом подписки> |
User-Agent | InterMIND-Webhooks/1 |
Полезная нагрузка:
{
"id": "abc-def-ghi.conf_01",
"event": "recap.ready",
"occurred_at": "2026-09-04T10:32:11.000Z",
"meeting": { "id": "abc-def-ghi", "title": "Еженедельный sync с Acme", "url": "https://intermind.com/abc-def-ghi", "type": "adhoc" },
"recap": {
"url": "https://intermind.com/r/abc-def-ghi/…",
"transcript_url": "https://intermind.com/t/abc-def-ghi/…",
"summary_md": "## Решения\n- …",
"language": "en"
},
"session": { "started_at": "2026-09-04T10:00:03.000Z", "ended_at": "2026-09-04T10:31:40.000Z" },
"participants": [{ "name": "Anna Müller", "email": "anna@acme.example" }],
"host": { "name": "Anna Müller", "email": "anna@acme.example" }
}
Правила доставки: ваш эндпоинт должен отвечать 2xx в течение 8 секунд. При сетевой ошибке, 5xx или 429 повторная попытка выполняется один раз немедленно. 410 или 404 удаляет подписку. Любой другой сбой регистрируется, и событие не отправляется повторно — email со сводкой и страница сводки остаются надежной записью. Ссылки на сводку и транскрипт открываются для участников встречи, которые авторизованы.
Telegram
Пересылайте сообщения боту InterMIND, зеркалируйте группы Telegram в каналы и направляйте чаты во входящие.
Email в канал
Предоставьте любой службе email-адрес вашего канала, и её сообщения будут приходить в канал — с сохранением вложений, — чтобы каждый участник мог прочитать их на своем языке.