API & Zapier
API 및 Zapier
InterMIND가 생성하는 모든 회의록은 누군가가 수동으로 복사할 필요 없이 작업하는 도구인 CRM, 헬프데스크, 작업 추적기 또는 스프레드시트로 바로 전달될 수 있습니다. 두 가지 연결 방법이 있습니다:
- Zapier (코드 없음): InterMIND를 API 키로 한 번 연결한 후, Meeting Recap Ready 트리거와 Create Meeting Link 액션으로 Zap을 만드세요. 동일한 통합은 아래 API를 사용하여 Make, n8n 또는 Pipedream의 범용 웹훅 및 HTTP 모듈을 통해서도 작동합니다.
- API (개발자용): 개인 키 1개, 웹훅 이벤트 1개, 엔드포인트 3개입니다.
지원 대상: 등록된 모든 계정. 게스트는 키를 만들 수 없습니다. 위치: Settings → API keys.
API 키
- Settings를 열고 API keys 카드를 찾습니다.
- Create key를 클릭하고 레이블(사용할 도구, 예: "Zapier")을 지정한 다음 키를 복사합니다.
imk_로 시작하며 한 번만 표시됩니다 — InterMIND는 해시만 저장합니다. - 언제든지 같은 카드에서 키를 취소할 수 있습니다. 해당 키로 만든 웹훅 구독은 즉시 중지됩니다.
계정당 최대 10개의 키를 만들 수 있습니다. 키를 Bearer 토큰으로 전송하세요:
Authorization: Bearer imk_…
키는 아래 /api/v1 엔드포인트에서만 작동하며, 웹 애플리케이션 자체의 API에 대한 액세스 권한은 부여하지 않습니다.
Zapier
- Zapier에서 InterMIND 앱을 Zap에 추가하고 메시지가 표시되면 API 키를 붙여넣습니다. 연결에는 계정 이메일 레이블이 지정됩니다.
- 트리거 Meeting Recap Ready — 주최한 미팅이 종료되고 요약본이 생성되는 즉시 미팅마다 한 번 실행됩니다. 필드: 미팅 제목 및 링크, 회의록 링크, 전사본 링크, Markdown 요약본, 요약본 언어, 시작 및 종료 시간, 참가자(이름, 이메일), 호스트.
- 액션 Create Meeting Link — 소유권을 가진 임시 미팅을 생성하고 그 URL을 반환합니다. CRM 딜, 지원 티켓 또는 캘린더 초대장에 넣어보세요; 링크를 여는 사람은 노크(knock)를 하고 사용자가 방에서 승인합니다.
일반적인 Zap: 회의록 → HubSpot 딜의 새 메모; 회의록 → Zendesk 티켓의 내부 댓글; 회의록 → Google Sheets의 행; 새 Pipedrive 딜 → 딜에 다시 기록된 미팅 링크.
엔드포인트
기본 URL: https://intermind.com/api/v1. 모든 응답은 JSON입니다. 기계 판독 가능 계약서(Make, n8n, Pipedream 및 AI 에이전트용 OpenAPI 3.1): https://intermind.com/api/v1/openapi.json.
| Method | Path | Purpose |
|---|---|---|
GET | /me | 키 소유자: { id, email, name } |
POST | /meetings | 임시 미팅 링크 생성. 본문 { "title": "…" } (선택 사항). 201 { id, url, title, created_at } 반환 |
GET | /recaps?limit=3 | 최신 회의록(1–10개), 최신순, 웹훅 페이로드 형식 |
GET | /webhooks | 웹훅 구독 목록 |
POST | /webhooks | 구독: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } 반환 |
DELETE | /webhooks/{id} | 구독 취소 → 204 |
제한: 계정당 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는 구독을 삭제합니다. 다른 모든 실패는 기록되며 이벤트는 재전송되지 않습니다 — 회의록 이메일과 회의록 페이지가 영구적인 기록으로 남습니다. 회의록 및 전사본 링크는 로그인한 미팅 참가자에게 공개됩니다.