API & Zapier
API & Zapier
Mọi bản tóm tắt do InterMIND tạo ra đều có thể được gửi đến công cụ bạn đang sử dụng — CRM, bộ phận hỗ trợ, trình theo dõi tác vụ hoặc bảng tính — mà không cần ai phải sao chép thủ công. Có ba cách để thực hiện:
- Trợ lý AI của bạn (Claude, ChatGPT, Copilot, Gemini và bất kỳ ứng dụng khách MCP nào khác): xem Trợ lý AI (MCP).
- Zapier (không cần code): kết nối InterMIND một lần bằng khóa API, sau đó xây dựng Zaps trên trình kích hoạt Meeting Recap Ready và hành động Create Meeting Link. Tích hợp này cũng hoạt động tương tự với Make, n8n hoặc Pipedream thông qua các module webhook và HTTP chung của chúng, sử dụng API bên dưới.
- API (dành cho nhà phát triển): một khóa cá nhân, một sự kiện webhook và hàng tá endpoint — cuộc họp, bản tóm tắt, bản ghi chép, kênh, tài liệu.
Khả dụng cho: mọi tài khoản đã đăng ký. Khách không thể tạo khóa. Vị trí: Tích hợp → Khóa API.
Khóa API
- Mở Tích hợp và tìm thẻ Khóa API.
- Nhấp vào Tạo khóa, đặt nhãn cho nó (công cụ sẽ sử dụng, ví dụ: "Zapier") và sao chép khóa. Khóa bắt đầu bằng
imk_và chỉ hiển thị một lần — InterMIND chỉ lưu trữ một mã băm (hash). - Thu hồi khóa từ cùng thẻ đó bất cứ lúc nào. Các đăng ký webhook được tạo bằng khóa đó sẽ dừng lại ngay lập tức.
Tối đa 10 khóa cho mỗi tài khoản. Gửi khóa dưới dạng bearer token:
Authorization: Bearer imk_…
Khóa chỉ hoạt động trên các endpoint /api/v1 bên dưới; chúng không bao giờ cấp quyền truy cập vào API riêng của ứng dụng web.
Zapier
- Trong Zapier, thêm ứng dụng InterMIND vào Zap và dán khóa API của bạn khi được yêu cầu. Kết nối được gắn nhãn bằng email tài khoản của bạn.
- Trình kích hoạt Meeting Recap Ready — kích hoạt một lần cho mỗi cuộc họp do bạn tổ chức khi hoàn tất, ngay khi bản tóm tắt xuất hiện. Các trường: tiêu đề cuộc họp và liên kết, liên kết bản tóm tắt, liên kết bản ghi chép, bản tóm tắt bằng Markdown, ngôn ngữ bản tóm tắt, thời gian bắt đầu và kết thúc, người tham gia (tên, email), người tổ chức.
- Hành động Create Meeting Link — tạo một cuộc họp ad-hoc do bạn sở hữu và trả về URL của nó. Đặt nó vào một thỏa thuận CRM, một yêu cầu hỗ trợ hoặc một lời mời lịch; bất kỳ ai mở liên kết sẽ "gõ cửa" và bạn phê duyệt họ vào phòng.
Các Zap điển hình: bản tóm tắt → ghi chú mới trên thỏa thuận HubSpot; bản tóm tắt → bình luận nội bộ trên yêu cầu Zendesk; bản tóm tắt → hàng mới trong Google Sheets; thỏa thuận Pipedrive mới → liên kết cuộc họp được ghi ngược lại vào thỏa thuận.
Endpoints
URL cơ sở: https://intermind.com/api/v1. Tất cả phản hồi là JSON. Hợp đồng thân thiện với máy (OpenAPI 3.1, dành cho Make, n8n, Pipedream và các tác nhân AI): https://intermind.com/api/v1/openapi.json.
| Phương thức | Đường dẫn | Mục đích |
|---|---|---|
GET | /me | Ai sở hữu khóa: { id, email, name } |
POST | /meetings | Tạo liên kết cuộc họp ad-hoc. Thân bài { "title": "…" } (tùy chọn). Trả về 201 { id, url, title, created_at }. Với starts_at (YYYY-MM-DDTHH:mm), time_zone, tùy chọn duration_min và invitees, cuộc họp cũng được ghi vào lịch được kết nối của bạn; phản hồi bổ sung thêm khoảng thời gian và calendar: created / not_connected / failed |
GET | /meetings?kind=recent|upcoming&type=&limit=10 | Các cuộc họp bạn tổ chức hoặc tham gia: recent theo hoạt động cuối cùng, upcoming được lên lịch trong tương lai |
GET | /meetings/{id}/transcript?session=&max_chars=60000 | Bản ghi chép đã hoàn chỉnh mới nhất dưới dạng Markdown theo người nói, bằng ngôn ngữ được sử dụng (hoặc bản dịch đã lưu trong bộ nhớ đệm của bạn); truncated khi bị cắt bớt |
GET | /recaps?limit=3 | Các bản tóm tắt mới nhất của bạn (1–10), mới nhất trước, theo định dạng payload webhook |
GET | /recaps/search?q=&limit=5 | Các bản tóm tắt có tiêu đề hoặc tóm tắt hiện tại đề cập từ khóa (khớp các dạng từ), kèm đoạn trích được đánh dấu và các liên kết |
GET | /channels?limit=20 | Các đoạn chat nhóm và hộp thư mà bạn thuộc về |
GET | /channels/{id}/messages?limit=50&before= | Một trang chat của kênh, cũ nhất trước, kèm bản dịch sang ngôn ngữ chat của bạn được lưu trong bộ nhớ đệm khi phòng chat có bản dịch đó |
POST | /channels/{id}/messages | Đăng { "text": "…" } dưới tên bạn → 201 { id, sent_at, text }; được phát sóng trực tiếp và dịch cho từng người đọc |
GET | /documents?meeting_id=&limit=50 | Các tệp được chia sẻ trong cuộc họp của bạn — các tệp tải lên và các tệp Drive / OneDrive được liên kết |
GET | /webhooks | Các đăng ký webhook của bạn |
POST | /webhooks | Đăng ký: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | Hủy đăng ký → 204 |
Một khóa mang theo các quyền được tạo cùng với nó: các khóa được tạo trước tháng 9 năm 2026 chỉ mở /me, POST /meetings, /recaps và /webhooks — các endpoint mới hơn sẽ trả về 403 cho đến khi bạn tạo khóa mới (hoặc kết nối lại ứng dụng). Quyền đọc bị giới hạn ở các cuộc họp do bạn tổ chức hoặc tham gia: ID của cuộc họp khác sẽ trả về 404.
Giới hạn: 10 khóa và 20 đăng ký webhook cho mỗi tài khoản. target_url phải là https:// và có thể truy cập công khai — các địa chỉ mạng riêng tư sẽ bị từ chối.
Webhook: recap.ready
Được gửi dưới dạng POST JSON đến mọi target_url đã đăng ký ngay khi bản tóm tắt cho cuộc họp do bạn tổ chức được hoàn tất với một bản tóm tắt không trống. Nó được gửi một lần cho mỗi phiên cuộc họp. Các tiêu đề:
| Tiêu đề | Giá trị |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | ID duy nhất của sự kiện này (<meeting id>.<session id>) — dựa vào nó để khử trùng lặp |
X-InterMIND-Signature | sha256=<HMAC-SHA256 của phần thân gốc với khóa bí mật của đăng ký> |
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" }
}
Quy tắc gửi: endpoint của bạn nên phản hồi 2xx trong vòng 8 giây. Lỗi mạng, 5xx hoặc 429 sẽ được thử lại ngay lập tức một lần. Lỗi 410 hoặc 404 sẽ xóa đăng ký. Bất kỳ lỗi nào khác đều được ghi lại và sự kiện không được gửi lại — email bản tóm tắt và trang bản tóm tắt vẫn là hồ sơ lưu trữ lâu dài. Các liên kết tóm tắt và bản ghi chép sẽ mở cho những người tham gia cuộc họp đã đăng nhập.
Telegram
Chuyển tiếp tin nhắn đến bot InterMIND, sao chép các nhóm Telegram vào kênh, và điều hướng tin nhắn vào Hộp thư đến của bạn.
Email tới kênh
Cấp địa chỉ email của kênh cho bất kỳ dịch vụ nào và tin nhắn của dịch vụ đó sẽ được đưa vào kênh — tệp đính kèm nguyên vẹn, được từng thành viên đọc bằng ngôn ngữ của riêng họ.