# AI ajanınızı EQLEM CRM'e bağlayın

> EQLEM CRM'i Claude, ChatGPT, Gemini, Copilot Studio, VS Code ve Cursor'a bağlayın. Sağlayıcı bazlı adım adım kurulum; OAuth, kendi yetkinizle ve onaylı gönderim.

Source: https://www.eqlem.com/tr/ozellikler/ai-ajan-baglantisi

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ü](https://www.eqlem.com/tr/moduller/crm) sayfasına bakın.

## Başlamadan önce

1. 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.
2. İ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.
3. Bağlantıyı istediğiniz an **AI bağlantıları** ekranından iptal edebilirsiniz.
4. 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). Kişi grubu araçları (`crm_contact_group_read`, `crm_contact_group_write`) eklendi. Görev planı ve şablon araçları, 14 aktivite türü, otomatik aktivite ve hatırlatma, aktivite ve görev planı raporları ile ek CRM araçları (teklif, etiket, cari birleştirme, ayar tanımları vb.) eklendi.

## 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 ve **kişi grupları** (üye sayısı, toplu ekleme / çıkarma), notlar, **aktiviteler** (14 tür), **görev planları ve şablonları**, fırsatlar (kazanıldı / kaybedildi işaretleme), fiyat teklifleri, 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ı, **aktivite ve görev planı özetleri**, 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

1. Giriş yaptıktan sonra onay ekranında izin gruplarını daraltılabilir gruplar halinde görürsünüz: **Satış, Servis, İletişim, Sequence, İçgörü**; her grup okuma, yazma ve (varsa) gönderim olarak ayrılır. Her grupta ve her izinde açma/kapama anahtarı (switch) bulunur. 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).
2. Ajanın yapmasını istediğiniz grupları ve izinleri tek tek seçin; istemediklerinizi kapatın (varsayılan olarak hepsi açıktır; Onayla için en az bir izin açık olmalıdır).
3. 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.
4. 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.
5. Ekranda gösterilen **bağlanılan MCP adresi**, **AI bağlantıları** sayfasındaki adresle aynı olmalıdır.
6. Onay isteği **10 dakika** geçerlidir; süre dolarsa işlemi AI uygulamasından yeniden başlatın.
7. EQLEM oturumunuz yoksa veya süresi dolduysa giriş ekranına yönlendirilirsiniz; girişten sonra aynı onaya dönersiniz. B2B alıcı formu görünürse altındaki **"EQLEM kullanıcısı olarak giriş yap"** bağlantısını kullanı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. Vadesinde sistemin göndereceği otomatik aktivite ve görev planı adımları ile şablonun cariye uygulanması da aynı şekilde onaylıdır. Sequence gönderim penceresi ve iş takvimi günü değişiklikleri de (`crm_settings_write`) önce önizleme, sonra onay kodu ile yapılır.

### 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.
- **Bekleyen mail sayısı** (`crm_sequence_read`, `pending_mail_count`): sequence başına bekleyen mail sayıları ve günlük sınır/kalan; hızlı sayım.
- **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`).
- **Gönderim penceresi** (`crm_sequence_read`, `send_window`): `id` = sequence. Pencere metni, saat dilimi, gün gün aralıklar, günlük sınırlar, bağlı iş takvimi ve posta kutusu durumu; şablon metni dönmez. Ayrıntı için aşağıdaki "İş takvimi ve gönderim penceresi" bölümü.
- **Pencere kontrolü** (`crm_sequence_read`, `send_window_check`): `id` = sequence; isteğe bağlı `touchId`, `enrollmentId`, `at` (UTC; boşsa şimdi). Bir anın pencere içinde olup olmadığını ve nedenini döner; hiçbir şey değiştirmez.
- **İş takvimi detayı** (`crm_settings_read`, `mode=business_calendars` + `id`): takvimin günleri (tarih, tür, etki, etkin mi) ve bağlı sequence'ler. Bağlı sequence listesi yalnız Outreach liste yetkiniz varsa dolu gelir. `id` verilmezse takvim listesi gelir.
- **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 önizlemedeki dilim sınırına ve gönderen hesaba bağlıdır; gönderen hesap değişirse geçersiz olur.
- **Bekleyen mail sayısı:** `crm_sequence_read` `mode=pending_mail_count` sequence başına geciken, bugün vadesi gelen, şimdi gönderilebilir, manuel bekleyen, duraklatılmış ve hatalı sayıları ile günlük sınır/kalanı hızlıca döner.
- **Yalnız sayım ve önizlemesiz gönderim:** `dryRun` yalnız sayım ve örnek döner, hiçbir şey göndermez. `confirmSend=true` önizleme ve onay kodunu atlayıp doğrudan kuyruğa alır; dış etkili bir işlemdir, ajan yalnız siz açıkça isterseniz kullanmalıdır.
- **Dilim:** çağrı başına en çok 500 temas kuyruğa alınır (`limit` ile 1-500 arası daraltılabilir). Kalan sayı yanıtta bildirilir; aracı yeniden çağırarak sıradaki dilimi alırsınız.
- **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ünlük sınır bugün tamamen dolmuşsa "günlük sınır doldu" hatası (`error.crm-sequence.send-pending-daily-limit-reached`) döner.
- **Gönderen hesap ve uyumluluk:** mail hesabı size tanımlı değilse gönderim reddedilir. Abonelikten çıkma, engelleme ve izin kuralları gönderim sırasında temas başına uygulanır; engellenen temas atlanır.
- **Gönderim ve izleme:** gönderim arka planda yapılır, mailler sırayla kuyruktan gönderilir; sonucu `crm_sequence_read` `send_batch` ile izlersiniz. Aynı sequence için aynı anda tek parti çalışır; açık parti varken yeni çağrı "gönderim sürüyor" hatası ve `batchId` ile döner, mükerrer mail gitmez.
- **Ertelenen mailler:** `send_batch` yanıtındaki `deferredByReason` ertelenenleri sebebe göre sayar; önizleme/gönderim yanıtındaki `expectedDeferredByReason` ise şu an gönderim penceresi dışındaysanız bekleyecek adedi (`outside-window`) önceden bildirir. Sebepler: `outside-window` gönderim saati penceresi dışında; `daily-limit` posta kutusunun günlük sınırı doldu; `sequence-daily-limit` sequence'in günlük sınırı doldu; `rate-limit` gönderim hızı sınırı (mail aralığı, dakika dilimi, alıcı domain); `paused` otomatik fren gönderimi geçici durdurdu; `lock-conflict` aynı anda başka bir işlem slotu tuttu. Ertelenen mail kaybolmaz, ilk uygun saatte otomatik gider.
- **Ertelenenleri şimdi çekme (`includeDeferred=true`):** pencere dışı vb. nedenle ertelenmiş temasları da aday sayar; onayda bunlar şimdiye alınıp aynı partide kuyruğa alınır. Önizlemede `deferredEligible` sayısı görünür. Pencere şimdi kapalıysa çağrı `error.crm-sequence.send-window-closed` ile reddedilir ve hiçbir şey değişmez. Yalnız bu sürümden sonra ertelenen temaslar çekilebilir. Varsayılan `false`; davranış değişmez. Önizleme yanıtında `windowStart`, `windowEnd`, `nextWindowOpensAt` (UTC) ve ertelenenler için `deferredReasonDetail` de gelir.
- **Zaman aşımı:** çağrı zaman aşımına uğrarsa ajan aynı çağrıyı hemen tekrarlamamalı; önce `crm_sequence_read` `mode=send_batch` ile açık bir gönderim partisi olup olmadığını kontrol etmelidir.
  Açık parti varken yeni onay `error.crm-sequence.send-pending-in-progress` ile reddedilir (parti tamamlanınca veya 2 saat sonra serbest kalır); sistem aynı temasın iki kez gönderilmesini engeller.
- **Planlı başlangıçlı kayıtlar:** "Başlangıç planlandı" durumundaki kayıtların başlangıçları günlük gönderim sınırına göre günlere yayılır. Bunları web arayüzünde **Şimdi başlat** ile elle başlatabilirsiniz; sequence başlangıç tarihi henüz gelmediyse başlatılamaz. MCP'den elle başlatma yoktur.
- **Gerekli yetkiler:** kurumsal outreach düzenleme ve Bugünkü Temaslar görüntüleme. MCP kapsamı olarak `crm.outreach.send` yeterlidir (`crm_sequence_reschedule_stuck` için de).
  Gönderen mail hesabı size tanımlı olmalıdır (hesap ataması EQLEM web uygulamasında yapılır). Abonelikten çıkma/izin kuralları ve gönderim penceresi her zaman uygulanı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.

#### Sıralı hızlı gönderim (`mode=send_now_sequential`)

Varsayılan `mode=queue` değişmez. `send_now_sequential`, vadesi gelmiş temasları en eski plandan başlayarak tek tek, kutunun gerçek hızıyla gönderir.

- **Akış:** önizleme → onay kodu → sıralı gönderim. Yanıt tahmini ilk gönderim anını (`etaFirstSendAt`), tahmini bitişi (`estimatedCompletionAt`) ve saatlik hızı (`estimatedSendRatePerHour`; onayda `ratePerHour`) verir.
  Önizleme ayrıca beklenen hız sınırı erteleme sayısını (`expectedRateLimitDeferredCount`) ve türe göre dökümü (`rateLimitByType`) döner.
- **Önizlemesiz gönderim yok:** bu modda `confirmSend=true` kullanılamaz (`error.validation.invalid`). Çağrı başına en çok 500 temas.
- **Sıraya girme:** açık parti varken yeni onay reddedilmez; parti `waiting` durumuyla ve `queuePosition` ile sırada bekler, öncekiler bitince otomatik başlar. Çok eski bekleyen onay gönderim yapmadan sona erer.

#### Takılı temasları yeniden planlama (`crm_sequence_reschedule_stuck`)

Slotu geçmişte kalmış, hiç slotu olmayan ya da ertelenip vadesi geçmiş otomatik sequence mail temaslarını bugünün ilk uygun slotlarına alır. Mail göndermez.

- **Kapsam:** `sequenceId` veya `mailSettingId` (kendi hesabınız) zorunludur; ikisi de yoksa `error.validation.required`. Takılı temas yoksa `error.crm-sequence.reschedule-none-stuck`.
- **İki adımlı onay:** önizleme (`stuckCount`, `bySequence`, `firstNewSlotAt`, `lastNewSlotAt`) + onay kodu; onayda `rescheduledCount` ve `skippedCount`. Çağrı başına en çok 500 temas.

#### Posta kutusu sınırları ve hız sınırı türleri

`crm_sequence_read` `mode=mailbox_limits` yalnız size tanımlı mail hesaplarını döner: günlük sınır ve etkin tavan (ısınma dahil), bugün gönderilen/kalan, mail aralığı, dakikalık ve alıcı domain sınırı,
duraklatma durumu, son hız sınırı türü ve sonraki uygun gönderim anı (`nextAvailableSendAt`). `eqlem_whoami` da hesap başına bugün kalan kotayı (`remainingToday`) gösterir.

`send_batch` yanıtına `mode`, `status` (`waiting` dahil), `queuePosition`, `rateLimitByType`, `deferredReasonDetail` (en sık tür) ve `nextAttemptAt` eklenir; `deferredByReason` anahtarları aynen kalır.

| Tür | Anlamı |
|-----|--------|
| `provider-quota` | Sağlayıcı geçici kota yanıtı verdi; temas sonraya ertelenir (art arda 3 yanıtta hata) |
| `mailbox-hourly` | Kutunun kısa dilim/saatlik sınırı |
| `recipient-domain-hourly` | Alıcı domain'ine saatlik sınır |
| `daily-limit` | Kutunun günlük sınırı doldu |
| `warmup` | Etkin tavanı ısınma planı belirliyor |
| `min-interval` | Mailler arası en kısa aralık bekleniyor |
| `unknown` | Tür belirlenemedi |

#### Örnek ajan akışı

1. `crm_sequence_read` `mode=mailbox_limits`: kalan kota, duraklatma, sonraki uygun an.
2. Takılı temas varsa `crm_sequence_reschedule_stuck`: önizleme, onay.
3. `crm_sequence_send_pending` `mode=send_now_sequential`: önizleme (ETA, hız), onay kodu ile sıralı gönderim.
4. `crm_sequence_read` `mode=send_batch`: ilerlemeyi `rateLimitByType` ve `nextAttemptAt` ile izleme.

### İş takvimi ve gönderim penceresi

Maillerin ne zaman gideceğini sequence'in gönderim penceresi ve bağlı iş takvimi belirler.

- **Pencere ve saat dilimi sequence düzeyindedir;** iş takviminde saat dilimi veya pencere alanı yoktur. Pencere sequence'in saat diliminde değerlendirilir.
- **`SendWindows` biçimi:** `ISO-gün:HH:mm-HH:mm`, virgülle ayrılır (1 = Pazartesi ... 7 = Pazar); ör. `1:09:00-18:00,2:09:00-18:00`.
- **Alan boşsa kısıt yok;** doluyken listede olmayan gün için gönderim yoktur.
- **Hafta sonu her zaman kapalıdır;** `SendWindows` içinde `6:` veya `7:` yazsanız da gönderim olmaz.
- **İş takvimi:** `Tatil` ve `Arife` günleri tüm gün kapalıdır. `Yoğun dönem` yalnız yeni başlatmayı etkiler; devam eden temaslar gider.
- **Zaman damgaları:** `plannedAt` ve `sentAt` UTC saklanır; pencere sequence saat diliminde değerlendirilir.

**Pencereyi değiştirme (`crm_settings_write`):** iki adımlıdır, silme yoktur.

- `action=sequence_send_window_update`: `id` + değişecek alanlar (`timeZoneId`, `sendWindows`, `phoneWindows`, `dailySendLimit`, `businessCalendarId`, `skipLastWeekOfMonth`); yalnız verilen alan değişir. `sendWindows` boş metin = kısıt yok; `dailySendLimit` 0 = sınırsız.
- `action=business_calendar_day_upsert`: `calendarId`, yeni gün için `dateFrom`/`dateTo` (**yalnız `yyyy-MM-dd`**, saat/`Z` yok), `kind` (`Holiday` = Tatil, `Eve` = Arife, `Busy` = Yoğun dönem), `busyEffect` (`Busy` için zorunlu), `name`; mevcut günü güncellemek için `dayId`. Günü devre dışı bırakmak için `isActive=false`.
- **Önizleme:** ilk çağrı yazmaz; `changes` (alan, eski, yeni), `affectedSequences`, `pendingDueCount`, `deferredCount`, `windowOpenNowBefore/After` ve `confirmationToken` döner. `affectedSequences` en çok 30 öğedir; fazlası varsa `affectedSequencesTruncated` gelir.
- **Uygulama:** aynı argümanlar + `confirmationToken` ile ikinci çağrı. Yanıtta `previous` eski değeri taşır; geri almak için eski değeri aynı araçla yazın. Kod tek kullanımlık, 5 dakika geçerlidir ve argümanlara bağlıdır.
- **Yetki ve hesap:** sequence düzenleme yetkisi gerekir; sequence'in gönderen mail hesabı size tanımlı olmalıdır. Takvim günü değişikliğinde takvime bağlı her sequence'in hesabı size ait olmalıdır.
- Pencere veya takvim değişikliği ertelenmiş temasları kendiliğinden öne çekmez; bunun için `includeDeferred` kullanılır.

**Hata anahtarları:** `error.crm-sequence.send-window-closed` (`includeDeferred` çağrısında pencere şimdi kapalı), `error.crm-sequence.invalid-window` (bozuk `sendWindows` / `phoneWindows`), `error.mcp.mail-account-not-owned` (sequence'in veya takvime bağlı bir sequence'in mail hesabı size tanımlı değil), `error.mcp.confirmation-invalid` (kod süresi doldu veya argüman değişti).

**Sorun giderme: mailler "outside-window" ile ertelendi**

1. `crm_sequence_read` `mode=send_window_check` (`id`, gerekirse `at`): `reasonKey` ve `reasonDetail` nedeni söyler (`before-start`, `after-end`, `between-windows`, `no-window-for-day`, `weekend`, `holiday`, `eve`). `calendarMatches` eşleşen takvim gününü (en çok 30; fazlası `calendarMatchesTruncated`), `nextWindowOpensAtLocal` pencerenin açılacağı anı gösterir. Saat dilimi çözülemezse `timeZoneFallback` işaretlenir.
2. Gerekirse `mode=send_window` ile pencere metnini ve saat dilimini okuyun; sık görülen neden, `SendWindows` içinde ilgili günün yazılmamış veya aralığın erken bitmiş olmasıdır.
3. `crm_settings_write` ile pencereyi veya takvim gününü düzeltin: önce önizleme, sonra onay kodu ile uygulama.
4. `crm_sequence_send_pending` `includeDeferred=true`: önce önizleme (`deferredEligible`), sonra onay kodu ile kuyruğa alma.

> Not: `includeDeferred` yalnız bu sürümden sonra ertelenen temasları çeker; daha önce ertelenmiş temaslar zamanlayıcıyla ilk uygun saatte gider.

### 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.

1. **Liste:** `crm_sequence_read` `mode=due_worklist` (`channel` zorunlu, sayfa başına en çok 6). `blockedReason` dolu temasları atlayın.
2. **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.
3. **Yazma:** ajan tarayıcıda sohbeti açar ve `body` metnini mesaj kutusuna yazar; göndermez.
4. **Gönderim:** Gönder'e siz basarsınız. İsterseniz ilk N kişide her mesajı tek tek onaylarsınız.
5. **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.

### Kişi grupları ve kişi bazlı hedefleme

Kişilere birden çok **Kişi grubu** verebilir; kampanya ve sequence'te kişiyi veya kişi grubunu hedefleyebilir, bir kişiye doğrudan mesaj gönderebilirsiniz. Bu araçlar mevcut izin gruplarının içindedir; her işlemde kendi yetkiniz ve görebildiğiniz kayıtlar geçerlidir.

- **Kişi gruplarını listeleme** (`crm_contact_group_read`): Kişi grubu tipindeki grupları üye sayısıyla getirir.
- **Toplu üyelik** (`crm_contact_group_write`): kişileri gruplara ekler, çıkarır veya değiştirir (`mode` = `add` / `remove` / `replace`). Silme yoktur; grup tanımı ve silme yalnız EQLEM web'dedir.
- **Kişi arama ve güncelleme:** `crm_contact_read` aramada `groupIds` ve `matchAllGroups` (en az bir gruba mı, tümüne mi üye) ile süzer; `crm_contact_write` `groupIds` ile kişinin gruplarını belirler (verilmezse değişmez, boş liste tümünü kaldırır).
- **Kampanya hedefi:** `crm_campaign_write` hedef satırında `contactId` veya `contactGroupId` kullanılabilir; kişi ve kişi grubu hedefi **yalnız e-posta kampanyasında** geçerlidir. Aynı e-posta adresi cari ve kişi hedefinde çıksa tek gönderim yapılır.
- **Sequence kaydı:** `crm_sequence_enroll` `mode=contacts` ile kişileri ve kişi gruplarını kaydeder. İlk çağrı kayıt yazmayan önizlemedir; onayınızla ikinci çağrı kaydı yapar. Cari bağlantısı olmayan veya sequence firmasıyla uyuşmayan kişiler atlanır ve sayılır.
- **Doğrudan kişiye mesaj:** `crm_outreach_send` `contactId` alır ve `accountId` artık isteğe bağlıdır (en az biri gerekir); `common_mail_send` da `contactId` kabul eder. Kişide e-posta veya telefon yoksa gönderim yapılmaz.
- **Onay ve uyumluluk:** dış etkili araçlarda mevcut iki adımlı onay aynen sürer; kişi adresi için de iletişim onayı, opt-out ve gönderim engeli kuralları uygulanır.

Örnek istemler:

- "'Fuar 2026' kişi grubunda kaç kişi var?"
- "Bu üç kişiyi 'Karar vericiler' grubuna ekle."
- "'Karar vericiler' grubunu bu e-posta kampanyasının hedefine ekle ve planlama önizlemesini göster."

### Toplu aday içe aktarma

Yüzlerce satırlık bir aday listesini ajanınıza vererek tek seferde içe aktarabilirsiniz. Web'deki içe aktarma ekranıyla aynı işlem yapılır ve aynı sonuçlar çıkar. Mevcut `crm_lead_source_read` ve `crm_lead_source_write` araçlarına modlar eklenmiştir; yeni bağlantı onayı gerekmez.

1. **Listeyi verin:** CSV dosyasını ajana verin. Küçük listelerde metin `csvContent` ile gönderilebilir; büyük dosyalarda dosya yüklenir.
2. **Dosya yükleme:** ajan `crm_lead_source_write` `import_upload_init` modunu çağırır; 10 dakika geçerli, tek kullanımlık `uploadUrl` döner. Ajan CSV'yi bu adrese HTTP `PUT` ile yükler (ör. `curl -T dosya.csv "<uploadUrl>"`, UTF-8). Komut çalıştırabilen bir ajan gerekir.
3. **Yürütme:** ajan `import_execute` modunu `uploadId` (veya `csvContent`) ve `sourceFileName` ile çağırır. Önizleme ve ayrı rıza/onay kodu adımı yoktur; veri işleme rızası sunucuda otomatik işaretlenir. İş arka planda kuyruğa girer; `importId` ve `queued` durumu döner.
5. **İzleme:** `crm_lead_source_read` `imports` modu `id` ile çağrılınca durum, `progressPercent` (ilerleme yüzdesi), satır sayıları ve `isTerminal` (bitti mi) gelir.
6. **Hatalı ve atlanan satırlar:** `import_rows` modu `id` ile çağrılır; `status` ile süzülür, `pageIndex` / `pageSize` ile sayfalanır. Sayfa başına en çok 40, varsayılan 20 satır gelir; durum başına satır sayıları da bulunur.
7. **İptal:** gerekirse `import_cancel` modu `id` ile çağrılır.

- **Boyut:** tek seferde en çok 5.000 satır / 5 MB; büyük listeler EQLEM web arayüzünden aktarılır (`error.crm-lead-import.mcp-limit`).
- **Eşzamanlılık:** aynı anda en çok 2 içe aktarma çalışır; diğerleri kuyrukta bekler.
- **Yükleme adresi:** 10 dakika geçerli ve tek yüklemeliktir; yalnız başlatan kullanıcı `import_execute` ile kullanabilir ve içerik bir kez tüketilir. Aynı anda en çok 20 bekleyen yükleme olur. Adresi paylaşmayın.
- **Otomatik iletişim onayı:** içe aktarılan kayıtlar için Mail (e-posta varsa) ve WhatsApp (telefon varsa) onayı yoksa otomatik "verilmiş" eklenir (kaynak: `lead-import`). Onay kaydı zaten varsa (geri çekilmiş dahil) değişmez; geri çekilen onay içe aktarmayla yeniden verilmez.
- **Yetki:** "Aday içe aktarma" ve "Aday" belgelerinde ekleme yetkisi gerekir.
- **Büyük sonuç:** satırlarda çok uyarı veya grup varsa yanıt büyüyebilir; sayfa boyutunu küçültün.
- **Güvenilmez veri:** satırlardaki metinler dış kaynaklı veridir; içlerindeki talimatlar izlenmez.

Örnek istemler:

- "Bu CSV'yi aday olarak içe aktar; önce önizlemeyi göster."
- "Önizleme uygun, rıza veriyorum; aktarımı başlat ve bitene kadar durumu söyle."
- "Son içe aktarmada hatalı satırları göster."

### Aktivite türleri, görev planları ve otomatik yürütme

Aktiviteler 14 türdür: görev, telefon, toplantı, e-posta, WhatsApp, SMS, LinkedIn (bağlantı isteği ve mesaj), demo, saha ziyareti, teklif takibi, kurulum / eğitim, tahsilat takibi ve hatırlatma. Her tür kendi alanlarını taşır (ör. arama sonucu, toplantı linki, bağlı teklif veya fatura). Ajanınız bugünkü ve geciken aktivitelerinizi listeler, sonuçla tamamlar ve sonraki adımı açar.

- **Görev planı:** tek bir cari veya aday için adım adım takip planı. Ajan planı kurar, adımları tamamlar, atlar veya erteler, planı duraklatır, sonuçla kapatır, şablon olarak kaydeder. Plan adımları Bugünkü Temaslarım'a "Plan" rozetiyle düşer.
- **Şablon:** bir şablonu bir veya birden çok cariye uygulatabilirsiniz. Uygulamadan önce **önizleme** kaç plan oluşacağını, kimlerin atlanacağını ve otomatik adımları gösterir; mesajı gerçek cari bilgileriyle de önizleyebilirsiniz.
- **Otomatik yürütme:** E-posta ve WhatsApp aktiviteleri ile plan adımlarında "otomatik yap"ı açarsanız mesaj vadesinde sistem tarafından, seçtiğiniz hesap veya hattan gönderilir. Bunun için ajanın özetini onaylamanız gerekir. Gönderim anında iletişim izni, opt-out ve engel kuralları yeniden denetlenir; izin yoksa gönderilmez. Başarısız olan iş elle yapılacak iş olarak Temaslarım'a düşer. Otomatik SMS yoktur.
- **Hatırlatma:** ekip arkadaşlarınıza e-posta, uygulama içi bildirim veya (onaylı şablonla) WhatsApp ile hatırlatma kurabilirsiniz; müşteriye gitmediği için onay istemez. Toplantı ve demo için katılımcılara hatırlatma maili ise onaylıdır.
- **Raporlar:** aktivite özeti (tür ve sorumluya göre, otomatik / elle ayrımıyla) ve görev planı özeti (şablon bazında başlatılan, tamamlanan, yanıt gelen, kazanılan).
- **Onay kodu ve tekrar deneme:** onaylı işlemlerde ajan önce özeti gösterir, onayınızla aynı bilgiler ve 5 dakika geçerli tek kullanımlık kodla ikinci çağrıyı yapar. Kayıt oluşturan işlemlerde ajan benzersiz bir `idempotencyKey` gönderir; bağlantı koparsa aynı çağrı yeniden denendiğinde çift kayıt oluşmaz.
- **Ek CRM işlemleri:** fiyat teklifi oluşturma ve güncelleme, etiket tanımı, kayıt gruptan çıkarma, cari birleştirme, satış aşaması / SLA / puanlama / otomasyon kuralı gibi ayar tanımları; hepsi yetkinizle ve (özet gerektirenler) onayınızla çalışır. Silme yoktur.

Örnek istemler:

- "Bu cariye 'Yeni kayıt takibi' şablonunu uygula; önce önizlemeyi göster."
- "Bugün vadesi gelen ve geciken aktivitelerimi listele."
- "Yarın 10:00 için bu kişiye otomatik WhatsApp aktivitesi aç; hangi hattan gideceğini göster."
- "Geçen ay şablon bazında kaç plan başladı, kaçı yanıt aldı?"

### Ajanın yapamadıkları

- Kayıt silemez, aday iptal edemez; kişi grubu tanımlayamaz veya silemez (yalnız kişilerin grup üyeliğini değiştirir).
- İletişim izni (consent) kaydı oluşturamaz veya kaldıramaz; opt-out ve gönderim engelini kaldıramaz (toplu aday içe aktarmadaki otomatik onay kaydı hariç). Gönderimi yalnız kapatan opt-out ve engel eklemeyi onayınızla yapabilir.
- Otomatik SMS ve SMS hatırlatması yoktur; SMS aktivitesi yalnız elle yürütülür ve kayıt tutar.
- Fiyat teklifini siparişe veya faturaya dönüştüremez; servis talebinden belge üretemez.
- Cari birleştirme (geri alınamaz), dönemsel işlemden belge üretme ve ayar tanımı değişiklikleri yalnız onay koduyla yapılır; webhook gizli anahtarı ve portal API anahtarı ajana verilmez.
- Seçmediğiniz izin gruplarındaki, lisansınızda olmayan ya da belge yetkinizin kapsamadığı işlemleri göremez.

## Claude (claude.ai ve Desktop)

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

> Not: claude.ai'de özel bağlayıcı (custom connector) eklemek ücretli plan gerektirir; Team/Enterprise planlarında yönetici izni gerekebilir.

## Claude Code

1. Terminalde şu komutu çalıştırın (`<MCP URL>` yerine **AI bağlantıları** ekranındaki URL'yi yazın):

   ```bash
   claude mcp add --transport http -s user eqlem https://api.firmaniz.com/api/v2/mcp
   ```

   `--transport http` taşıma türünün adıdır; adres `https://` ile başlar. `-s user` sunucuyu kullanıcı kapsamında ekler; böylece `eqlem` tüm klasörlerde görünür.
2. Terminalde `claude` yazın, ardından `/mcp` yazıp `eqlem` sunucusunu seçin ve **Authenticate**'i başlatın; tarayıcıda EQLEM giriş ve onay ekranı açılır.
3. Onaydan sonra araçlar oturumda görünür.

## ChatGPT

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

> Not: ChatGPT'de özel MCP uygulaması eklemek için geliştirici modu ve uygun bir plan gerekir.

## Gemini CLI

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

   ```json
   {
     "mcpServers": {
       "eqlem": {
         "httpUrl": "https://api.firmaniz.com/api/v2/mcp"
       }
     }
   }
   ```
2. 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.
3. 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.

1. EQLEM'de **AI bağlantıları** ekranında (Admin) bir **kurumsal OAuth istemcisi** oluşturun.
2. İstemcinin yönlendirme (redirect) adresi olarak şunu girin: `https://vertexaisearch.cloud.google.com/oauth-redirect`
3. Oluşan `client id` ve `client secret` değerlerini not edin.
4. 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).
5. Kullanıcılar ilk kullanımda EQLEM giriş ve onay ekranını görür.

## Microsoft Copilot Studio

1. Copilot Studio'da ajanınıza bir MCP aracı ekleyin ve MCP URL'sini girin (yalnız Streamable HTTP desteklenir).
2. Kimlik doğrulamada önce **Dynamic discovery** seçeneğini deneyin. Bağlantı kurulursa EQLEM giriş ve onay ekranında onaylayın.
3. 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

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

   ```json
   {
     "servers": {
       "eqlem": {
         "type": "http",
         "url": "https://api.firmaniz.com/api/v2/mcp"
       }
     }
   }
   ```
2. Sunucuyu başlatın; VS Code kimlik doğrulama ister ve tarayıcıda EQLEM giriş ve onay ekranı açılır.
3. Copilot sohbetinde (ajan modu) EQLEM araçlarını seçin.

## Cursor

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

   ```json
   {
     "mcpServers": {
       "eqlem": {
         "url": "https://api.firmaniz.com/api/v2/mcp"
       }
     }
   }
   ```
2. Cursor'da sunucuyu etkinleştirin; EQLEM giriş ve onay ekranı açılır.
3. Cursor istemcisini otomatik kayıtla tanıtır. Bağlantı kurulamazsa EQLEM yöneticinize bildirin.

## B2B alıcı (satın alma asistanı)

Tedarikçinizin B2B portalında alıcı hesabınız varsa AI ajanınızı **kendi alıcı kimliğinizle** bağlayabilirsiniz. Ajan, portalda yaptıklarınızın bir bölümünü sizin adınıza yapar: katalogda arama, sepet hazırlama, sipariş, cari ve ekstre kontrolü, durum takibi. Bu bağlantı CRM bağlantısından ayrıdır: alıcı oturumu yalnız `b2b_*` araçlarını görür, CRM araçları alıcı oturumuna kapalıdır. Kullanım, tedarikçinin B2B Yönetimi lisansına ve B2B portal erişiminize bağlıdır.

### Alıcı asistanı neler yapabilir?

- **Okuma:** katalog (ürün arama ve detay, kategori, marka, kayıtlı listeler), siparişler ve sevkiyatlar, cari bakiye ve kredi limiti özeti, ekstre özeti (toplamlar ve son 25 hareket), faturalar (PDF yok), adres seçenekleri, bekleyen onaylar, teklif talepleri ve sözleşmeler.
- **Yazma:** sepete satır ekleme/güncelleme/çıkarma ve kayıtlı listeyi sepete ekleme (`b2b_cart_write`), sipariş oluşturma (`b2b_order_write`), teklif talebi, kabul ve iptal (`b2b_rfq_write`), iade talebi (`b2b_return_write`).
- `b2b_whoami` hangi alıcı / firma olarak bağlı olduğunuzu gösterir.
- Portalın sipariş kuralları (onay zinciri, bütçe, kredi limiti, asgari tutar, çalışma saati) aynen uygulanır. Onay gerektiren sipariş "onay bekliyor" durumunda açılır.

### Nasıl bağlanılır?

1. Tedarikçinizden **MCP adresini** alın. Ajan sağlayıcınızdaki ekleme adımları yukarıdaki sağlayıcı bölümleriyle aynıdır; fark kimlik doğrulama adımındadır.
2. Bağlantıyı başlattığınızda tarayıcıda **alıcı izin ekranı** açılır.
3. **B2B portalındaki e-posta ve parolanızı** girin. Ajan parolanızı görmez.
4. İzinleri seçin. Okuma izinleri (katalog, sipariş, cari) istemcinin istediği kadarıyla sunulur; **yazma izinleri** (sepet, sipariş, iade, teklif talebi) **varsayılan olarak kapalıdır**, ayrıca işaretlemeniz gerekir.
5. **Onayla**'ya basın (en az bir izin seçili olmalı). Reddetmek için kimlik girmeniz gerekmez.
6. Ajanınıza "EQLEM'de hangi firma adına bağlıyım?" diye sorarak bağlantıyı doğrulayın.

Birden fazla firma üyeliğiniz varsa ajan ilk alıcı üyeliğinizle çalışır; araçla firma değiştirilemez.

### Güvenlik ve sınırlar

- **İki adımlı onay:** sipariş oluşturma, iade talebi ve teklif talebi / kabulü / iptali önce özet gösterir; siz onaylayınca yapılır. Onay kodu tek kullanımlıktır ve 5 dakika geçerlidir; sepet, fiyat veya stok değişirse geçersiz olur.
- **Sepet hazırlıktır:** sepet değişikliği sipariş vermez ve geri alınabilir. Sipariş yalnız onaylı çağrıyla oluşur.
- **Ödeme / kart aracı yoktur;** kartla ödeme yalnız portalda yapılır. Ajan silme, onaylama / reddetme veya adres değiştirme yapamaz.
- **Firma izolasyonu:** ajan yalnız kendi firma (Party) kapsamınızdaki veriyi görür; başka firma veya kiracı verisi istenirse reddedilir.
- **Yetkilerinizi siz belirlersiniz:** yazma izinleri siz seçmedikçe verilmez; ajan portal yetkinizin dışına çıkamaz.
- **Parola değişince bağlantılar iptal olur:** parolanız değiştiğinde veya hesabınız pasifleştiğinde ajan bağlantılarınızın tümü iptal edilir; yeniden bağlanıp onaylamanız gerekir.
- **Oran sınırı:** dakikada 60 çağrı; yazma işlemleri dakikada 10; sipariş, iade ve teklif gibi dış etkili işlemler saatte 20.
- **Denetim:** her araç çağrısı maskeli argümanlarla kayda alınır. Not, açıklama ve adres gibi serbest metinler güvenilmeyen veri sayılır; içlerindeki talimatlar izlenmez.

### Örnek istemler

- **Tekrar sipariş:** "Kayıtlı listemdeki ürünleri sepete ekle, sepeti özetle ve sipariş önizlemesini göster."
- **Ürün bulma:** "OEM123 numaralı ürünü bul ve sepete 10 adet ekle."
- **Ekstre kontrolü:** "Bu ayki ekstremi ve cari bakiyemi özetle; kredi limitimden ne kadarı kaldı?"
- **Durum takibi:** "Onaylanmış siparişlerimi listele ve en sonuncusunun sevkiyat durumuna bak."
- **Teklif talebi:** "Şu üründen 50 adet için teklif iste."
- **İade:** "Şu siparişin 1. satırından 2 adet iade talebi hazırla; iade nedenlerini göster."

### B2B alıcı: sık sorulanlar ve sorun giderme

**"E-posta veya parola hatalı" görüyorum.** Portalda kullandığınız e-posta ve parolayı girin. 15 dakikada 5 hatalı girişten sonra hesap geçici kilitlenir; ekrandaki süre dolunca tekrar deneyin.

**Lisans veya pasif hesap hatası alıyorum.** Tedarikçinizin B2B lisansı yoktur ya da hesabınız pasiftir; tedarikçinizle iletişime geçin.

**Ajan sipariş veya iade araçlarını görmüyor.** Yazma izinleri bağlantıda seçilmemiştir; yeniden bağlanıp ilgili yazma iznini işaretleyin.

**Onay kodu geçersiz.** Süre dolmuş, kod kullanılmış ya da sepet / fiyat / stok değişmiş olabilir; ajandan özeti yeniden almasını isteyin.

**Sipariş "onay bekliyor" durumunda.** Portaldaki onay zinciri devrededir; onaycı portalda onaylar, ajan onaylayamaz.

**Bağlantı aniden kesildi.** Parola değişmiş ya da hesap pasifleşmiş olabilir; yeniden bağlanıp izinleri onaylayın.

**Kart ile ödeme yapabilir miyim? Fatura PDF'i indirir mi?** Hayır; ödeme yalnız portalda, ajan fatura bilgisini okur.

## 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.

**Araçlar görünmüyor.** Ajanınızdan `eqlem_whoami` aracını çağırmasını isteyin; çıktı gizlenen araç sayısını nedenine göre (izin seçimi, lisans, yetki) ve eksik izinleri gösterir.

**"Etkin bağlantı sınırına ulaşıldı" görüyorum.** **AI bağlantıları** sayfasından kullanılmayan bir bağlantıyı iptal edip yeniden deneyin; tamamlanmamış denemeler artık sınırı doldurmaz.

**"Bağlanılan MCP adresi hesabınıza ait değil" görüyorum.** **AI bağlantıları** sayfasındaki adresi kullanın veya doğru hesapla giriş yapın.

**"API bağlantı adresi bulunamadı" görüyorum.** EQLEM yöneticinize başvurun.

**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ü](https://www.eqlem.com/tr/moduller/crm) inceleyin ya da **Ücretsiz Dene** ile başlayın.
