API & Zapier

Zapier를 사용해 회의 회의록을 CRM, 헬프데스크 또는 스프레드시트로 보내거나, 개인 API 키를 이용해 InterMIND API를 직접 호출하세요.

API 및 Zapier

InterMIND이 생성하는 모든 리캡은 누군가 직접 복사하지 않아도 업무에 사용하는 도구(CRM, 헬프데스크, 작업 트래커 또는 스프레드시트)로 바로 전달될 수 있습니다. 세 가지 연결 방법이 있습니다:

AI 비서(Claude, ChatGPT, Copilot, Gemini 및 기타 모든 MCP 클라이언트): AI 비서(MCP)를 참조하세요.
Zapier(코드 불필요): InterMIND를 API 키로 한 번 연결한 뒤, Meeting Recap Ready 트리거와 Create Meeting Link 액션으로 Zap을 구축하세요. 동일한 연동은 아래 API를 통해 Make, n8n 또는 Pipedream의 범용 웹훅 및 HTTP 모듈에서도 작동합니다.
API(개발자용): 개인 키, 하나의 웹훅 이벤트 및 미팅, 리캡, 트랜스크립트, 채널, 문서를 위한 10여 개의 엔드포인트.

이용 가능 대상: 모든 등록된 계정. 게스트는 키를 생성할 수 없습니다. 위치: 통합 → API 키.

리캡은 인바운드 이메일 주소가 있는 모든 도구로도 전달됩니다. 미팅 또는 채널에서 해당 도구를 리캡 사본 수신자로 추가하기만 하면 되며, 별도의 연동이 필요하지 않습니다. 리캡 사본을 참조하세요.

API 키

통합을 열고 API 키 카드를 찾습니다.
키 생성을 클릭하고 라벨(키를 사용할 도구, 예: "Zapier")을 입력한 다음 키를 복사합니다. 키는 imk_로 시작하며 한 번만 표시됩니다 — InterMIND는 해시만 저장합니다.
언제든지 동일한 카드에서 키를 폐기할 수 있습니다. 해당 키로 생성된 웹훅 구독은 즉시 중지됩니다.

계정당 최대 10개의 키를 생성할 수 있습니다. 키를 베어러 토큰으로 전송하세요:

Authorization: Bearer imk_…

키는 아래의 /api/v1 엔드포인트에서만 작동하며, 웹 애플리케이션 자체 API에 대한 액세스 권한은 부여하지 않습니다.

Zapier

Zapier에서 InterMIND 앱을 Zap에 추가하고, 메시지가 표시되면 API 키를 붙여넣습니다. 연결은 계정 이메일로 라벨이 지정됩니다.
Meeting Recap Ready 트리거 — 주최한 미팅이 종료되고 요약이 생성되는 즉시 한 번 실행됩니다. 필드: 미팅 제목 및 링크, 리캡 링크, 트랜스크립트 링크, Markdown 요약, 요약 언어, 시작 및 종료 시간, 참가자(이름, 이메일), 호스트.
Create Meeting Link 액션 — 소유권을 가진 임시 미팅을 생성하고 그 URL을 반환합니다. 이를 CRM 거래, 지원 티켓 또는 캘린더 초대장에 넣을 수 있습니다. 링크를 여는 사람은 노크를 하며, 귀하가 방에서 이를 승인할 수 있습니다.

일반적인 Zap: 리캡 → 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.

Method	Path	용도
`GET`	`/me`	키 소유자: `{ id, email, name }`
`POST`	`/meetings`	임시 미팅 링크를 생성합니다. 본문 `{ "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개), 최신순, 웹훅 페이로드 형식
`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`	본인의 웹훅 구독
`POST`	`/webhooks`	구독: `{ "target_url": "https://…", "event": "recap.ready" }` → `201 { id, event, target_url, secret, created_at }`
`DELETE`	`/webhooks/{id}`	구독 취소 → `204`

키는 생성 시 부여된 권한을 가집니다. 2026년 9월 이전에 생성된 키는 /me, POST /meetings, /recaps 및 /webhooks에만 접근할 수 있으며, 최신 엔드포인트는 새 키를 생성(또는 앱을 다시 연결)할 때까지 403을 반환합니다. 읽기 권한은 본인이 주최하거나 참석하는 미팅으로 제한됩니다. 다른 미팅의 ID는 404를 반환합니다.

제한: 계정당 10개의 키와 20개의 웹훅 구독. target_url은 https://이어야 하며 공개적으로 접근 가능해야 합니다 — 프라이빗 네트워크 주소는 거부됩니다.

웹훅: `recap.ready`

주최한 미팅의 리캡이 비어 있지 않은 요약으로 최종 확정되는 순간, 구독한 모든 target_url로 POST JSON 형식으로 전송됩니다. 미팅 세션당 한 번 전송됩니다. 헤더:

Header	Value
`X-InterMIND-Event`	`recap.ready`
`X-InterMIND-Delivery`	이 이벤트의 고유 ID (`<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": "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" }
}

전달 규칙: 엔드포인트는 8초 내에 2xx로 응답해야 합니다. 네트워크 오류, 5xx 또는 429는 즉시 한 번 재시도됩니다. 410 또는 404는 구독을 삭제합니다. 기타 모든 실패는 기록되며 이벤트는 재전송되지 않습니다. 리캡 이메일과 리캡 페이지는 영구적인 기록으로 남습니다. 리캡 및 트랜스크립트 링크는 로그인한 미팅 참가자에게 열립니다.

메시지를 InterMIND 봇으로 전달하고, Telegram 그룹을 채널로 미러링한 뒤, 채팅을 받은 편지함으로 라우팅하세요.

이메일을 채널로

원하는 서비스에 채널의 이메일 주소를 제공하면 메시지가 채널에 바로 도착합니다 — 첨부 파일도 그대로 유지되며, 각 멤버는 자신의 언어로 읽을 수 있습니다.