InterMIND

API و Zapier

أرسل ملخصات الاجتماعات إلى CRM أو مكتب المساعدة أو جدول البيانات الخاص بك باستخدام Zapier، أو استدعِ InterMIND API مباشرةً باستخدام مفتاح API شخصي.

API و Zapier

يمكن لكل ملخص ينتجه InterMIND أن يصل مباشرة إلى الأداة التي تعمل بها — سواء كان نظام CRM، أو مكتب مساعدة، أو متتبع مهام، أو جدول بيانات — دون الحاجة لأن ينسخه أحد يدوياً. هناك طريقتان للقيام بذلك:

  • Zapier (بدون كود): اربط InterMIND مرة واحدة باستخدام مفتاح API، ثم قم ببناء Zaps استناداً إلى مشغل Meeting Recap Ready وإجراء Create Meeting Link. يعمل التكامل ذاته أيضاً عبر Make أو n8n أو Pipedream من خلال وحدات webhook و HTTP العامة الخاصة بهم، باستخدام واجهة API أدناه.
  • واجهة API (للمطورين): مفتاح شخصي، وحدث webhook واحد، وثلاث نقاط نهاية (endpoints).

متوفر في: كل حساب مسجل. لا يمكن للضيوف إنشاء المفاتيح. المكان: الإعدادات ← مفاتيح API.

تصل الملخصات أيضاً إلى أي أداة تمتلك عنوان بريد إلكتروني وارد — ما عليك سوى إضافته كمستلم لنسخة الملخص في الاجتماع أو القناة، دون الحاجة إلى أي تكامل. راجع نسخة الملخص.

مفاتيح API

  1. افتح الإعدادات وابحث عن بطاقة مفاتيح API.
  2. انقر فوق إنشاء مفتاح، أعطِه تسمية (الأداة التي ستستخدمه، مثل "Zapier") وانسخ المفتاح. يبدأ بـ imk_ ويُعرض مرة واحدة فقط — يخزن InterMIND التجزئة (hash) فقط.
  3. أبطِل أي مفتاح من نفس البطاقة في أي وقت. تتوقف اشتراكات webhook التي تم إنشاؤها باستخدام ذلك المفتاح على الفور.

حتى 10 مفاتيح لكل حساب. أرسل المفتاح كرمز bearer:

Authorization: Bearer imk_…

تعمل المفاتيح فقط على نقاط النهاية /api/v1 أدناه؛ ولا تمنح أبداً الوصول إلى واجهة API الخاصة بتطبيق الويب نفسه.

Zapier

  1. في Zapier، أضف تطبيق InterMIND إلى Zap والصق مفتاح API الخاص بك عند طلب ذلك. يتم وضع علامة على الاتصال باستخدام بريد حسابك الإلكتروني.
  2. مشغل Meeting Recap Ready — يُطلق مرة واحدة لكل اجتماع تنتهي استضافته، بمجرد أن يصبح الملخص متاحاً. الحقول: عنوان الاجتماع والرابط، رابط الملخص، رابط النسخة النصية، الملخص بصيغة Markdown، لغة الملخص، وقت البداية والنهاية، المشاركون (الاسم، البريد الإلكتروني)، المضيف.
  3. إجراء Create Meeting Link — ينشئ اجتماعاً مخصصاً (ad-hoc) تملكه ويعيد عنوان URL الخاص به. ضعه في صفقة CRM، أو تذكرة دعم، أو دعوة تقويم؛ أي شخص يفتح الرابط يطرق الباب وتقوم أنت بالموافقة عليه في الغرفة.

أمثلة على Zaps النموذجية: ملخص ← ملاحظة جديدة على صفقة HubSpot؛ ملخص ← تعليق داخلي على تذكرة Zendesk؛ ملخص ← صف في Google Sheets؛ صفقة Pipedrive جديدة ← رابط اجتماع يُعاد كتابته إلى الصفقة.

نقاط النهاية (Endpoints)

عنوان URL الأساسي: https://intermind.com/api/v1. جميع الاستجابات هي بصيغة JSON. العقد القابل للقراءة آلياً (OpenAPI 3.1، لـ Make و n8n و Pipedream ووكلاء الذكاء الاصطناعي): https://intermind.com/api/v1/openapi.json.

الطريقةالمسارالغرض
GET/meمن يملك المفتاح: { id, email, name }
POST/meetingsإنشاء رابط اجتماع مخصص. محتوى الطلب { "title": "…" } (اختياري). يُرجع 201 { id, url, title, created_at }
GET/recaps?limit=3أحدث ملخصاتك (1–10)، الأحدث أولاً، بنفس شكل حمولة webhook
GET/webhooksاشتراكات webhook الخاصة بك
POST/webhooksاشتراك: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at }
DELETE/webhooks/{id}إلغاء الاشتراك → 204

الحدود: 10 مفاتيح و 20 اشتراك webhook لكل حساب. يجب أن يكون target_url بصيغة https:// ومتاحاً للوصول العام — يتم رفض عناوين الشبكة الخاصة.

Webhook: recap.ready

يُرسل كـ POST بصيغة JSON إلى كل target_url مشترك في اللحظة التي يصبح فيها ملخص الاجتماع الذي استضفته نهائياً وبملخص غير فارغ. يتم إرساله مرة واحدة لكل جلسة اجتماع. الرؤوس (Headers):

الرأس (Header)القيمة
X-InterMIND-Eventrecap.ready
X-InterMIND-Deliveryمعرف فريد لهذا الحدث (<meeting id>.<session id>) — قم بإزالة التكرار بناءً عليه
X-InterMIND-Signaturesha256=<HMAC-SHA256 للنص الأساسي الخام باستخدام سر الاشتراك>
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" }
}

قواعد التسليم: يجب أن تجيب نقطة النهاية (endpoint) الخاصة بك برمز 2xx خلال 8 ثوانٍ. في حالة وجود خطأ في الشبكة، أو رمز 5xx أو 429، تتم إعادة المحاولة مرة واحدة فوراً. الرمز 410 أو 404 يؤدي إلى حذف الاشتراك. يتم تسجيل أي فشل آخر ولا تتم إعادة إرسال الحدث — يظل بريد الملخص الإلكتروني وصفحة الملخص السجل الدائم. تُفتح روابط الملخص والنسخة النصية للمشاركين في الاجتماع الذين قاموا بتسجيل الدخول.

Telegram

إعادة توجيه الرسائل إلى بوت InterMIND، وعكس مجموعات Telegram في القنوات، وتوجيه المحادثات إلى صندوق الوارد الخاص بك.

البريد الإلكتروني إلى القناة

امنح أي خدمة عنوان البريد الإلكتروني لقناتك، وستصل رسائلها إلى القناة — بمرفقاتها سليمة، ويقرأها كل عضو بلغته الخاصة.