API & Zapier
API & Zapier
InterMIND'in ürettiği her özet, çalıştığınız araca — CRM'inize, yardım masanıza, görev takip aracınıza veya bir e-tabloya — kimsenin elle kopyalamasına gerek kalmadan ulaşabilir. Üç yol:
- Yapay zeka asistanınız (Claude, ChatGPT, Copilot, Gemini ve diğer herhangi bir MCP istemcisi): bkz. Yapay zeka asistanları (MCP).
- Zapier (kodsuz): InterMIND'i bir API anahtarıyla bir kez bağlayın, ardından Meeting Recap Ready tetikleyicisi ve Create Meeting Link eylemi üzerinden Zap'ler oluşturun. Aynı entegrasyon, aşağıdaki API kullanılarak Make, n8n veya Pipedream'in genel webhook ve HTTP modülleri aracılığıyla da çalışır.
- API (geliştiriciler için): kişisel bir anahtar, bir webhook olayı ve bir düzine uç nokta — toplantılar, özetler, transkriptler, kanallar, belgeler.
Kullanılabilir: kayıtlı her hesap. Misafirler anahtar oluşturamaz. Nerede: Entegrasyonlar → API anahtarları.
API anahtarları
- Entegrasyonlar'ı açın ve API anahtarları kartını bulun.
- Anahtar oluştur'a tıklayın, bir etiket verin (kullanılacak araç, örn. "Zapier") ve anahtarı kopyalayın.
imk_ile başlar ve yalnızca bir kez gösterilir — InterMIND yalnızca bir hash saklar. - Anahtarı istediğiniz zaman aynı karttan iptal edin. Bu anahtarla oluşturulan webhook abonelikleri anında durur.
Hesap başına en fazla 10 anahtar. Anahtarı bearer token olarak gönderin:
Authorization: Bearer imk_…
Anahtarlar yalnızca aşağıdaki /api/v1 uç noktalarında çalışır; web uygulamasının kendi API'sine erişim izni vermezler.
Zapier
- Zapier'de bir Zap'a InterMIND uygulamasını ekleyin ve istendiğinde API anahtarınızı yapıştırın. Bağlantı, hesap e-postanızla etiketlenir.
- Meeting Recap Ready tetikleyicisi — düzenlediğiniz her biten toplantı için, özet var olunca bir kez tetiklenir. Alanlar: toplantı başlığı ve bağlantısı, özet bağlantısı, transkript bağlantısı, Markdown formatında özet, özet dili, başlangıç ve bitiş zamanı, katılımcılar (ad, e-posta), toplantı sahibi.
- Create Meeting Link eylemi — sahip olduğunuz anlık bir toplantı oluşturur ve URL'sini döndürür. Bir CRM fırsatına, destek biletine veya takvim davetine yerleştirin; bağlantıyı açan herkes kapıyı çalar ve siz onları odaya alırsınız.
Tipik Zap'ler: özet → HubSpot fırsatında yeni not; özet → Zendesk biletinde dahili yorum; özet → Google Sheets'te satır; yeni Pipedrive fırsatı → fırsata yazılan toplantı bağlantısı.
Uç noktalar
Temel URL: https://intermind.com/api/v1. Tüm yanıtlar JSON'dur. Makine tarafından okunabilir sözleşme (OpenAPI 3.1, Make, n8n, Pipedream ve yapay zeka ajanları için): https://intermind.com/api/v1/openapi.json.
| Yöntem | Yol | Amaç |
|---|---|---|
GET | /me | Anahtarın sahibi: { id, email, name } |
POST | /meetings | Anlık bir toplantı bağlantısı oluşturur. Gövde { "title": "…" } (isteğe bağlı). 201 { id, url, title, created_at } döndürür. starts_at (YYYY-MM-DDTHH:mm), time_zone, isteğe bağlı duration_min ve invitees ile toplantı bağlı takviminize de yazılır; yanıt zaman penceresini ve calendar: created / not_connected / failed bilgisini ekler |
GET | /meetings?kind=recent|upcoming&type=&limit=10 | Düzenlediğiniz veya katıldığınız toplantılar: recent son aktiviteye göre, upcoming gelecekte planlananlar |
GET | /meetings/{id}/transcript?session=&max_chars=60000 | Konuşmacıya göre Markdown formatında son kesinleşmiş transkript, konuşulan dilde (veya önbelleğe alınmış çevirinizde); kesildiğinde truncated |
GET | /recaps?limit=3 | En yeni özetleriniz (1–10), en yeni önce, webhook yük biçiminde |
GET | /recaps/search?q=&limit=5 | Başlığında veya geçerli özetinde kelimeler geçen özetler (kelime biçimleri eşleşir), vurgulanmış parçacık ve bağlantılarla |
GET | /channels?limit=20 | Üye olduğunuz takım sohbetleri ve gelen kutuları |
GET | /channels/{id}/messages?limit=50&before= | Bir kanalın sohbetinden bir sayfa, en eski önce, oda çeviri yaptığında sohbet dilinize önbelleğe alınmış çeviriyle |
POST | /channels/{id}/messages | { "text": "…" }'i sizin adınıza gönderir → 201 { id, sent_at, text }; her okuyucu için canlı olarak dağıtılır ve çevrilir |
GET | /documents?meeting_id=&limit=50 | Toplantılarınıza paylaşılan dosyalar — yüklemeler ve bağlı Drive / OneDrive dosyaları |
GET | /webhooks | Webhook abonelikleriniz |
POST | /webhooks | Abone olun: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | Aboneliği iptal et → 204 |
Bir anahtar, oluşturulduğu hakları taşır: Eylül 2026'dan önce oluşturulan anahtarlar yalnızca /me, POST /meetings, /recaps ve /webhooks uç noktalarını açar — yeni bir anahtar oluşturana (veya uygulamayı yeniden bağlayana) kadar daha yeni uç noktalar 403 yanıt verir. Okuma, düzenlediğiniz veya katıldığınız toplantılarla sınırlıdır: başka bir toplantının kimliği 404 yanıt verir.
Sınırlar: hesap başına 10 anahtar ve 20 webhook aboneliği. target_url https:// olmalı ve herkese açık olmalıdır — özel ağ adresleri reddedilir.
Webhook: recap.ready
Düzenlediğiniz bir toplantının özeti, boş olmayan bir özet metniyle tamamlandığı an her abone olunan target_url'ye POST JSON olarak gönderilir. Toplantı oturumu başına bir kez gönderilir. Başlıklar:
| Başlık | Değer |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | Bu olayın benzersiz kimliği (<meeting id>.<session id>) — yinelenenleri kaldırmak için bunu kullanın |
X-InterMIND-Signature | sha256=<aboneliğin gizli anahtarı ile ham gövdenin HMAC-SHA256 değeri> |
User-Agent | InterMIND-Webhooks/1 |
Yük:
{
"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" }
}
Teslimat kuralları: uç noktanız 8 saniye içinde 2xx yanıtı vermelidir. Bir ağ hatası, 5xx veya 429 hemen bir kez yeniden denenir. 410 veya 404 aboneliği siler. Diğer tüm hatalar kaydedilir ve olay yeniden gönderilmez — özet e-postası ve özet sayfası kalıcı kayıt olarak kalır. Özet ve transkript bağlantıları, oturum açmış toplantı katılımcıları için açılır.