Bu rehber, EQLEM CRM'i kullandığınız AI ajanına sağlayıcı sağlayıcı nasıl bağlayacağınızı anlatır. Bağlantı OAuth ile kurulur ve ajan yalnızca sizin EQLEM yetkilerinizle çalışır. Genel bakış için CRM modülü sayfasına bakın.

Başlamadan önce

EQLEM'de AI bağlantıları ekranını açın ve MCP URL'sini kopyalayın. Ajanını bağla panelinde ajanınızı seçerseniz o sağlayıcıya özel adımlar ve kopyalanabilir hazır komut/yapılandırma gösterilir. Aşağıdaki her sağlayıcıda bu URL kullanılır. Adres her zaman https:// ile başlar (ör. https://api.firmaniz.com/api/v2/mcp). Komutlarda ve ayarlarda geçen http ise MCP'nin taşıma türünün (Streamable HTTP) adıdır, adresin şeması değildir.
İlk bağlantıda tarayıcıda EQLEM giriş ve onay ekranı açılır. Giriş yapın, ajanın isteyeceği izinlere bakıp onaylayın.
Bağlantıyı istediğiniz an AI bağlantıları ekranından iptal edebilirsiniz.
Kurumsal istemci gereken kurulumlarda (Gemini Enterprise, Copilot Studio Manual) işi Admin yapar: AI bağlantıları ekranında kurumsal OAuth istemcisi oluşturur, client id ve client secret değerlerini oradan alır.

Bağlandıktan sonra ajanınıza "EQLEM'de kim olarak bağlıyım?" diye sorarak bağlantıyı deneyebilirsiniz.

Sürüm notu: Araç adları güncellendi. Daha önce bağlanmış ajanlarda araç listesini yenileyin (bağlayıcıyı yeniden yükleyin ya da yeniden bağlanın).

Ajanınız neler yapabilir?

Ajan CRM'in tüm süreçlerini kapsar; her işlemde kendi EQLEM yetkiniz geçerlidir.

Satış: adaylar ve müşteriler (arama, oluşturma, güncelleme, aday aşaması, etiket ve grup), kişiler, notlar, aktiviteler, fırsatlar (kazanıldı / kaybedildi işaretleme), takvim, grup panosu, bölge, sözleşmeler ve yenileme takibi.
Servis: servis talepleri (satır, atama, yeniden planlama, memnuniyet, SLA değerlendirmesi), varlıklar, gelen çağrılar, dönemsel işlemler, bilgi bankası.
İletişim: şablonlar, gönderilen mesajlar ve takip olayları, gelen kutusu, kampanyalar (taslak, hedef kitle, varyant, karşılaştırma).
Sequence: iletişim akışları, adayı akışa kaydetme, aday iletişim listesi, etkileşimde olan cariler, gönderim planı, adım bazlı performans, temas kuyruğu, yanıt işaretleme, sonuç ve aşama, AI yanıt taslakları, vadesi gelmiş mailleri gönderme.
İçgörü: satış, iletişim, servis ve yönetici raporları, sağlık skorları, uyumluluk durumunu okuma ve ayarları okuma.
Ortak: Projeler (common_project_read) ve Masraf merkezleri (common_cost_center_read) için liste, arama ve detay (belge yetkisi "Proje & Maliyet Merkezi"); Mail gönder (cari dışı) (common_mail_send).

Onay ekranında izin gruplarını seçin

Giriş yaptıktan sonra onay ekranında izin gruplarını görürsünüz: Satış, Servis, İletişim, Sequence, İçgörü; her grup okuma, yazma ve (varsa) gönderim olarak ayrılır. Bunların yanında iki ortak izin vardır: common.definitions.read (Ortak tanımlar: proje ve masraf merkezi okuma) ve common.mail.send (Mail gönderimi: doğrudan mail).
Ajanın yapmasını istediğiniz grupları tek tek seçin; istemediklerinizin işaretini kaldırın (varsayılan olarak hepsi seçilidir; Onayla için en az bir izin seçili olmalıdır).
Ajan yalnız seçtiğiniz gruplardaki, lisansınızın kapsadığı ve EQLEM belge yetkinizin izin verdiği araçları görür. Sonradan kapsamı değiştirmek için bağlantıyı iptal edip yeniden onaylayın.
Onay ekranındaki güven rozetine bakın: Doğrulanmış (firmanızın kurumsal istemcisi), Alan adı doğrulandı (ör. claude.ai; uygulama kendini bu alan adından tanıtıyor) veya Doğrulanmamış (otomatik kayıt; yalnız tanıdığınız uygulamaya izin verin). Yönlendirme adresi tanıdığınız sağlayıcıya ait değilse onaylamayın.

AI bağlantıları sayfası

Bağlantılarım: her bağlantı bir kart (uygulama, güven rozeti, izinler, son yenileme, bitiş). Kullanıcı başına en fazla 5 bağlantı; sayaç limite yaklaşınca uyarır.
İptal: uygulama yeni istek yapamaz ve oturumunu yenileyemez; elindeki erişim anahtarı en fazla 15 dakika daha geçerli kalabilir.
Ajan yetenekleri: ajanın kullanabileceği araçlar modül sekmelerinde listelenir; arama ve tür filtresi vardır. Lisansınızda veya yetkinizde olmayan araçlar "Lisansınızda yok" / "Yetkiniz yok" rozetiyle gösterilir.
Araçlar ajanınızda kullanıcı dilinde başlıklarla görünebilir; bu, ajanın başlıkları göstermesine bağlıdır (bazı ajanlar teknik araç adını gösterir).

İki adımlı onay isteyen işlemler

Dışarıya etki eden işlemlerde ajan önce ön izlemeyi ve uyumluluk sonucunu gösterir; siz onaylayınca yapılır: mail ve WhatsApp gönderimi, sequence kaydı, bekleyen sequence maillerini gönderme, AI taslak onayı, servis bildirimi, gelen kutusu yanıtı, kampanya planlama ve cari dışı mail.

Gönderen mail hesabı

MCP ile yapılan tüm mail gönderimleri yalnız size tanımlı mail hesabından gider. Kapsanan araçlar: common_mail_send, crm_outreach_send (mail), crm_inbox_reply (mail), sequence yanıt taslağı onayı, crm_sequence_enroll, crm_sequence_send_pending, crm_campaign_schedule ve servis talebi bildirimi. WhatsApp ve web'den gönderim değişmez.

Hesap tanımlı değilse gönderim yapılmaz. Ajan şu mesajı iletir: "Firmanızda size tanımlı bir mail hesabı yok. Mail gönderebilmek için yöneticinizden hesap tanımlamasını isteyin."
Tek hesap varsa otomatik seçilir. Birden çok hesap varsa ajan eqlem_whoami ile hesaplarınızı görür ve birini seçer.
Yönetici için: hesap, "Mail ayarları" ekranındaki Personel alanından kişiye atanır. Personelin kullanıcı bağlantısı personel kartından kurulur.

Mail gönder (cari dışı)

Cari kaydı olmayan kişilere ajanınız üzerinden bireysel mail gönderir.

Kullanım koşulu: firma özelliği "Email Gönderim Aracını Kullanabilir" açık olmalı ve CRM Outreach ekleme yetkiniz bulunmalıdır. Değilse araç görünmez; Ajan yetenekleri ekranında "Lisansınızda yok" yazar.
İki adımlı gönderim: önce önizleme gelir (alıcılar, atlananlar, konu, gövde, bağlantılar, ekler). Onaylarsınız, sonra gönderilir. Onaydan sonra alıcı, içerik ya da ek değişirse onay geçersiz olur.
Alıcı: serbest e-posta adresi; cari kaydı gerekmez. Her alıcıya ayrı ileti gider, alıcılar birbirini görmez. CC/BCC, şablon ve açılma takibi yoktur.
Bireysel gönderim kaydı: alıcının onay kaydı yoksa "MCP – bireysel gönderim" kaynaklı bir kayıt otomatik açılır. Bu kayıt yalnız bu araçla bireysel gönderime izin verir; kampanya, sequence ve outreach gibi ticari gönderimlerde onay sayılmaz. Önizlemede "X alıcı için bireysel gönderim kaydı oluşturulacak" yazar.
Engelli alıcı: opt-out ya da engel listesindeki alıcıya gönderilmez; önizlemede ve sonuçta nedeniyle listelenir, diğer alıcılara gönderim sürer.
Gönderen: mail size tanımlı hesaptan gider (bkz. "Gönderen mail hesabı"); önizlemede gönderen adres görünür.
Gönderim aralığı: aralığı ajan çağrıda belirler (sendIntervalSeconds, 5–600 sn; verilmezse 15 sn). Değer önizlemede görünür ve onayınıza bağlıdır. Amaç spamı önlemektir; aynı posta kutusundan art arda gönderimlerde aralık korunur.
Günlük sınır: posta kutusunun mail ayarlarında tanımlı mevcut günlük gönderim limitidir; sequence ve kampanya ile ortak tüketilir. Limit tanımlı değilse sınır yoktur. Kotayı aşan alıcılar atlanır ve "günlük limit" nedeniyle listelenir.
Sonuç: araç hemen "kuyruğa alındı: N alıcı, tahmini bitiş" döner. İletiler outreach mesaj listesinde "Sırada" görünür; gönderilenler gönderildi olur, atlananlar "Atlandı", başarısızlar "Başarısız" durumuna geçer.
Sınırlar: çağrı başına en fazla 200 alıcı; gövde en fazla 4.000 karakter; en fazla 2 ek (yalnız daha önce EQLEM CRM'e yüklenmiş dosyalar). Posta kutusu kuyruğu 24 saatten fazla doluysa yeni gönderim reddedilir. Sistem yeniden başlatılırsa henüz gönderilmemiş iletiler kaybolabilir; outreach listesinden kontrol edin.

Hukuki uyarı: Araç bireysel ve işlemsel yazışma içindir. 6563 sayılı Kanun ve İYS gereği onaysız alıcıya ticari elektronik ileti (reklam, kampanya, toplu tanıtım) gönderilemez; sorumluluk gönderen kullanıcı ve firmadadır. Ticari gönderimler için CRM kampanya ve sequence kullanın.

Sequence verisini okuma

Sequence performansını ve adayları ajanınıza sorarak çıkarabilirsiniz. Her modda yalnız yetkinizin gördüğü kayıtlar gelir.

Aday iletişim listesi (crm_sequence_enrollment_read, contacts): sequence adaylarının cari, kişi, e-posta, telefon, aşama ve etkileşim bilgisi; sayfa başına en çok 30.
Etkileşimde olan cariler (crm_sequence_read, engaged_accounts): maili açan, tıklayan, yanıtlayan veya geri dönen (bounce) cariler, cari başına tek satır.
Gönderim planı (crm_sequence_read, send_schedule): Gönderim Planı ekranındaki veri, alıcı telefonu dahil; yalnız mail, sayfa başına en çok 30.
Gönderim partisi durumu (crm_sequence_read, send_batch): aşağıdaki bekleyen mail gönderiminin sonucu.
Adım bazlı performans (crm_sequence_read, metrics): her adım için gönderilen, açılan, tıklanan, yanıtlanan ve geri dönen sayısı (byStep).
Bugünkü temaslar (crm_sequence_read, due_touches): satırlarda alıcının e-postası, overdueDays ve blockedReason da gelir. ownerUserId boşsa oturum kullanıcınızın temasları gelir.
Kanal çalışma listesi (crm_sequence_read, due_worklist): channel zorunlu; gecikmişler en eskiden yeniye sıralanır; sayfa başına en çok 6 (aşağıdaki akış).
Mesaj hazırlama (crm_sequence_enrollment_read, compose): enrollmentId + touchId ile gönderilecek body, whatsAppLink ve linkedInUrl.
Mesaj araması (crm_outreach_message_read, search): sequenceId, enrollmentId ve tarih süzgeci (sequence ile birlikte); view=compact ile kısa satır görünümü.

Örnek istemler:

"Bu sequence'te linke tıklayan firmaları telefonlarıyla listele."
"Bugünkü temaslarımın e-posta ve telefonlarını ver."
"Vadesi geçmiş gönderilmemiş mailleri önizle ve gönder."

Bekleyen sequence maillerini gönderme

crm_sequence_send_pending, vadesi gelmiş otomatik sequence maillerini zamanlayıcıyı beklemeden önizleyip gönderime almanızı sağlar.

Kapsam: yalnız vadesi gelmiş otomatik mailler; hata ile takılmış olanlar da vadesi gelmişse dahildir. Manuel temas bekleyen, duraklatılmış ve planlı başlangıçlı kayıtlar işlenmez. Yalnız mail ve yalnız temas tabanlı (playbook) sequence'ler.
İki adımlı onay: ilk çağrı gönderim yapmaz; kuyruğa alınacak adedi, atlananları ve nedenlerini gösterir. Onaylarsanız ikinci çağrı onay koduyla yapılır. Kod tek kullanımlıktır, 5 dakika geçerlidir ve aday kümesine bağlıdır; küme değişirse geçersiz olur. Tek çağrıda en fazla 500 temas kuyruğa alınır; fazlası ayrı olarak raporlanır ve parti bitince aracı yeniden çağırarak gönderilebilir.
Günlük sınır: kuyruğa alınan adet tanımlı günlük gönderim sınırlarını aşmaz; aşan kısım sonraki günlerde zamanlayıcıyla gider.
Gönderim ve izleme: mailler sırayla kuyruktan gönderilir; sonucu crm_sequence_read send_batch ile izlersiniz. Aynı sequence için aynı anda tek parti çalışır.
Gerekli yetkiler: kurumsal outreach düzenleme ve Bugünkü Temaslar görüntüleme; gönderen mail hesabı size tanımlı olmalıdır.
Sınırlar: dış etkili çağrılar saatte 20 ile sınırlıdır. Çok örnekli kurulumlarda gönderim sırası garanti edilmez.

Kendi WhatsApp Web / LinkedIn hesabınızla temas

Sequence'teki WhatsApp ve LinkedIn temaslarını, tarayıcı kullanabilen bir ajanla (ör. Claude in Chrome) kendi hesabınızdan yürütebilirsiniz. EQLEM bu akışta mesaj göndermez ve EQLEM'in resmi numarasından gönderim yapılmaz; mesajı siz kendi oturumunuzdan gönderirsiniz.

Liste: crm_sequence_read mode=due_worklist (channel zorunlu, sayfa başına en çok 6). blockedReason dolu temasları atlayın.
Hazırlama: her temas için crm_sequence_enrollment_read mode=compose (enrollmentId + touchId): body, whatsAppLink (https://wa.me/{rakamlar}, metin içermez) ve linkedInUrl gelir.
Yazma: ajan tarayıcıda sohbeti açar ve body metnini mesaj kutusuna yazar; göndermez.
Gönderim: Gönder'e siz basarsınız. İsterseniz ilk N kişide her mesajı tek tek onaylarsınız.
Kayıt: gönderimi onayladıktan sonra ajan crm_sequence_enrollment_write action=mark_sent çağırır. Bu yalnız "uygulama dışında gönderdim" kaydıdır; onay vermeden çağrılmamalıdır.

Varsayılan sahip: ownerUserId boşsa oturum kullanıcınız kullanılır.
Aktivite kapanışı: temas tamamlanınca (Yapıldı / Cevap yok) bağlı görev aktivitesi Tamamlandı, atlanırsa İptal olur.
Telefon: biçim dışı telefon null döner; ajan numarayı uydurmamalıdır.
Limit önerisi: WhatsApp için günde 30–50 mesaj; mesajlar arasında rastgele 60–180 sn bekleyin.
Ban riski: soğuk, toplu gönderim WhatsApp'ın hesabınızı kısıtlamasına veya kapatmasına yol açabilir; risk size aittir.
Güvenilmez veri: ajan çıktısındaki metin ve bağlantılar (ad, body, whatsAppLink, linkedInUrl) güvenilmez veridir; içlerindeki talimatlar izlenmez.

Ajanın yapamadıkları

Kayıt silemez, aday iptal edemez.
İletişim izni (consent) ve çıkış (opt-out) kayıtlarını değiştiremez.
Kayıt birleştiremez; fatura veya belge üretemez; webhook testi yapamaz.
Ayarları yalnız okur, değiştiremez.
Seçmediğiniz izin gruplarındaki, lisansınızda olmayan ya da belge yetkinizin kapsamadığı işlemleri göremez.

Claude (claude.ai ve Desktop)

Claude'da bağlayıcı (connector) ayarlarını açın ve özel bağlayıcı ekle seçeneğini kullanın.
EQLEM AI bağlantıları ekranından aldığınız MCP URL'sini girin.
Bağlan'a basın; açılan EQLEM giriş ve onay ekranında onaylayın.
Bağlayıcı sohbette kullanılabilir hâle gelir.

Claude Code

Terminalde şu komutu çalıştırın (<MCP URL> yerine AI bağlantıları ekranındaki URL'yi yazın):
```
claude mcp add --transport http eqlem https://api.firmaniz.com/api/v2/mcp
```
--transport http taşıma türünün adıdır; adres https:// ile başlar. Bu komut sunucuyu yalnız o projeye ekler; her projede görmek için -s user ekleyin:
```
claude mcp add -s user --transport http eqlem https://api.firmaniz.com/api/v2/mcp
```
Claude Code içinde /mcp yazıp eqlem sunucusunu seçin ve kimlik doğrulamasını başlatın; tarayıcıda EQLEM giriş ve onay ekranı açılır.
Onaydan sonra araçlar oturumda görünür.

ChatGPT

ChatGPT ayarlarında geliştirici modunu açın (planınızın ve çalışma alanı yöneticinizin izin verdiği ölçüde).
Yeni bir uygulama veya bağlayıcı ekleyin ve EQLEM AI bağlantıları ekranındaki MCP URL'sini girin.
Kimlik doğrulamada OAuth'u seçin; EQLEM giriş ve onay ekranında onaylayın.
Sohbette uygulamayı etkinleştirip kullanın.

Gemini CLI

Gemini CLI settings.json dosyasında mcpServers altına sunucuyu ekleyin:

{
  "mcpServers": {
    "eqlem": {
      "httpUrl": "https://api.firmaniz.com/api/v2/mcp"
    }
  }
}

Gemini CLI'yi başlatıp MCP kimlik doğrulamasını çalıştırın. Aynı makinede tarayıcı gerekir; EQLEM giriş ve onay ekranı orada açılır.
Gemini CLI istemcisini otomatik kayıtla tanıtır. Bağlantı kurulamazsa EQLEM yöneticinize bildirin.

Gemini Enterprise (Admin kurulumu)

Gemini Enterprise istemciyi kendiliğinden kaydetmez; kurulumu bir yönetici yapar.

EQLEM'de AI bağlantıları ekranında (Admin) bir kurumsal OAuth istemcisi oluşturun.
İstemcinin yönlendirme (redirect) adresi olarak şunu girin: https://vertexaisearch.cloud.google.com/oauth-redirect
Oluşan client id ve client secret değerlerini not edin.
Gemini Enterprise yönetim ekranında Custom MCP Server veri deposu ekleyin; MCP URL'sini, client id ile client secret değerlerini ve EQLEM'in yetkilendirme ile token adreslerini girin (adresler için AI bağlantıları ekranındaki sağlayıcı kurulum linkine bakın).
Kullanıcılar ilk kullanımda EQLEM giriş ve onay ekranını görür.

Microsoft Copilot Studio

Copilot Studio'da ajanınıza bir MCP aracı ekleyin ve MCP URL'sini girin (yalnız Streamable HTTP desteklenir).
Kimlik doğrulamada önce Dynamic discovery seçeneğini deneyin. Bağlantı kurulursa EQLEM giriş ve onay ekranında onaylayın.
Olmazsa Manual seçin:
1. Admin, EQLEM'de kurumsal OAuth istemcisi oluşturur.
2. Copilot Studio'nun gösterdiği tam yönlendirme (callback) adresini (https://global.consent.azure-apim.net/redirect/... biçiminde, bağlayıcı adıyla biten tam yol) EQLEM'deki istemciye ekler.
3. client id ve client secret Copilot Studio'ya girilir.

VS Code / GitHub Copilot

mcp.json dosyasına (çalışma alanında .vscode/mcp.json ya da kullanıcı düzeyinde) HTTP sunucusunu ekleyin:

{
  "servers": {
    "eqlem": {
      "type": "http",
      "url": "https://api.firmaniz.com/api/v2/mcp"
    }
  }
}

Sunucuyu başlatın; VS Code kimlik doğrulama ister ve tarayıcıda EQLEM giriş ve onay ekranı açılır.
Copilot sohbetinde (ajan modu) EQLEM araçlarını seçin.

Cursor

Cursor'un mcp.json dosyasına sunucuyu ekleyin:

{
  "mcpServers": {
    "eqlem": {
      "url": "https://api.firmaniz.com/api/v2/mcp"
    }
  }
}

Cursor'da sunucuyu etkinleştirin; EQLEM giriş ve onay ekranı açılır.
Cursor istemcisini otomatik kayıtla tanıtır. Bağlantı kurulamazsa EQLEM yöneticinize bildirin.

Güvenlik hatırlatması

Ajan yalnızca sizin yetkinizle ve onayladığınız izin gruplarıyla çalışır. Silme ve aday iptali sadece EQLEM'de yapılır.
Dış etkili işlemler onayınıza bağlıdır; CRM uyumluluk kuralları her gönderimde uygulanır.
Kurumsal istemcinin client secret değerini kimseyle paylaşmayın. Yenilemek için Admin, AI bağlantıları ekranını kullanır.
Ajan bağlantısını kaldırmak için AI bağlantıları ekranından iptal edin.

Sık sorulanlar

MCP URL'sini nereden alırım? EQLEM'de AI bağlantıları ekranından.

Bağlanamıyorum, ne yapmalıyım? Önce URL'yi ve tarayıcıdaki giriş ve onay adımını kontrol edin. Sorun sürerse EQLEM yöneticinize bildirin. Gemini Enterprise ve Copilot Studio (Manual) için yönetici kurumsal istemci oluşturur.

Sağlayıcı arayüzündeki adlar farklı görünüyor. Sağlayıcılar menü adlarını değiştirebilir; yukarıdaki adımlar genel akışı anlatır.

Sonraki adım

CRM modülünü inceleyin ya da Ücretsiz Dene ile başlayın.

Başlamadan önce

EQLEM'de AI bağlantıları ekranını açın ve MCP URL'sini kopyalayın. Ajanını bağla panelinde ajanınızı seçerseniz o sağlayıcıya özel adımlar ve kopyalanabilir hazır komut/yapılandırma gösterilir. Aşağıdaki her sağlayıcıda bu URL kullanılır. Adres her zaman https:// ile başlar (ör. https://api.firmaniz.com/api/v2/mcp). Komutlarda ve ayarlarda geçen http ise MCP'nin taşıma türünün (Streamable HTTP) adıdır, adresin şeması değildir.
İlk bağlantıda tarayıcıda EQLEM giriş ve onay ekranı açılır. Giriş yapın, ajanın isteyeceği izinlere bakıp onaylayın.
Bağlantıyı istediğiniz an AI bağlantıları ekranından iptal edebilirsiniz.
Kurumsal istemci gereken kurulumlarda (Gemini Enterprise, Copilot Studio Manual) işi Admin yapar: AI bağlantıları ekranında kurumsal OAuth istemcisi oluşturur, client id ve client secret değerlerini oradan alır.

Bağlandıktan sonra ajanınıza "EQLEM'de kim olarak bağlıyım?" diye sorarak bağlantıyı deneyebilirsiniz.

Sürüm notu: Araç adları güncellendi. Daha önce bağlanmış ajanlarda araç listesini yenileyin (bağlayıcıyı yeniden yükleyin ya da yeniden bağlanın).

Ajanınız neler yapabilir?

Ajan CRM'in tüm süreçlerini kapsar; her işlemde kendi EQLEM yetkiniz geçerlidir.

Satış: adaylar ve müşteriler (arama, oluşturma, güncelleme, aday aşaması, etiket ve grup), kişiler, notlar, aktiviteler, fırsatlar (kazanıldı / kaybedildi işaretleme), takvim, grup panosu, bölge, sözleşmeler ve yenileme takibi.
Servis: servis talepleri (satır, atama, yeniden planlama, memnuniyet, SLA değerlendirmesi), varlıklar, gelen çağrılar, dönemsel işlemler, bilgi bankası.
İletişim: şablonlar, gönderilen mesajlar ve takip olayları, gelen kutusu, kampanyalar (taslak, hedef kitle, varyant, karşılaştırma).
Sequence: iletişim akışları, adayı akışa kaydetme, aday iletişim listesi, etkileşimde olan cariler, gönderim planı, adım bazlı performans, temas kuyruğu, yanıt işaretleme, sonuç ve aşama, AI yanıt taslakları, vadesi gelmiş mailleri gönderme.
İçgörü: satış, iletişim, servis ve yönetici raporları, sağlık skorları, uyumluluk durumunu okuma ve ayarları okuma.
Ortak: Projeler (common_project_read) ve Masraf merkezleri (common_cost_center_read) için liste, arama ve detay (belge yetkisi "Proje & Maliyet Merkezi"); Mail gönder (cari dışı) (common_mail_send).

Onay ekranında izin gruplarını seçin

Giriş yaptıktan sonra onay ekranında izin gruplarını görürsünüz: Satış, Servis, İletişim, Sequence, İçgörü; her grup okuma, yazma ve (varsa) gönderim olarak ayrılır. Bunların yanında iki ortak izin vardır: common.definitions.read (Ortak tanımlar: proje ve masraf merkezi okuma) ve common.mail.send (Mail gönderimi: doğrudan mail).
Ajanın yapmasını istediğiniz grupları tek tek seçin; istemediklerinizin işaretini kaldırın (varsayılan olarak hepsi seçilidir; Onayla için en az bir izin seçili olmalıdır).
Ajan yalnız seçtiğiniz gruplardaki, lisansınızın kapsadığı ve EQLEM belge yetkinizin izin verdiği araçları görür. Sonradan kapsamı değiştirmek için bağlantıyı iptal edip yeniden onaylayın.
Onay ekranındaki güven rozetine bakın: Doğrulanmış (firmanızın kurumsal istemcisi), Alan adı doğrulandı (ör. claude.ai; uygulama kendini bu alan adından tanıtıyor) veya Doğrulanmamış (otomatik kayıt; yalnız tanıdığınız uygulamaya izin verin). Yönlendirme adresi tanıdığınız sağlayıcıya ait değilse onaylamayın.

AI bağlantıları sayfası

Bağlantılarım: her bağlantı bir kart (uygulama, güven rozeti, izinler, son yenileme, bitiş). Kullanıcı başına en fazla 5 bağlantı; sayaç limite yaklaşınca uyarır.
İptal: uygulama yeni istek yapamaz ve oturumunu yenileyemez; elindeki erişim anahtarı en fazla 15 dakika daha geçerli kalabilir.
Ajan yetenekleri: ajanın kullanabileceği araçlar modül sekmelerinde listelenir; arama ve tür filtresi vardır. Lisansınızda veya yetkinizde olmayan araçlar "Lisansınızda yok" / "Yetkiniz yok" rozetiyle gösterilir.
Araçlar ajanınızda kullanıcı dilinde başlıklarla görünebilir; bu, ajanın başlıkları göstermesine bağlıdır (bazı ajanlar teknik araç adını gösterir).

İki adımlı onay isteyen işlemler

Gönderen mail hesabı

Hesap tanımlı değilse gönderim yapılmaz. Ajan şu mesajı iletir: "Firmanızda size tanımlı bir mail hesabı yok. Mail gönderebilmek için yöneticinizden hesap tanımlamasını isteyin."
Tek hesap varsa otomatik seçilir. Birden çok hesap varsa ajan eqlem_whoami ile hesaplarınızı görür ve birini seçer.
Yönetici için: hesap, "Mail ayarları" ekranındaki Personel alanından kişiye atanır. Personelin kullanıcı bağlantısı personel kartından kurulur.

Mail gönder (cari dışı)

Cari kaydı olmayan kişilere ajanınız üzerinden bireysel mail gönderir.

Kullanım koşulu: firma özelliği "Email Gönderim Aracını Kullanabilir" açık olmalı ve CRM Outreach ekleme yetkiniz bulunmalıdır. Değilse araç görünmez; Ajan yetenekleri ekranında "Lisansınızda yok" yazar.
İki adımlı gönderim: önce önizleme gelir (alıcılar, atlananlar, konu, gövde, bağlantılar, ekler). Onaylarsınız, sonra gönderilir. Onaydan sonra alıcı, içerik ya da ek değişirse onay geçersiz olur.
Alıcı: serbest e-posta adresi; cari kaydı gerekmez. Her alıcıya ayrı ileti gider, alıcılar birbirini görmez. CC/BCC, şablon ve açılma takibi yoktur.
Bireysel gönderim kaydı: alıcının onay kaydı yoksa "MCP – bireysel gönderim" kaynaklı bir kayıt otomatik açılır. Bu kayıt yalnız bu araçla bireysel gönderime izin verir; kampanya, sequence ve outreach gibi ticari gönderimlerde onay sayılmaz. Önizlemede "X alıcı için bireysel gönderim kaydı oluşturulacak" yazar.
Engelli alıcı: opt-out ya da engel listesindeki alıcıya gönderilmez; önizlemede ve sonuçta nedeniyle listelenir, diğer alıcılara gönderim sürer.
Gönderen: mail size tanımlı hesaptan gider (bkz. "Gönderen mail hesabı"); önizlemede gönderen adres görünür.
Gönderim aralığı: aralığı ajan çağrıda belirler (sendIntervalSeconds, 5–600 sn; verilmezse 15 sn). Değer önizlemede görünür ve onayınıza bağlıdır. Amaç spamı önlemektir; aynı posta kutusundan art arda gönderimlerde aralık korunur.
Günlük sınır: posta kutusunun mail ayarlarında tanımlı mevcut günlük gönderim limitidir; sequence ve kampanya ile ortak tüketilir. Limit tanımlı değilse sınır yoktur. Kotayı aşan alıcılar atlanır ve "günlük limit" nedeniyle listelenir.
Sonuç: araç hemen "kuyruğa alındı: N alıcı, tahmini bitiş" döner. İletiler outreach mesaj listesinde "Sırada" görünür; gönderilenler gönderildi olur, atlananlar "Atlandı", başarısızlar "Başarısız" durumuna geçer.
Sınırlar: çağrı başına en fazla 200 alıcı; gövde en fazla 4.000 karakter; en fazla 2 ek (yalnız daha önce EQLEM CRM'e yüklenmiş dosyalar). Posta kutusu kuyruğu 24 saatten fazla doluysa yeni gönderim reddedilir. Sistem yeniden başlatılırsa henüz gönderilmemiş iletiler kaybolabilir; outreach listesinden kontrol edin.

Hukuki uyarı: Araç bireysel ve işlemsel yazışma içindir. 6563 sayılı Kanun ve İYS gereği onaysız alıcıya ticari elektronik ileti (reklam, kampanya, toplu tanıtım) gönderilemez; sorumluluk gönderen kullanıcı ve firmadadır. Ticari gönderimler için CRM kampanya ve sequence kullanın.

Sequence verisini okuma

Sequence performansını ve adayları ajanınıza sorarak çıkarabilirsiniz. Her modda yalnız yetkinizin gördüğü kayıtlar gelir.

Aday iletişim listesi (crm_sequence_enrollment_read, contacts): sequence adaylarının cari, kişi, e-posta, telefon, aşama ve etkileşim bilgisi; sayfa başına en çok 30.
Etkileşimde olan cariler (crm_sequence_read, engaged_accounts): maili açan, tıklayan, yanıtlayan veya geri dönen (bounce) cariler, cari başına tek satır.
Gönderim planı (crm_sequence_read, send_schedule): Gönderim Planı ekranındaki veri, alıcı telefonu dahil; yalnız mail, sayfa başına en çok 30.
Gönderim partisi durumu (crm_sequence_read, send_batch): aşağıdaki bekleyen mail gönderiminin sonucu.
Adım bazlı performans (crm_sequence_read, metrics): her adım için gönderilen, açılan, tıklanan, yanıtlanan ve geri dönen sayısı (byStep).
Bugünkü temaslar (crm_sequence_read, due_touches): satırlarda alıcının e-postası, overdueDays ve blockedReason da gelir. ownerUserId boşsa oturum kullanıcınızın temasları gelir.
Kanal çalışma listesi (crm_sequence_read, due_worklist): channel zorunlu; gecikmişler en eskiden yeniye sıralanır; sayfa başına en çok 6 (aşağıdaki akış).
Mesaj hazırlama (crm_sequence_enrollment_read, compose): enrollmentId + touchId ile gönderilecek body, whatsAppLink ve linkedInUrl.
Mesaj araması (crm_outreach_message_read, search): sequenceId, enrollmentId ve tarih süzgeci (sequence ile birlikte); view=compact ile kısa satır görünümü.

Örnek istemler:

"Bu sequence'te linke tıklayan firmaları telefonlarıyla listele."
"Bugünkü temaslarımın e-posta ve telefonlarını ver."
"Vadesi geçmiş gönderilmemiş mailleri önizle ve gönder."

Bekleyen sequence maillerini gönderme

crm_sequence_send_pending, vadesi gelmiş otomatik sequence maillerini zamanlayıcıyı beklemeden önizleyip gönderime almanızı sağlar.

Kapsam: yalnız vadesi gelmiş otomatik mailler; hata ile takılmış olanlar da vadesi gelmişse dahildir. Manuel temas bekleyen, duraklatılmış ve planlı başlangıçlı kayıtlar işlenmez. Yalnız mail ve yalnız temas tabanlı (playbook) sequence'ler.
İki adımlı onay: ilk çağrı gönderim yapmaz; kuyruğa alınacak adedi, atlananları ve nedenlerini gösterir. Onaylarsanız ikinci çağrı onay koduyla yapılır. Kod tek kullanımlıktır, 5 dakika geçerlidir ve aday kümesine bağlıdır; küme değişirse geçersiz olur. Tek çağrıda en fazla 500 temas kuyruğa alınır; fazlası ayrı olarak raporlanır ve parti bitince aracı yeniden çağırarak gönderilebilir.
Günlük sınır: kuyruğa alınan adet tanımlı günlük gönderim sınırlarını aşmaz; aşan kısım sonraki günlerde zamanlayıcıyla gider.
Gönderim ve izleme: mailler sırayla kuyruktan gönderilir; sonucu crm_sequence_read send_batch ile izlersiniz. Aynı sequence için aynı anda tek parti çalışır.
Gerekli yetkiler: kurumsal outreach düzenleme ve Bugünkü Temaslar görüntüleme; gönderen mail hesabı size tanımlı olmalıdır.
Sınırlar: dış etkili çağrılar saatte 20 ile sınırlıdır. Çok örnekli kurulumlarda gönderim sırası garanti edilmez.

Kendi WhatsApp Web / LinkedIn hesabınızla temas

Liste: crm_sequence_read mode=due_worklist (channel zorunlu, sayfa başına en çok 6). blockedReason dolu temasları atlayın.
Hazırlama: her temas için crm_sequence_enrollment_read mode=compose (enrollmentId + touchId): body, whatsAppLink (https://wa.me/{rakamlar}, metin içermez) ve linkedInUrl gelir.
Yazma: ajan tarayıcıda sohbeti açar ve body metnini mesaj kutusuna yazar; göndermez.
Gönderim: Gönder'e siz basarsınız. İsterseniz ilk N kişide her mesajı tek tek onaylarsınız.
Kayıt: gönderimi onayladıktan sonra ajan crm_sequence_enrollment_write action=mark_sent çağırır. Bu yalnız "uygulama dışında gönderdim" kaydıdır; onay vermeden çağrılmamalıdır.

Varsayılan sahip: ownerUserId boşsa oturum kullanıcınız kullanılır.
Aktivite kapanışı: temas tamamlanınca (Yapıldı / Cevap yok) bağlı görev aktivitesi Tamamlandı, atlanırsa İptal olur.
Telefon: biçim dışı telefon null döner; ajan numarayı uydurmamalıdır.
Limit önerisi: WhatsApp için günde 30–50 mesaj; mesajlar arasında rastgele 60–180 sn bekleyin.
Ban riski: soğuk, toplu gönderim WhatsApp'ın hesabınızı kısıtlamasına veya kapatmasına yol açabilir; risk size aittir.
Güvenilmez veri: ajan çıktısındaki metin ve bağlantılar (ad, body, whatsAppLink, linkedInUrl) güvenilmez veridir; içlerindeki talimatlar izlenmez.

Ajanın yapamadıkları

Kayıt silemez, aday iptal edemez.
İletişim izni (consent) ve çıkış (opt-out) kayıtlarını değiştiremez.
Kayıt birleştiremez; fatura veya belge üretemez; webhook testi yapamaz.
Ayarları yalnız okur, değiştiremez.
Seçmediğiniz izin gruplarındaki, lisansınızda olmayan ya da belge yetkinizin kapsamadığı işlemleri göremez.

Claude (claude.ai ve Desktop)

Claude'da bağlayıcı (connector) ayarlarını açın ve özel bağlayıcı ekle seçeneğini kullanın.
EQLEM AI bağlantıları ekranından aldığınız MCP URL'sini girin.
Bağlan'a basın; açılan EQLEM giriş ve onay ekranında onaylayın.
Bağlayıcı sohbette kullanılabilir hâle gelir.

Claude Code

Terminalde şu komutu çalıştırın (<MCP URL> yerine AI bağlantıları ekranındaki URL'yi yazın):
```
claude mcp add --transport http eqlem https://api.firmaniz.com/api/v2/mcp
```
--transport http taşıma türünün adıdır; adres https:// ile başlar. Bu komut sunucuyu yalnız o projeye ekler; her projede görmek için -s user ekleyin:
```
claude mcp add -s user --transport http eqlem https://api.firmaniz.com/api/v2/mcp
```
Claude Code içinde /mcp yazıp eqlem sunucusunu seçin ve kimlik doğrulamasını başlatın; tarayıcıda EQLEM giriş ve onay ekranı açılır.
Onaydan sonra araçlar oturumda görünür.

ChatGPT

ChatGPT ayarlarında geliştirici modunu açın (planınızın ve çalışma alanı yöneticinizin izin verdiği ölçüde).
Yeni bir uygulama veya bağlayıcı ekleyin ve EQLEM AI bağlantıları ekranındaki MCP URL'sini girin.
Kimlik doğrulamada OAuth'u seçin; EQLEM giriş ve onay ekranında onaylayın.
Sohbette uygulamayı etkinleştirip kullanın.

Gemini CLI

Gemini CLI settings.json dosyasında mcpServers altına sunucuyu ekleyin:

{
  "mcpServers": {
    "eqlem": {
      "httpUrl": "https://api.firmaniz.com/api/v2/mcp"
    }
  }
}

Gemini CLI'yi başlatıp MCP kimlik doğrulamasını çalıştırın. Aynı makinede tarayıcı gerekir; EQLEM giriş ve onay ekranı orada açılır.
Gemini CLI istemcisini otomatik kayıtla tanıtır. Bağlantı kurulamazsa EQLEM yöneticinize bildirin.

Gemini Enterprise (Admin kurulumu)

Gemini Enterprise istemciyi kendiliğinden kaydetmez; kurulumu bir yönetici yapar.

EQLEM'de AI bağlantıları ekranında (Admin) bir kurumsal OAuth istemcisi oluşturun.
İstemcinin yönlendirme (redirect) adresi olarak şunu girin: https://vertexaisearch.cloud.google.com/oauth-redirect
Oluşan client id ve client secret değerlerini not edin.
Gemini Enterprise yönetim ekranında Custom MCP Server veri deposu ekleyin; MCP URL'sini, client id ile client secret değerlerini ve EQLEM'in yetkilendirme ile token adreslerini girin (adresler için AI bağlantıları ekranındaki sağlayıcı kurulum linkine bakın).
Kullanıcılar ilk kullanımda EQLEM giriş ve onay ekranını görür.

Microsoft Copilot Studio

Copilot Studio'da ajanınıza bir MCP aracı ekleyin ve MCP URL'sini girin (yalnız Streamable HTTP desteklenir).
Kimlik doğrulamada önce Dynamic discovery seçeneğini deneyin. Bağlantı kurulursa EQLEM giriş ve onay ekranında onaylayın.
Olmazsa Manual seçin:
1. Admin, EQLEM'de kurumsal OAuth istemcisi oluşturur.
2. Copilot Studio'nun gösterdiği tam yönlendirme (callback) adresini (https://global.consent.azure-apim.net/redirect/... biçiminde, bağlayıcı adıyla biten tam yol) EQLEM'deki istemciye ekler.
3. client id ve client secret Copilot Studio'ya girilir.

VS Code / GitHub Copilot

mcp.json dosyasına (çalışma alanında .vscode/mcp.json ya da kullanıcı düzeyinde) HTTP sunucusunu ekleyin:

{
  "servers": {
    "eqlem": {
      "type": "http",
      "url": "https://api.firmaniz.com/api/v2/mcp"
    }
  }
}

Sunucuyu başlatın; VS Code kimlik doğrulama ister ve tarayıcıda EQLEM giriş ve onay ekranı açılır.
Copilot sohbetinde (ajan modu) EQLEM araçlarını seçin.

Cursor

Cursor'un mcp.json dosyasına sunucuyu ekleyin:

{
  "mcpServers": {
    "eqlem": {
      "url": "https://api.firmaniz.com/api/v2/mcp"
    }
  }
}

Cursor'da sunucuyu etkinleştirin; EQLEM giriş ve onay ekranı açılır.
Cursor istemcisini otomatik kayıtla tanıtır. Bağlantı kurulamazsa EQLEM yöneticinize bildirin.

Güvenlik hatırlatması

Ajan yalnızca sizin yetkinizle ve onayladığınız izin gruplarıyla çalışır. Silme ve aday iptali sadece EQLEM'de yapılır.
Dış etkili işlemler onayınıza bağlıdır; CRM uyumluluk kuralları her gönderimde uygulanır.
Kurumsal istemcinin client secret değerini kimseyle paylaşmayın. Yenilemek için Admin, AI bağlantıları ekranını kullanır.
Ajan bağlantısını kaldırmak için AI bağlantıları ekranından iptal edin.

Sık sorulanlar

MCP URL'sini nereden alırım? EQLEM'de AI bağlantıları ekranından.

Sağlayıcı arayüzündeki adlar farklı görünüyor. Sağlayıcılar menü adlarını değiştirebilir; yukarıdaki adımlar genel akışı anlatır.

Sonraki adım

CRM modülünü inceleyin ya da Ücretsiz Dene ile başlayın.

Başlamadan önce

Ajanınız neler yapabilir?

Onay ekranında izin gruplarını seçin

AI bağlantıları sayfası

İki adımlı onay isteyen işlemler

Gönderen mail hesabı

Mail gönder (cari dışı)

Sequence verisini okuma

Bekleyen sequence maillerini gönderme

Kendi WhatsApp Web / LinkedIn hesabınızla temas

Ajanın yapamadıkları

Claude (claude.ai ve Desktop)

Claude Code

ChatGPT

Gemini CLI

Gemini Enterprise (Admin kurulumu)

Microsoft Copilot Studio

VS Code / GitHub Copilot

Cursor

Güvenlik hatırlatması

Sık sorulanlar

Sonraki adım

Kendi verinizle deneyin

Ücretsiz dene

Ekiple konuş

Hesap açın

Modülleri seçin

Sistemlerinizi bağlayın

Başlamadan önce

Ajanınız neler yapabilir?

Onay ekranında izin gruplarını seçin

AI bağlantıları sayfası

İki adımlı onay isteyen işlemler

Gönderen mail hesabı

Mail gönder (cari dışı)

Sequence verisini okuma

Bekleyen sequence maillerini gönderme

Kendi WhatsApp Web / LinkedIn hesabınızla temas

Ajanın yapamadıkları

Claude (claude.ai ve Desktop)

Claude Code

ChatGPT

Gemini CLI

Gemini Enterprise (Admin kurulumu)

Microsoft Copilot Studio

VS Code / GitHub Copilot

Cursor

Güvenlik hatırlatması

Sık sorulanlar

Sonraki adım

Kendi verinizle deneyin

Ücretsiz dene

Ekiple konuş

Hesap açın

Modülleri seçin

Sistemlerinizi bağlayın