Capsule CRM Automation

Capsule CRM'inizi yönetin -- kişiler oluşturun ve güncelleyin, taraflar/fırsatlar/vakalar üzerinde güçlü filtre sorguları çalıştırın, görevleri ve projeleri takip edin, etkinlik girişlerine göz atın ve ekip ilişkilerini organize edin -- tümü doğal dil komutları aracılığıyla.

Toolkit dokümanları: composio.dev/toolkits/capsule_crm

---

Kurulum

1. Composio MCP sunucusunu istemci yapılandırmanıza ekleyin:

   https://rube.app/mcp
   

2. İstendiğinde Capsule CRM hesabınızı bağlayın (OAuth kimlik doğrulaması).
3. CRM'inizi yönetmek için doğal dil komutları vermeye başlayın.

---

Temel İş Akışları

1. Yapılandırılmış Filtre Sorguları Çalıştırın

Tarafları, fırsatları veya vakaları (projeleri) birden fazla filtre koşulu, operatör ve sıralama ile sorgulayın.

Tool: CAPSULE_CRM_RUN_FILTER_QUERY

Örnek istem:

"Capsule CRM'de California'daki 'VIP' etiketi taşıyan tüm kişileri ad sırasına göre bul"

Anahtar parametreler:

• entity (gerekli) -- Biri: parties, opportunities, kases
• filter (gerekli) -- Filtre nesnesi:
  • conditions -- Her biri şunları içeren koşul dizisi:
    • field -- Alan adı (örn. "name", "email", "state", "country", "tag", "owner", "jobTitle", "addedOn")
    • operator -- Biri: "is", "is not", "starts with", "ends with", "contains", "is greater than", "is less than", "is after", "is before", "is older than", "is within last", "is within next"
    • value -- Karşılaştırmak için değer
  • orderBy -- field ve direction ("ascending"/"descending") içeren sıralama nesneleri dizisi
• embed -- Yanıta dahil edilecek ek veriler
• page / perPage -- Sayfalandırma (sayfa başına max 100)

Önemli alan notları:

• Adres alanları (city, state, country, zip) en üst seviyede, "address" altında İÇ içe DEĞİL
• Ülke ISO 3166-1 alpha-2 kodu olmalıdır (örn. "US", "GB", "CA")
• Özel alanlar custom:{fieldId} formatını kullanır
• Organizasyon alanları org. önekini kullanır (örn. org.name, org.tag)

---

2. Kişileri Listeleyin ve Yönetin (Taraflar)

Değişiklik tarihine ve ilişkili veriye göre isteğe bağlı filtreleme ile tüm kişileri alın.

Tool: CAPSULE_CRM_LIST_PARTIES

Örnek istem:

"Ocak 2025'ten beri değiştirilmiş tüm Capsule CRM kişilerini etiketleri ve organizasyonları ile listele"

Anahtar parametreler:

• since -- Bu tarihten sonra değiştirilmiş kişileri filtrelemek için ISO8601 tarihi
• embed -- Ek veriler: "tags", "fields", "organisation", "missingImportantFields"
• page / perPage -- Sayfalandırma (sayfa başına max 100, varsayılan 50)

---

3. Yeni Kişi Oluşturun

Emails, telefonlar, adresler, etiketler ve özel alanlar dahil tüm detaylarla Capsule CRM'inize kişi veya organizasyon ekleyin.

Tool: CAPSULE_CRM_CREATE_PARTY

Örnek istem:

"Capsule CRM'ye yeni kişi oluştur: John Smith, Acme Corp'ta Satış Müdürü, john@acme.com"

Anahtar parametreler:

• type (gerekli) -- "person" veya "organisation"
• Kişiler için: firstName, lastName, jobTitle, title
• Organizasyonlar için: name
• emailAddresses -- {address, type} nesneleri dizisi
• phoneNumbers -- {number, type} nesneleri dizisi
• addresses -- street, city, state, country, zip, type (Home/Postal/Office/Billing/Shipping) içeren adres nesneleri dizisi
• organisation -- Org'a {id} veya {name} ile bağlantı (bulunamazsa oluştur)
• tags -- {name} veya {id} ile etiketler dizisi
• fields -- {definition, value} ile özel alan değerleri
• websites -- {address, service, type} nesneleri dizisi
• owner -- Sahip kullanıcı {id} atayın

---

4. Mevcut Kişileri Güncelleyin

Emails, telefonlar, etiketler ve özel alanlar ekleme/kaldırma dahil olmak üzere bir taraf kaydının herhangi bir yönünü değiştirin.

Tool: CAPSULE_CRM_UPDATE_PARTY

Örnek istem:

"Capsule CRM tarafı 11587'yi güncelleyin: iş e-postası john.new@acme.com ekleyin ve 'prospect' etiketini kaldırın"

Anahtar parametreler:

• partyId (gerekli) -- Güncellenecek tarafın tamsayı ID'si
• party (gerekli) -- Güncellenecek alanları içeren nesne. Destekler:
  • Tüm oluşturma alanları (name, emails, phones, addresses, vb.)
  • Alt öğeleri kaldırmak için _delete: true (öğenin id'si gerekli)
  • Etiketler: {name} ile ekle veya {id, _delete: true} ile kaldır

---

5. Görevleri Takip Edin

Duruma ve ilişkili veriye göre filtreleme ile görevleri listeleyin.

Tool: CAPSULE_CRM_LIST_TASKS

Örnek istem:

"Capsule CRM'de tüm açık görevleri ilişkili taraflar ve sahipleri ile göster"

Anahtar parametreler:

• status -- Duruma göre filtrele: "open", "completed", "pending" (dizi)
• embed -- Ek veriler: "party", "opportunity", "kase", "owner", "nextTask"
• page / perPage -- Sayfalandırma (sayfa başına max 100, varsayılan 50)

---

6. Projeleri ve Etkinlik Girişlerini Tarayın

Notları, e-postaları ve tamamlanan görevleri içeren projeleri (vakaları) ve son etkinlik girişlerini listeleyin.

Tools: CAPSULE_CRM_LIST_PROJECTS, CAPSULE_CRM_LIST_ENTRIES_BY_DATE

Örnek istem:

"Capsule CRM'de tüm açık projeleri göster" / "Taraf detayları ile son etkinlik girişlerini göster"

Projeler için anahtar parametreler:

• status -- "OPEN" veya "CLOSED" ile filtrele
• search -- Proje adları/açıklamaları için arama terimi
• since -- Bu tarihten sonra değişiklikler için ISO8601 tarihi
• embed -- "tags,fields,party,opportunity,missingImportantFields"

Girişler için anahtar parametreler:

• embed -- "party", "kase", "opportunity", "creator", "activityType"
• page / perPage -- Sayfalandırma (sayfa başına max 100)

---

Bilinen Sorunlar

• Adres alanları en üst seviyededir: Filtrelerken state, city, country, zip doğrudan kullanın -- address.state veya iç içe sözdizimi DEĞİL.
• Ülke kodları ISO alpha-2: "US", "GB", "CA" ile filtrele -- "United States" veya "United Kingdom" DEĞİL.
• Özel alanlar özel sözdizimi kullanır: Filtre koşullarında özel alanları custom:{fieldId} olarak referans yapın. Org düzeyinde özel alanlar için org.custom:{fieldId} kullanın.
• Projeler API'de "kases" olarak adlandırılır: UI'de "projects" olmasına rağmen, API entity türü kases'dir. Filtre sorgularında kases kullanın.
• Silme işlemleri öğe ID'leri gerektirir: Bir tarafı alt öğeleri (emails, phones, tags) kaldırmak için güncellerken, öğenin id'sini _delete: true ile birlikte dahil etmelisiniz. Alt öğe ID'lerini almak için önce tarafı listeleyin.
• Sayfalandırma varsayılan olarak 50'dir: Tüm list endpoint'leri sayfa başına 50 öğe ile varsayılan olarak max 100'dür. Tam veri alımı için her zaman sayfalandırma uygulayın.
• Embed değerleri entity'ye göre değişir: Tüm embed seçenekleri tüm entity'ler için çalışmaz. Endpoint başına desteklenen embed değerleri için dokümantasyonu kontrol edin.

---

Hızlı Referans

İşlem	Tool Slug	Gerekli Parametreler
Filtre sorgusu çalıştır	CAPSULE_CRM_RUN_FILTER_QUERY	entity, filter
Kişileri listele	CAPSULE_CRM_LIST_PARTIES	Hiçbiri (isteğe bağlı filtreler)
Kişi oluştur	CAPSULE_CRM_CREATE_PARTY	type
Kişiyi güncelle	CAPSULE_CRM_UPDATE_PARTY	partyId, party
Kişiyi sil	CAPSULE_CRM_DELETE_PARTY	party_id
Görevleri listele	CAPSULE_CRM_LIST_TASKS	Hiçbiri (isteğe bağlı filtreler)
Projeleri listele	CAPSULE_CRM_LIST_PROJECTS	Hiçbiri (isteğe bağlı filtreler)
Etkinlik girişlerini listele	CAPSULE_CRM_LIST_ENTRIES_BY_DATE	Hiçbiri (isteğe bağlı filtreler)
Org çalışanlarını listele	CAPSULE_CRM_LIST_ORG_EMPLOYEES	Organizasyon ID
Silinmiş fırsatları listele	CAPSULE_CRM_LIST_DELETED_OPPORTUNITIES	since

---

Composio tarafından desteklenmektedir