API ו-Zapier

שלחו סיכומי פגישות ל-CRM, למערכת תמיכה או לגיליון אלקטרוני באמצעות Zapier, או פנו ישירות ל-API של InterMIND באמצעות מפתח API אישי.

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

  1. פתחו את Integrations ואתרו את הכרטיס API keys.
  2. לחצו על Create key, תנו למפתח תווית (הכלי שישתמש בו, למשל "Zapier") והעתיקו את המפתח. הוא מתחיל ב-imk_ ומוצג פעם אחת בלבד — InterMIND שומרת רק גיבוב (hash) שלו.
  3. אפשר לבטל מפתח מאותו כרטיס בכל עת. מנויי webhook שנוצרו באמצעות המפתח הזה מפסיקים לפעול מיד.

עד 10 מפתחות לחשבון. שולחים את המפתח כ-bearer token:

Authorization: Bearer imk_…

המפתחות פועלים רק מול נקודות הקצה של /api/v1 המפורטות בהמשך; הם לעולם אינם מעניקים גישה ל-API הפנימי של אפליקציית הווב.

Zapier

  1. ב-Zapier, מוסיפים את האפליקציה InterMIND ל-Zap ומדביקים את מפתח ה-API כשמתבקשים. החיבור מסומן באימייל של החשבון שלכם.
  2. טריגר Meeting Recap Ready — מופעל פעם אחת לכל פגישה שהסתיימה ושאתם אירחתם, ברגע שהסיכום מוכן. שדות: כותרת הפגישה והקישור אליה, קישור לסיכום, קישור לתמלול, הסיכום ב-Markdown, שפת הסיכום, שעת התחלה וסיום, משתתפים (שם, אימייל), מארח.
  3. פעולה 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.

MethodPathPurpose
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):

HeaderValue
X-InterMIND-Eventrecap.ready
X-InterMIND-Deliveryמזהה ייחודי של האירוע הזה (<meeting id>.<session id>) — יש לסנן כפילויות לפיו
X-InterMIND-Signaturesha256=<HMAC-SHA256 of the raw body with the subscription's secret>
User-AgentInterMIND-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 מוחקים את המנוי. כל כשל אחר נרשם ביומן והאירוע אינו נשלח מחדש — אימייל הסיכום ודף הסיכום נשארים הרישום הקבוע. קישורי הסיכום והתמלול נפתחים למשתתפי הפגישה שמחוברים לחשבונם.