API & Zapier
API & Zapier
InterMIND'ın ürettiği her özet, hiç kimsenin elle kopyalamasına gerek kalmadan çalıştığınız araca — CRM'inize, yardım masanıza, görev takipçinize veya bir e-tabloya — aktarılabilir. Bunu yapmanın iki yolu vardır:
- Zapier (kodsuz): InterMIND'ı bir API anahtarıyla bir kez bağlayın, ardından Meeting Recap Ready tetikleyicisi ve Create Meeting Link aksiyonu üzerinde Zap'lar oluşturun. Aynı entegrasyon, aşağıdaki API'yi kullanarak Make, n8n veya Pipedream üzerinden kendi genel webhook ve HTTP modülleriyle de çalışır.
- API (geliştiriciler için): kişisel bir anahtar, bir webhook olayı ve üç uç nokta.
Erişilebilirlik: Kayıtlı her hesap. Misafirler anahtar oluşturamaz. Konum: Ayarlar → API anahtarları.
API anahtarları
- Ayarlar'ı açın ve API anahtarları kartını bulun.
- Anahtar oluştur'a tıklayın, bir etiket verin (kullanacağı araç, örn. "Zapier") ve anahtarı kopyalayın.
imk_ile başlar ve yalnızca bir kez gösterilir — InterMIND yalnızca bir hash saklar. - Aynı karttan anahtarı istediğiniz zaman iptal edin. Bu anahtarla oluşturulan webhook abonelikleri anında durur.
Hesap başına en fazla 10 anahtar. Anahtarı bir 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 asla erişim izni vermezler.
Zapier
- Zapier'de, InterMIND uygulamasını bir Zap'a ekleyin ve istendiğinde API anahtarınızı yapıştırın. Bağlantı, hesap e-postanızla etiketlenir.
- Meeting Recap Ready tetikleyicisi — ev sahipliği yaptığınız her biten toplantı için özet mevcut olduğu anda tetiklenir. Alanlar: toplantı başlığı ve bağlantısı, özet bağlantısı, deşifre bağlantısı, Markdown formatındaki özet, özet dili, başlangıç ve bitiş saati, katılımcılar (ad, e-posta), ev sahibi.
- Create Meeting Link aksiyonu — sahibi olduğunuz geçici bir toplantı oluşturur ve URL'sini döndürür. Bir CRM anlaşmasına, bir destek biletine veya bir takvim davetine yerleştirin; bağlantıyı açan herkes kapıyı çalar ve siz onları odada onaylarsınız.
Tipik Zap'lar: özet → HubSpot anlaşmasında yeni not; özet → Zendesk biletinde iç yorum; özet → Google Sheets'te satır; yeni Pipedrive anlaşması → toplantı bağlantısının anlaşmaya geri yazılması.
Uç Noktalar
Temel URL: https://intermind.com/api/v1. Tüm yanıtlar JSON'dur. Makine tarafından okunabilir sözleşme (Make, n8n, Pipedream ve yapay zeka ajanları için OpenAPI 3.1): https://intermind.com/api/v1/openapi.json.
| Metot | Yol | Amaç |
|---|---|---|
GET | /me | Anahtarın sahibi: { id, email, name } |
POST | /meetings | Geçici bir toplantı bağlantısı oluştur. Gövde { "title": "…" } (isteğe bağlı). 201 { id, url, title, created_at } döndürür |
GET | /recaps?limit=3 | En yeni özetleriniz (1–10), en yeni önce, webhook payload şeklinde |
GET | /webhooks | Webhook abonelikleriniz |
POST | /webhooks | Abone ol: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | Abonelikten çık → 204 |
Sınırlar: Hesap başına 10 anahtar ve 20 webhook aboneliği. target_url https:// olmalı ve herkese açık şekilde erişilebilir olmalıdır — özel ağ adresleri reddedilir.
Webhook: recap.ready
Abone olunan tüm target_url adreslerine, ev sahipliği yaptığınız bir toplantının özeti boş olmayan bir özet metniyle tamamlandığı anda 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>) — üzerinde tekilleştirme yapın |
| X-InterMIND-Signature | sha256=<aboneliğin sırrıyla (secret) ham gövdenin HMAC-SHA256'si> |
| 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" }
}
Dağıtım kuralları: uç noktanız 8 saniye içinde 2xx yanıtı vermelidir. Bir ağ hatası, 5xx veya 429 hatası anında bir kez daha denenir. 410 veya 404 hatası 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 deşifre bağlantıları, oturum açmış toplantı katılımcıları için açılır.