API и Zapier
API и Zapier
Всяко резюме (recap), което InterMIND създава, може да стигне до инструмента, в който работите — вашата CRM система, help desk, таск тракер или електронна таблица — без никой да го копира на ръка. Три начина да го направите:
- Вашият AI асистент (Claude, ChatGPT, Copilot, Gemini и всеки друг MCP клиент): вижте AI асистенти (MCP).
- Zapier (без код): свържете InterMIND веднъж с API ключ, след което създайте Zaps със trigger Meeting Recap Ready и action Create Meeting Link. Същата интеграция работи и от Make, n8n или Pipedream чрез техните общи webhook и HTTP модули, като използвате API-то по-долу.
- API-то (за разработчици): личен ключ, едно webhook събитие и дузина endpoint-и — срещи, резюмета, транскрипти, канали, документи.
Налично за: всеки регистриран акаунт. Гостите не могат да създават ключове. Къде: Integrations → API keys.
API ключове
- Отворете Integrations и намерете картата API keys.
- Натиснете Create key, задайте етикет (инструментът, който ще го използва, напр. „Zapier") и копирайте ключа. Той започва с
imk_и се показва само веднъж — InterMIND съхранява единствено хеш. - Можете да отмените ключ от същата карта по всяко време. Webhook абонаментите, създадени с този ключ, спират незабавно.
До 10 ключа на акаунт. Изпращайте ключа като bearer token:
Authorization: Bearer imk_…
Ключовете работят само с /api/v1 endpoint-ите по-долу; те никога не дават достъп до собственото API на уеб приложението.
Zapier
- В Zapier добавете приложението InterMIND към Zap и поставете своя API ключ, когато бъде поискан. Връзката се обозначава с имейла на вашия акаунт.
- Trigger Meeting Recap Ready — задейства се веднъж за всяка приключила среща, на която сте били домакин, веднага щом резюмето е готово. Полета: заглавие и връзка към срещата, връзка към резюмето, връзка към транскрипта, резюмето в Markdown, език на резюмето, начален и краен час, участници (име, имейл), домакин.
- Action Create Meeting Link — създава ad-hoc среща, която притежавате, и връща нейния URL. Поставете го в сделка в CRM, в support тикет или в покана в календара; всеки, който отвори връзката, „чука“ и вие го одобрявате в стаята.
Типични Zaps: резюме → нова бележка към сделката в HubSpot; резюме → вътрешен коментар към тикета в Zendesk; резюме → ред в Google Sheets; нова сделка в Pipedrive → връзка към срещата, записана обратно в сделката.
Endpoint-и
Базов URL: https://intermind.com/api/v1. Всички отговори са JSON. Машинночетим контракт (OpenAPI 3.1, за Make, n8n, Pipedream и AI агенти): https://intermind.com/api/v1/openapi.json.
| Method | Path | Purpose |
|---|---|---|
GET | /me | Кой притежава ключа: { id, email, name } |
POST | /meetings | Създава ad-hoc връзка към среща. Body { "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 payload-а |
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 — по-новите endpoint-и отговарят с 403, докато не създадете нов ключ (или не свържете приложението отново). Четенето е ограничено до срещи, на които сте домакин или участник: идентификаторът на чужда среща връща 404.
Лимити: 10 ключа и 20 webhook абонамента на акаунт. target_url трябва да е https:// и публично достъпен — адреси от частни мрежи се отхвърлят.
Webhook: recap.ready
Изпраща се като POST JSON към всеки абониран target_url в момента, в който резюме за среща, на която сте били домакин, бъде финализирано с непразно съдържание. Изпраща се веднъж за всяка сесия на срещата. Хедъри:
| Header | Value |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | Уникален идентификатор на това събитие (<meeting id>.<session id>) — премахвайте дубликатите по него |
X-InterMIND-Signature | sha256=<HMAC-SHA256 на суровото тяло със secret-а на абонамента> |
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" }
}
Правила за доставка: вашият endpoint трябва да отговори с 2xx в рамките на 8 секунди. При мрежова грешка, 5xx или 429 се прави един повторен опит веднага. 410 или 404 изтрива абонамента. Всеки друг неуспех се записва в лога и събитието не се изпраща отново — имейлът с резюмето и страницата на резюмето остават трайният запис. Връзките към резюмето и транскрипта се отварят за участниците в срещата, които са влезли в профила си.
Telegram
Препращайте съобщения към бота на InterMIND, синхронизирайте групи в Telegram с канали и насочвайте чатове към своя Inbox.
Имейл към канал
Дайте на всяка услуга имейл адреса на канала си и съобщенията ѝ ще се появяват в канала — с непокътнати прикачени файлове, като всеки участник ги чете на своя език.