API & Zapier
API & Zapier
Mọi bản tóm tắt mà InterMIND tạo ra đều có thể được gửi đến công cụ bạn đang sử dụng — CRM, hệ thống 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ó hai cách để thực hiện:
- Zapier (không cần code): kết nối InterMIND một lần với API key, sau đó tạo Zaps dựa trên trigger Meeting Recap Ready và action Create Meeting Link. Tích hợp này cũng hoạt động từ Make, n8n hoặc Pipedream thông qua webhook và HTTP module 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à ba endpoint.
Khả dụng cho: mọi tài khoản đã đăng ký. Khách không thể tạo khóa. Vị trí: Settings → API keys.
API keys
- Mở Settings và tìm thẻ API keys.
- Nhấp vào Create key, đặ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ữ 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 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_…
Các 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 một Zap và dán API key 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.
- Trigger Meeting Recap Ready — kích hoạt một lần cho mỗi cuộc họp bạn tổ chức đã kết thúc, ngay khi bản tóm tắt xuất hiện. Các trường dữ liệu: tiêu đề và liên kết cuộc họp, liên kết recap, liên kết transcript, bản tóm tắt ở dạ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ổ (host).
- Action 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 deal CRM, ticket hỗ trợ hoặc 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 Zaps điển hình: recap → ghi chú mới trên HubSpot deal; recap → bình luận nội bộ trên Zendesk ticket; recap → hàng mới trong Google Sheets; Pipedrive deal mới → liên kết cuộc họp được ghi ngược lại vào deal.
Endpoints
URL cơ sở: https://intermind.com/api/v1. Mọi phản hồi đều là JSON. Hợp đồng máy đọc được (OpenAPI 3.1, dành cho Make, n8n, Pipedream và các AI agent): 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. Body { "title": "…" } (tùy chọn). Trả về 201 { id, url, title, created_at } |
GET | /recaps?limit=3 | Các recap mới nhất của bạn (1–10), mới nhất trước, theo định dạng webhook payload |
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 |
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 một cuộc họp do bạn tổ chức được hoàn tất với nội dung 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 header:
| Header | 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ùng để khử trùng lặp |
X-InterMIND-Signature | sha256=<HMAC-SHA256 of the raw body with the subscription's 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" }
}
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 một lần ngay lập tức. Mã 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 sẽ không được gửi lại — email recap và trang recap vẫn là bản ghi lưu trữ lâu dài. Các liên kết recap và transcript 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, nhân bản các nhóm Telegram vào các kênh và điều hướng các cuộc trò chuyệ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ọ.