API & Zapier
API & Zapier
Каждый отчёт, который создаёт InterMIND, может попасть в инструмент, где вы работаете — вашу CRM, службу поддержки, трекер задач или таблицу — без ручного копирования. Два способа:
- Zapier (без кода): подключите InterMIND один раз с помощью API-ключа, затем создавайте Zaps на триггере Meeting Recap Ready и действии Create Meeting Link. Эта же интеграция работает из Make, n8n или Pipedream через их стандартные модули webhook и HTTP, используя API ниже.
- API (для разработчиков): персональный ключ, одно событие webhook и три эндпоинта.
Доступно для: каждого зарегистрированного аккаунта. Гости не могут создавать ключи. Где: Настройки → API keys.
API keys
- Откройте Настройки и найдите карточку API keys.
- Нажмите Create key, задайте метку (инструмент, который будет его использовать, например «Zapier») и скопируйте ключ. Он начинается с
imk_и показывается один раз — InterMIND хранит только хеш. - Отозвать ключ можно из той же карточки в любой момент. Подписки webhook, созданные с этим ключом, немедленно прекращают работу.
До 10 ключей на аккаунт. Отправляйте ключ как bearer token:
Authorization: Bearer imk_…
Ключи работают только на эндпоинтах /api/v1 ниже; они не предоставляют доступа к собственному API веб-приложения.
Zapier
- В Zapier добавьте приложение InterMIND в Zap и вставьте свой API-ключ по запросу. Подключение помечается email-адресом вашего аккаунта.
- Триггер Meeting Recap Ready — срабатывает один раз для каждой завершённой встречи, которую вы провели, как только готово краткое содержание. Поля: название и ссылка встречи, ссылка на отчёт, ссылка на транскрипцию, краткое содержание в Markdown, язык краткого содержания, время начала и окончания, участники (имя, email), организатор.
- Действие Create Meeting Link — создаёт ad-hoc-встречу, владельцем которой вы являетесь, и возвращает её URL. Вставьте его в сделку CRM, тикет поддержки или приглашение в календарь; любой, кто откроет ссылку, постучится, и вы одобряете его вход в комнату.
Типичные Zaps: отчёт → новая заметка в сделке HubSpot; отчёт → внутренний комментарий в тикете Zendesk; отчёт → строка в Google Sheets; новая сделка Pipedrive → ссылка на встречу, записанная обратно в сделку.
Эндпоинты
Базовый URL: https://intermind.com/api/v1. Все ответы — JSON. Машинно-читаемый контракт (OpenAPI 3.1, для Make, n8n, Pipedream и AI-агентов): https://intermind.com/api/v1/openapi.json.
| Метод | Путь | Назначение |
|---|---|---|
GET | /me | Владелец ключа: { id, email, name } |
POST | /meetings | Создать ссылку на ad-hoc-встречу. Body { "title": "…" } (необязательно). Возвращает 201 { id, url, title, created_at } |
GET | /recaps?limit=3 | Ваши последние отчёты (1–10), новые первыми, в формате payload webhook |
GET | /webhooks | Ваши подписки webhook |
POST | /webhooks | Подписаться: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | Отписаться → 204 |
Лимиты: 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 |
Payload:
{
"id": "abc-def-ghi.conf_01",
"event": "recap.ready",
"occurred_at": "2026-09-04T10:32:11.000Z",
"meeting": { "id": "abc-def-ghi", "title": "Weekly sync with 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": "## Decisions\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-адрес вашего канала, и её сообщения будут приходить в канал — с сохранением вложений, — чтобы каждый участник мог прочитать их на своем языке.