API และ Zapier
API และ Zapier
ทุกสรุปการประชุม (recap) ที่ InterMIND สร้างขึ้นสามารถส่งไปยังเครื่องมือที่คุณใช้งานอยู่ได้ ไม่ว่าจะเป็น CRM, ระบบ help desk, เครื่องมือติดตามงาน หรือสเปรดชีต โดยไม่ต้องมีใครคัดลอกด้วยมือ มีสามวิธีในการเชื่อมต่อ:
- ผู้ช่วย AI ของคุณ (Claude, ChatGPT, Copilot, Gemini และ MCP client อื่น ๆ): ดู ผู้ช่วย AI (MCP)
- Zapier (ไม่ต้องเขียนโค้ด): เชื่อมต่อ InterMIND ครั้งเดียวด้วย API key จากนั้นสร้าง Zap จากทริกเกอร์ Meeting Recap Ready และแอ็กชัน Create Meeting Link การเชื่อมต่อเดียวกันนี้ยังใช้งานได้จาก Make, n8n หรือ Pipedream ผ่านโมดูล webhook และ HTTP ทั่วไปของเครื่องมือเหล่านั้น โดยใช้ API ด้านล่าง
- API (สำหรับนักพัฒนา): คีย์ส่วนบุคคล, webhook event หนึ่งรายการ และเอนด์พอยต์ประมาณสิบกว่ารายการ ครอบคลุมการประชุม สรุป ทรานสคริปต์ แชนเนล และเอกสาร
ใช้งานได้กับ: ทุกบัญชีที่ลงทะเบียน ผู้เข้าร่วมแบบแขกไม่สามารถสร้างคีย์ได้ ตำแหน่ง: Integrations → API keys
API keys
- เปิด Integrations และค้นหาการ์ด API keys
- คลิก Create key ตั้งชื่อป้ายกำกับ (ชื่อเครื่องมือที่จะใช้คีย์นี้ เช่น "Zapier") แล้วคัดลอกคีย์ คีย์จะขึ้นต้นด้วย
imk_และแสดงเพียงครั้งเดียว — InterMIND เก็บเฉพาะค่าแฮชของคีย์ - คุณสามารถเพิกถอนคีย์ได้ทุกเมื่อจากการ์ดเดียวกัน การสมัครรับ webhook ที่สร้างด้วยคีย์นั้นจะหยุดทำงานทันที
สร้างคีย์ได้สูงสุด 10 คีย์ต่อบัญชี ส่งคีย์ในรูปแบบ bearer token:
Authorization: Bearer imk_…
คีย์ใช้งานได้เฉพาะกับเอนด์พอยต์ /api/v1 ด้านล่างเท่านั้น และจะไม่ให้สิทธิ์เข้าถึง API ของเว็บแอปพลิเคชันเอง
Zapier
- ใน Zapier ให้เพิ่มแอป InterMIND ลงใน Zap แล้ววาง API key ของคุณเมื่อระบบขอ การเชื่อมต่อจะแสดงป้ายกำกับเป็นอีเมลบัญชีของคุณ
- ทริกเกอร์ Meeting Recap Ready — ทำงานหนึ่งครั้งต่อการประชุมที่คุณเป็นเจ้าภาพและสิ้นสุดแล้ว ทันทีที่มีสรุปเกิดขึ้น ฟิลด์ที่ให้มา: ชื่อและลิงก์ของการประชุม, ลิงก์สรุป, ลิงก์ทรานสคริปต์, สรุปในรูปแบบ Markdown, ภาษาของสรุป, เวลาเริ่มและเวลาสิ้นสุด, ผู้เข้าร่วม (ชื่อ, อีเมล), เจ้าภาพ
- แอ็กชัน Create Meeting Link — สร้างการประชุมแบบเฉพาะกิจที่คุณเป็นเจ้าของ และส่งคืน URL ของการประชุม นำไปใส่ในดีล CRM, ตั๋วซัพพอร์ต หรือคำเชิญในปฏิทินได้ ผู้ที่เปิดลิงก์จะเข้าสู่สถานะรอ และคุณอนุมัติให้เข้าห้องได้
ตัวอย่าง Zap ที่ใช้บ่อย: สรุป → โน้ตใหม่ในดีล HubSpot; สรุป → ความคิดเห็นภายในในตั๋ว Zendesk; สรุป → แถวใน Google Sheets; ดีล Pipedrive ใหม่ → เขียนลิงก์การประชุมกลับไปที่ดีล
Endpoints
Base URL: https://intermind.com/api/v1 การตอบกลับทั้งหมดเป็น JSON สัญญาที่เครื่องอ่านได้ (OpenAPI 3.1 สำหรับ Make, n8n, Pipedream และ AI agent): https://intermind.com/api/v1/openapi.json
| Method | Path | Purpose |
|---|---|---|
GET | /me | เจ้าของคีย์คือใคร: { id, email, name } |
POST | /meetings | สร้างลิงก์การประชุมแบบเฉพาะกิจ 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 เท่านั้น เอนด์พอยต์ที่ใหม่กว่าจะตอบกลับ 403 จนกว่าคุณจะสร้างคีย์ใหม่ (หรือเชื่อมต่อแอปอีกครั้ง) การอ่านข้อมูลจำกัดเฉพาะการประชุมที่คุณเป็นเจ้าภาพหรือเข้าร่วม: id ของการประชุมอื่นจะตอบกลับ 404
ขีดจำกัด: 10 คีย์และ 20 การสมัครรับ webhook ต่อบัญชี target_url ต้องเป็น https:// และเข้าถึงได้จากสาธารณะ — ที่อยู่เครือข่ายส่วนตัวจะถูกปฏิเสธ
Webhook: recap.ready
ส่งเป็น JSON ด้วย POST ไปยังทุก target_url ที่สมัครรับไว้ ทันทีที่สรุปของการประชุมที่ คุณเป็นเจ้าภาพ เสร็จสมบูรณ์และมีเนื้อหาสรุปไม่ว่างเปล่า ระบบจะส่งหนึ่งครั้งต่อหนึ่งเซสชันการประชุม Headers:
| Header | Value |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | id เฉพาะของอีเวนต์นี้ (<meeting id>.<session id>) — ใช้ตัดข้อมูลซ้ำ |
X-InterMIND-Signature | sha256=<HMAC-SHA256 ของ raw body โดยใช้ 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" }
}
กฎการส่ง: เอนด์พอยต์ของคุณควรตอบกลับ 2xx ภายใน 8 วินาที หากเกิดข้อผิดพลาดของเครือข่าย, 5xx หรือ 429 ระบบจะลองส่งซ้ำหนึ่งครั้งทันที หากได้รับ 410 หรือ 404 ระบบจะลบการสมัครรับ ความล้มเหลวอื่น ๆ จะถูกบันทึกไว้และไม่ส่งอีเวนต์ซ้ำ — อีเมลสรุปและหน้าสรุปยังคงเป็นบันทึกถาวร ลิงก์สรุปและทรานสคริปต์เปิดได้สำหรับผู้เข้าร่วมการประชุมที่ลงชื่อเข้าใช้แล้ว