API ו-Zapier
API ו-Zapier
כל סיכום ש-InterMIND מפיקה יכול להגיע ישירות לכלי שבו אתם עובדים — ה-CRM, מערכת ה-help desk, כלי ניהול המשימות או גיליון נתונים — בלי שאף אחד יצטרך להעתיק אותו ידנית. שלוש דרכים להתחבר:
- עוזר ה-AI שלכם (Claude, ChatGPT, Copilot, Gemini וכל לקוח MCP אחר): ראו עוזרי AI (MCP).
- Zapier (ללא קוד): מחברים את InterMIND פעם אחת באמצעות מפתח API, ואז בונים Zaps על הטריגר Meeting Recap Ready ועל הפעולה Create Meeting Link. אותה אינטגרציה פועלת גם מ-Make, מ-n8n או מ-Pipedream דרך מודולי ה-webhook וה-HTTP הכלליים שלהם, באמצעות ה-API שמתואר בהמשך.
- ה-API (למפתחים): מפתח אישי, אירוע webhook אחד ובערך tuzin נקודות קצה — פגישות, סיכומים, תמלולים, ערוצים, מסמכים.
זמין ל: כל חשבון רשום. אורחים אינם יכולים ליצור מפתחות. היכן: Integrations → API keys.
מפתחות API
- פתחו את Integrations ואתרו את הכרטיס API keys.
- לחצו על Create key, תנו למפתח תווית (הכלי שישתמש בו, למשל "Zapier") והעתיקו את המפתח. הוא מתחיל ב-
imk_ומוצג פעם אחת בלבד — InterMIND שומרת רק גיבוב (hash) שלו. - אפשר לבטל מפתח מאותו כרטיס בכל עת. מנויי webhook שנוצרו באמצעות המפתח הזה מפסיקים לפעול מיד.
עד 10 מפתחות לחשבון. שולחים את המפתח כ-bearer token:
Authorization: Bearer imk_…
המפתחות פועלים רק מול נקודות הקצה של /api/v1 המפורטות בהמשך; הם לעולם אינם מעניקים גישה ל-API הפנימי של אפליקציית הווב.
Zapier
- ב-Zapier, מוסיפים את האפליקציה InterMIND ל-Zap ומדביקים את מפתח ה-API כשמתבקשים. החיבור מסומן באימייל של החשבון שלכם.
- טריגר Meeting Recap Ready — מופעל פעם אחת לכל פגישה שהסתיימה ושאתם אירחתם, ברגע שהסיכום מוכן. שדות: כותרת הפגישה והקישור אליה, קישור לסיכום, קישור לתמלול, הסיכום ב-Markdown, שפת הסיכום, שעת התחלה וסיום, משתתפים (שם, אימייל), מארח.
- פעולה Create Meeting Link — יוצרת פגישה ספונטנית שבבעלותכם ומחזירה את הכתובת שלה. אפשר להוסיף אותה לעסקה ב-CRM, לפנייה בתמיכה או להזמנה ביומן; כל מי שפותח את הקישור ממתין בדלת ואתם מאשרים אותו בחדר.
דוגמאות ל-Zaps אופייניים: סיכום ← הערה חדשה בעסקה ב-HubSpot; סיכום ← הערה פנימית בפנייה ב-Zendesk; סיכום ← שורה ב-Google Sheets; עסקה חדשה ב-Pipedrive ← קישור לפגישה שנכתב חזרה לעסקה.
נקודות קצה
כתובת בסיס: https://intermind.com/api/v1. כל התשובות הן JSON. חוזה קריא למכונה (OpenAPI 3.1, עבור Make, n8n, Pipedream וסוכני AI): https://intermind.com/api/v1/openapi.json.
| Method | Path | Purpose |
|---|---|---|
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), מהחדש לישן, במבנה המטען (payload) של ה-webhook |
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 עד שתיצרו מפתח חדש (או תחברו מחדש את האפליקציה). הקריאה מוגבלת לפגישות שאתם מארחים או משתתפים בהן: מזהה של פגישה אחרת מחזיר 404.
מגבלות: 10 מפתחות ו-20 מנויי webhook לחשבון. target_url חייב להיות https:// ונגיש לציבור — כתובות ברשת פרטית נדחות.
Webhook: recap.ready
נשלח כבקשת POST עם JSON לכל target_url רשום, ברגע שסיכום של פגישה שאתם אירחתם מושלם עם סיכום שאינו ריק. הוא נשלח פעם אחת לכל סשן של פגישה. כותרות (Headers):
| Header | Value |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | מזהה ייחודי של האירוע הזה (<meeting id>.<session id>) — יש לסנן כפילויות לפיו |
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" }
}
כללי מסירה: נקודת הקצה שלכם צריכה להשיב 2xx בתוך 8 שניות. שגיאת רשת, 5xx או 429 מנוסים שוב פעם אחת מיד. 410 או 404 מוחקים את המנוי. כל כשל אחר נרשם ביומן והאירוע אינו נשלח מחדש — אימייל הסיכום ודף הסיכום נשארים הרישום הקבוע. קישורי הסיכום והתמלול נפתחים למשתתפי הפגישה שמחוברים לחשבונם.