Araçlar
Solk MCP sunucusunun okuma, yazma ve kalıcı silme araçları, parametreleri ve örnek istemleri.
Araçlar REST API'nin üzerinde çalışır: her araç çağrısı ilgili API ucunu sizin hesabınızla çağırır ve aynı kurallar (yetki, görünürlük, aşama kapıları, mükerrer koruması) geçerlidir. İstemciye yalnız sizin kullanabildiğiniz araçlar listelenir:
crm.readkapsamı yoksa okuma,crm.writeyoksa yazma araçları listede görünmez. Silme araçları yalnız onay ekranında ayrıca Kalıcı silme (crm.delete) kutusu işaretlendiyse gelir.- Bağlı olmayan entegrasyonların araçları (WhatsApp Business, santral, SMS, görüşme kaydı) ve yönetici araçları (iş akışı taslağı, abonelik özeti, birleştirme, pasife alma, fırsat silme) satışçıya listelenmez.
- Lisansta ya da kullanıcınızda kapalı modüllerin araçları (ör. Fuar leadleri modülü kapalıysa ilgili araçlar) listelenmez.
Araçların adları ve açıklamaları modellerin daha iyi anlaması için İngilizcedir; asistanla Türkçe konuşabilirsiniz.
Okuma araçları
Okuma araçları istemciye readOnlyHint: true olarak bildirilir — Claude bunlar için "her zaman izin ver" seçeneği sunar.
| Araç | Açıklama | Parametreler | Örnek istem |
|---|---|---|---|
search |
Ad, şehir, telefon ya da e-postayla firma, kişi, fırsat ve fuar leadi arar (en az 2 karakter); 15 karakterlik kayıt kimliğini de çözer. | query* |
Kumsal Plastik'i bul |
list_companies |
Firmaları süzgeçlerle listeler: durum (AC / Prospect), sorumlu, şehir, ziyaret durumu ve sayaçlar. | page, query, scope (mine · all), sort (name · visit · priority), status (AC · Prospect), visit (overdue · soon · ok · none) |
Ziyareti geciken aktif müşterilerimi listele |
get_company |
Firma kartının tamamı: kişiler, fırsatlar, son ziyaret ve denemeler, açık aksiyonlar, teklifler, notlar ve e-posta yazışmaları. | company_id* |
Alize Paketleme'nin kartını özetle |
list_contacts |
Firmalardaki kişileri listeler. | query, scope (mine · all) |
Satın alma müdürü unvanlı kişileri göster |
list_opportunities |
Fırsatları listeler: açık (varsayılan), kapalı, müşteri takibi ya da bir aşama; güncelleme, sağlık, değer ya da SLA'ya göre sıralı. | page, query, scope (mine · all), sort (update · health · value · sla), stage |
Negotiation'daki fırsatları değere göre sırala |
get_opportunity |
Fırsatın tamamı: aşama, değer, olasılık, sağlık, kontrol listesi, BANT, kapı sorunları, ziyaretler, denemeler, teklifler, aşama geçmişi. | opportunity_id* |
Streç film fırsatı bir sonraki aşama için neyi bekliyor? |
list_actions |
Açık işler: görevler, ziyaret ve denemelerin sonraki aksiyonları, tarihli proje adımları; her satırda tür + kimlik. | company_id, scope (mine · all), state (today · overdue · soon · open · week) |
Bu hafta geciken aksiyonlarım neler? |
get_action |
Tek aksiyon ya da görev, bağlamıyla (firma, proje, geçmiş). | id, kind (visit · demo · task · step) |
Fiyat listesi görevinin ayrıntısını aç |
list_calendar |
Tarih aralığındaki toplantılar ve aksiyonlardan türeyen takvim girişleri. | from, to |
Gelecek hafta takvimimde neler var? |
list_email_threads |
Kullanıcıların posta kutularından eşitlenen yazışmalar: bir kaydınkiler ya da gelen kutusu. | filter (all · waiting · replied · mine), query, record_id, record_type (customer · opp · visit · demo · task · offer · ticket · contract) |
Yanıt bekleyen müşteri e-postalarını göster |
get_email_thread |
Bir yazışmanın iletileri (görme izni yoksa gizli) ve bağlı kayıtları. | thread_id* |
Kuzey Plastik'le son yazışmayı özetle |
get_dashboard |
Pano: aşamalara göre sayı ve değer (ana dövizde), haftalık ziyaret hedefleri, SLA aşımları, sıradaki adımlar. | scope |
Satış hattının özetini çıkar |
get_today |
Günüm: bugünün toplantıları ve işleri, gecikenler, son açılan kayıtlar ve bu haftanın aktivitesi. | — | Bugün ne yapmam gerekiyor? |
list_team |
Etkin kullanıcılar (kimlik, ad, rol, departman) — atama ve sorumlu alanları için. | — | Ekipte kimler var? |
list_comments |
Yorum konuları (ekip içi tartışma, not değil): bir kaydınkiler (record_type + record_id; açık | tümü) ya da kayıtsız 'gelen kutum' — benden bahsedenler, katıldıklarım, tüm açık konular. | filter (open · all · mentions · mine), record_id, record_type (customer · opp · contact · thread · lentry · canvas) |
Benden bahsedilen açık yorumları göster |
list_lists |
Amaç listeleri (ör. '4. çeyrek hedefleri'): nesne, liste aşamaları, listeye özel alanlar, giriş sayısı, düzenleme izni. | object (customer · contact · opp) |
Hangi listeler var? |
get_list_entries |
Listedeki kayıtlar, liste aşaması ve liste alanı değerleriyle (sayfa başına 100). | list_id*, page, stage |
Fuar takip listesinde 'Teklif' aşamasındakileri göster |
list_reports |
Görebildiğiniz kayıtlı raporlar ve hazır rapor kalıpları (huni, aşamada geçen süre, aşama değişimleri, geçmiş değerler) ile tarih aralıkları. | — | Hangi raporları çalıştırabilirim? |
run_report |
Kayıtlı raporu ya da hazır kalıbı çalıştırır; range dönemini ezer. Etiketler, seriler, toplamlar ve tablo döner (huni dönüşüm ve kazanma oranı da verir). Tutarlar ana dövizde. | range, report_id, template |
Bu çeyreğin satış hunisini ve kazanma oranını çıkar |
get_relations |
Firma, kişi ya da fırsatın ilişkileri (ana firma ↔ şubeler, kişinin diğer firmaları, fırsattaki ortak) ve eklenebilir ilişki anahtarları (relation = 'anahtar:a|b'). | record_id, record_type (customer · contact · opp) |
Kuzey Plastik'in bağlı şirketleri hangileri? |
list_canvases |
Görebildiğiniz tuvaller (bir firma / fırsatınkiler ya da adla) ve tuval kalıpları. | query, record_id, record_type (customer · opp) |
Kuzey Plastik'in tuvallerini listele |
read_canvas |
Tuvali okur: ana hat (çerçeveler ve içindeki notlar, şekiller, kartlar, oylar, bağlantılar — varsayılan), json (tüm öğeler konum ve kimlikleriyle) ya da svg (görüntü). | canvas_id*, format (outline · json · svg) |
Fuar sonrası beyin fırtınası tuvalini özetle, en çok oy alanlar hangileri? |
list_products |
Teklif için ürün kataloğu: kod, ad, grup, birim, döviz ve birim liste fiyatı. company_id verilirse firmanın anlaşmalı fiyatları, include_stock ile ilk 5 ürünün ERP'deki anlık stoğu (stok okuyan bağlantı varsa). | company_id, group, include_inactive, include_stock, limit, query |
Film grubundaki ürünleri liste fiyatlarıyla göster |
list_offers |
Teklifler: durum (taslak, onay bekliyor, onaylandı, sunuldu, kabul = kazanıldı, red, süresi doldu, revize edildi), tutarlar ve onay işareti. status=open (varsayılan) = henüz sonuçlanmamış. Tutarlar teklif dövizinde aylık ve yıllık, ayrıca ana dövizde yıllık. | company_id, opportunity_id, page, query, scope (mine · all), status (open · all · draft · review · approved · denied · presented · expired) |
Onay bekleyen teklifleri listele |
get_offer |
Tek teklif: kalemler (ürün, aylık miktar, birim, liste fiyatı, net birim fiyat, iskonto %), toplamlar, onay nedenleri ve durumu, sürümler, vade, geçerlilik ve PDF bağlantısı. | offer_id* |
TKL-2026-0044 teklifinin kalemlerini ve iskontolarını göster |
list_orders |
Müşteri siparişleri: PO numarası, ürün, miktar, sevk edilen / kalan miktar, durum, termin ve ERP'ye gönderim durumu. | company_id, opportunity_id, page, query, status (open · late · partial · closed · all) |
Termini geçen açık siparişler hangileri? |
get_company_finance |
Bağlı muhasebe / ERP sisteminden cari (salt okunur): bakiye, vadesi geçen tutar, kredi limiti ve risk %, açık ve vadesi geçen faturalar, 12 aylık ciro, ortalama vade ve fatura listesi. Faturalar Solk'ta değil ERP'de kesilir. | company_id*, limit, status (all · open · overdue · paid) |
Kuzey Plastik'in vadesi geçen faturaları ve bakiyesi ne? |
list_tickets |
Destek talepleri (şikâyet, teknik destek, soru, iade…) öncelik, durum, görevli ve SLA durumuyla. status=open (varsayılan: gelen, devam ediyor, beklemede) SLA hedefine göre sıralı. | assigned (me · unassigned · all), company_id, page, priority (Düşük · Normal · Yüksek · Acil), query, sla (overdue · soon), status (open · all · new · in_progress · on_hold · resolved · closed) |
SLA'sı geçen açık destek taleplerini göster |
get_ticket |
Tek destek talebi: ayrıntı, çözüm, SLA zamanları, bağlı ürün / lot, sipariş ve fırsat, zaman çizelgesi (iç notlar, müşteriye yanıtlar, durum ve görevli değişiklikleri). | ticket_id* |
Yırtılma şikâyetinde şu ana kadar ne yapıldı? |
list_contracts |
Müşteri sözleşmeleri (tedarik / hizmet / abonelik): tarihler, kalan gün, yenileme (otomatik yenileme, ihbar süresi), tutar ve durum. status=active (varsayılan) = imzalı ve yürürlükte; expiring = ihbar süresinde. | company_id, expiring_within_days, page, query, status (active · expiring · draft · awaiting_signature · signed · completed · terminated · all) |
Önümüzdeki 60 günde biten sözleşmeleri listele |
list_automations |
Çalışma alanında kendiliğinden çalışanlar: iş akışları (tetikleyici, koşul, adımlar, çalışma sayısı) ve tepki verdikleri kayıt olayları; yöneticiye ayrıca bağlı uygulamalar (Slack, Teams, web kancaları…) ve olayları ile ERP'ye sipariş gönderimi. Bu araçlarla yapılan değişiklikler de bunları tetikler. | — | Bir fırsat kazanılınca hangi otomasyonlar çalışıyor? |
list_phone_calls |
Santral aramaları (Netgsm, Verimor, Bulutfon, AloTech, Tegsoft ya da diğer santral): yön, durum (görüşüldü, cevapsız, cevap yok), firma / kişi, kullanıcı ve dahili, konuşma süresi, kuyrukta bekleme, görüşme kaydı, ses kaydı ve cevapsız aramaya geri dönülüp dönülmediği. Toplamlar: cevaplanma oranı, cevapsız / geri dönülen, ortanca geri dönüş süresi, konuşma süresi. | company_id, days, direction (in · out), limit, mine, status (missed · answered), unreturned |
Dün geri dönmediğimiz cevapsız aramalar hangileri? |
get_activity |
Bir firmanın ya da fırsatın etkinlik akışı (yeni önce, sayfalı): e-posta, arama, SMS, WhatsApp, görüşme, teklif, sipariş, not, değişiklikler; her satırda nereden girildiği. | before, company_id, group (all · mail · call · wa · meet · deal · note · task), limit, opportunity_id |
Kuzey Plastik'te son iki haftada neler oldu? |
search_activities |
Tüm kayıtlarda etkinlik arar: ziyaret, deneme, santral araması, SMS, tek tek e-postalar, WhatsApp, not, görüşme kaydı, tamamlanan görev, teklif, sipariş. Tür, firma, fırsat, kişi, tarih, metin ve yönle süzülür; imleçle sayfalanır. | before, company_id, date_from, date_to, direction (in · out), limit, mine, opportunity_id, query, types, user_id |
Bu hafta ekibin gönderdiği e-postaları listele |
aggregate |
Kayıtları en çok iki boyutta sayar, toplar ya da ortalar: sorumlu, aşama, yön, şehir… ve gün / hafta / ay / çeyrek / yıl. Yalnız görebildiğiniz kayıtlar sayılır; tutarlar ana dövizde. | company_id, date_field, date_from, date_to, field, filters, group_by, limit, metric (count · sum · avg · min · max), mine, object* (companies · opportunities · visits · demos · tasks · offers · orders · emails), opportunity_id |
Bu çeyrek satışçı başına kaç ziyaret yapıldı? |
get_fields |
aggregate'in kullanabileceği nesneler, boyutlar, tarih ve sayı alanları; nesne verilirse boyutların değerleri ve özel alanlar. | name_contains, object |
Fırsatları hangi alanlara göre gruplayabilirim? |
search_help |
Çalışma alanının kullanım kılavuzunda, turlarda ve ipuçlarında arar; bağlantıyla döner. | limit, query* |
Fırsat aşaması nasıl değiştirilir? |
get_workspace |
Çalışma alanı ve oturum: sürüm, ana döviz, açık modüller, aşamalar (yeniden adlandırılmış etiketler, olasılık, öngörü kategorisi), görünürlük, lisans, bağlı entegrasyonlar. | — | Satış aşamalarımız ve olasılıkları neler? |
get_contact |
Tek kişi: firma, unvan, e-posta, telefon, özel alanlar, son e-postalar ve ziyaretler. | contact_id* |
Merve Ak'la son temasımız ne zamandı? |
list_call_recordings |
Görüşme ve toplantı kayıtları (not alıcı, tarayıcı kaydı, santral, Google Meet / Microsoft Teams dökümleri): başlık, firma, süre, özet durumu. | company_id, filter (all · mine), query |
Kuzey Plastik'le yapılan toplantı kayıtlarını getir |
get_call_recording |
Tek kayıt: konuşmacılar ve konuşma payı, özet bölümleri, yapılacaklar, bölümler ve konuşmacılı döküm. | recording_id* |
Dünkü toplantının yapılacaklarını çıkar |
list_notes |
Firma, fırsat, talep ve sözleşmelerdeki notlar: benim, bahsedildiğim, favoriler ya da bir kaydınkiler. | filter (all · mine · mentions · favs), limit, query, record_id, record_type (customer · opp · ticket · contract) |
Beni etiketleyen notları göster |
get_note |
Tek not: kaydı, yazanı, etiketleri ve bahsedilenleri. | note_id* |
Bu notun tamamını aç |
list_email_templates |
Kullanabildiğim e-posta şablonları (ortak ve kendi şablonlarım). | query |
Teklif takibi için şablonumuz var mı? |
get_email_template |
Tek şablon: konu ve gövde (değişkenler süslü parantezde). | template_id* |
Teklif takip şablonunu göster |
render_email_template |
Şablonun değişkenlerini firma / kişi / fırsat için doldurur; hazır konu ve gövde döner (kaydetmez, göndermez). | company_id, contact_id, opportunity_id, template_id* |
Teklif takip şablonunu Merve Ak için doldur |
list_notifications |
Bildirimlerim: son 50 (bahsetme, atama, onay, gelen WhatsApp, gecikenler…) okundu durumuyla. | — | Okumadığım bildirimler neler? |
list_saved_views |
Kayıtlı liste görünümleri (fırsat, talep, sözleşme, sipariş) — benim ve ortak — açan bağlantıyla. | kind (opp · ticket · contract · order) |
Kayıtlı görünümlerimi listele |
list_custom_fields |
Firma, kişi ve fırsat özel alanları: anahtar, etiket, tür, seçenekler, döviz, yapay zekâ alanları. | record_type (customer · contact · opp) |
Fırsatlarda hangi özel alanlar var? |
list_object_types |
Çalışma alanının özel nesne türleri (ör. üretim hattı, şube, ekipman) ve kayıt sayıları. | — | Hangi özel nesnelerimiz var? |
list_object_records |
Bir özel nesne türünün kayıtları (sayfa başına 40), isteğe bağlı bir firmanınkiler. | archived (1), company_id, object_key*, page, query |
Kuzey Plastik'in üretim hatlarını listele |
get_object_record |
Tek özel nesne kaydı: tüm alan değerleri ve bağlantıları. | object_key, record_id |
3 numaralı hattın ayrıntısını aç |
get_workflow |
Tek iş akışı: tetikleyici, koşullar, adımlar, açık / kapalı, çalışma sayısı (yönetici). | workflow_id* |
'Teklif hatırlatma' akışı ne yapıyor? |
list_roles |
Roller ve modül erişimi, kayıt görünürlüğü ve her etkin üyenin rolü. | — | Kim hangi role sahip? |
get_billing_summary |
Paket, dönem, kullanılan / lisanslı koltuk, lisans bitişi ve son Solk faturaları (yönetici). | — | Kaç koltuğumuz boşta? |
list_whatsapp_chats |
WhatsApp Business yazışmaları: kişi, firma, son ileti, okunmamış sayısı, 24 saatlik yanıt penceresinin açık olup olmadığı (beta). | company_id, filter (all · unread · open · unlinked), query |
Yanıt bekleyen WhatsApp mesajları var mı? |
get_whatsapp_chat |
Bir yazışmanın son 50 iletisi, iletim durumları ve şu an kullanılabilecek onaylı şablonlar (beta). | chat_id* |
Merve Ak'la WhatsApp yazışmasını özetle |
* zorunlu parametre.
Yazma araçları
Yazma araçları kayıt oluşturur ya da değiştirir; hiçbiri kayıt silmez. Var olan veriyi değiştiren araçlar destructiveHint: true olarak bildirilir: update_* araçları, postpone_action, fill_ai_field, send_whatsapp, update_company, change_opportunity_stage, complete_action, log_activity (açık aksiyonları kapatabilir), resolve_comment, upsert_list_entries, add_relation (tekil ilişkide eskisinin yerine geçer), remove_relation, update_canvas, create_offer (birincil teklif olur, fırsatın fiyatını günceller), update_offer_status, create_order (firmayı müşteri yapabilir, siparişi ERP'ye gönderebilir), update_ticket, run_workflow. Yalnız ekleme yapanlar (diğer create_*, add_note, add_comment) false. create_order, run_workflow ve send_whatsapp ayrıca openWorldHint: true — dış bir sisteme (ERP'niz, iş akışındaki HTTP adımı, müşterinin WhatsApp'ı) gidebilir. create_email_draft yalnız taslak kaydeder, e-posta göndermez; create_workflow akışı kapalı taslak olarak açar. Claude her yazma çağrısından önce onay ister. Yönetici yalnız okuma kuralını açtıysa yazma araçları listelenmez.
| Araç | Açıklama | Parametreler | Örnek istem |
|---|---|---|---|
create_company |
Firma açar (verilmezse Prospect). Aynı ad varsa reddedilir; benzer adlarda confirm_new gerekir. İsteğe bağlı ilk kişi. | address, city, confirm_new, contact_email, contact_name, contact_phone, contact_title, name*, note, owner_id, phone, sector, status (AC · Prospect), website |
Anadolu Gıda Ambalaj adında Konya'da yeni bir aday firma aç |
update_company |
Firma alanlarını günceller (yalnız verilenler değişir). | address, city, company_id*, name, note, owner_id, phone, sector, status (AC · Prospect), visit_period_days, website |
Kuzey Plastik'i aktif müşteri yap ve 30 günde bir ziyaret ayarla |
create_contact |
Firmaya kişi ekler. | company_id, department, email, is_main, name, note, phone, title |
Kuzey Plastik'e Emre Yıldız'ı üretim şefi olarak ekle |
create_opportunity |
Firma için yeni satış projesi açar (ilk aşamadan başlar). | company_id*, competitor, name, note, type, value |
Kuzey Plastik için 'Streç film tedariki' fırsatı aç |
change_opportunity_stage |
Fırsatı başka aşamaya taşır; aşama kapıları uygulanır, reddedilirse nedenleri döner. | note, opportunity_id, reason, stage (Lead · In Progress · Win · Lost · Cancel) |
Streç film fırsatını Viable'a taşı |
create_task |
Görev açar (verilmezse bana atanır). Firma bağlamak isteğe bağlı; kendiliğinden proje açılmaz. | assigned_to, company_id, company_name, detail, due_date, due_time, opportunity_id, priority (Düşük · Normal · Yüksek · Acil), title* |
Yarın 10:30'a Kuzey Plastik'i arama görevi oluştur |
complete_action |
Aksiyonu tamamlar (görev, ziyaret / deneme aksiyonu, proje adımı); done_on tamamlanma günü. | done_on, id, kind (visit · demo · task · step), result |
Fiyat listesi görevini tamamlandı yap |
log_activity |
Telefon görüşmesi, online toplantı ya da yüz yüze ziyaret kaydeder (Hızlı Giriş): not, sonuç, sonraki aksiyon ve tarihi; uygun açık aksiyonları kapatır. | action_date, company, confirm_new, contact, next_action, note, opportunity_id, result, topic, visit_date, visit_type (F2F · Online · Call) |
Kuzey Plastik'le az önceki telefon görüşmesini kaydet, perşembeye teklif aksiyonu aç |
add_note |
Firma, fırsat, destek talebi ya da sözleşmeye not ekler. | body, record_id, record_type* (customer · opp · ticket · contract) |
Alize Paketleme'ye 'fiyat revizyonu istendi' notu düş |
add_comment |
Kayıtta yeni yorum konusu açar ya da bir konuya yanıt yazar (reply_to = konudaki herhangi bir yorum). mention_user_ids ile ekip arkadaşına bahsetme bildirimi gider; çözülmüş konu yanıtla yeniden açılır. | body, mention_user_ids, record_id, record_type* (customer · opp · contact · thread · lentry · canvas), reply_to |
Kuzey Plastik'e 'numune ne zaman gidiyor?' diye yorum yaz, Ayşe'den bahset |
resolve_comment |
Yorum konusunu çözüldü yapar (resolved=false yeniden açar). | comment_id*, resolved |
Numune konusundaki yorumu çözüldü yap |
upsert_list_entries |
Anahtarla ekle / güncelle: her satırdaki kayıt (record_id ya da adı) listede yoksa eklenir, sonra liste aşaması ve liste alanları yazılır. En çok 200 satır; satır bazında hata döner. | list_id, rows |
Bu beş firmayı 4. çeyrek hedeflerine ekle, aşama 'İlk temas' |
add_relation |
Kaydı başka bir kayda bağlar (get_relations.available'dan ilişki, hedef kimliği). Tekil ilişkide eski bağ değişir; ana firma zincirinde döngü reddedilir. | note, record_id, record_type (customer · contact · opp), relation, target_id |
Kuzey Plastik Bursa'yı Kuzey Plastik'in şubesi yap |
remove_relation |
Bir ilişki bağını kaldırır (get_relations'tan relation_id). Kayıtlar silinmez. | relation_id* |
Bayi ilişkisini kaldır |
create_canvas |
62 şablondan biriyle (anahtarlar list_canvases'ta; kayıt şablonları: paydaş haritası, organizasyon şeması, hesap planı — firma; fırsat planı — fırsat; diğerleri ör. kanban, müşteri yolculuğu, zihin haritası, yol haritası (zaman çizelgesi), OKR takipçisi (akıllı tablo), SWOT, retro, akış şeması, slaytlar), Mermaid akış şemasından (kendiliğinden yerleşir) ya da öğelerden (not, şekil, çizgi, kalem, tablo, akıllı tablo — tipli sütunlar ve gruplar, zaman çizelgesi, emoji, kart, bağlantı; st alanıyla yazı tipi, boyut, renk, dolgu, kenarlık) tuval açar. Kayıt şablonları kişileri, fırsatları, riskleri ve sonraki adımları CRM'den doldurur. | access (edit · read · private), elements, mermaid, name, record_id, record_type (customer · opp), template (blank · stakeholders · orgchart · account_plan · deal_plan · swot · retro · pipeline) |
Kuzey Plastik için hesap planı tuvali aç |
update_canvas |
Tuvali fark olarak değiştirir: öğe ekle (tablo, akıllı tablo, zaman çizelgesi, çizgi, kalem, emoji dahil; st ile stil), kimlikle güncelle (yalnız verilen alanlar), sil (bağlantıları da gider) ve / veya mevcut içeriğin yanına Mermaid akış şeması ekle. | add, canvas_id*, delete, mermaid, update |
Hesap planına 'Riskler' çerçevesine üç yapışkan not ekle |
create_offer |
Fırsat için kalemli teklif açar; birincil teklif olur ve fırsatın fiyat, miktar ve yıllık değerini (miktar × fiyat × 12) günceller. Sınırı aşan iskonto ya da taban fiyat altı yönetici onayı bekler ('review'). Toplamlar, onay nedenleri ve PDF bağlantısıyla döner. | currency, lines, note, opportunity_id, payment_days, terms, valid_until |
Streç film fırsatına 1.000 kg film (2,40 €) ve 50 kg etiket kalemli teklif hazırla |
update_offer_status |
Onay bekleyen teklifi onaylar / reddeder (yönetici), müşteriye sunuldu yapar ya da birincil yapar (fırsatı bu teklif besler). Reddedilen değişiklik nedeniyle döner. | action (approve · deny · mark_presented · make_primary), note, offer_id |
TKL-2026-0044'ü onayla |
create_order |
Sipariş açar: kabul edilen tekliften (offer_id — fırsat kazanılmış olmalı; her kalem bir sipariş) ya da doğrudan (company_id + ürün + miktar). customer_po = müşterinin satınalma sipariş numarası. Çalışma alanı siparişleri ERP'ye kendiliğinden gönderiyorsa yeni sipariş oraya gider (faturayı ERP keser). | company_id, currency, customer_po, due_date, kind (İlk Sipariş · Yeni Sipariş · Geri Kazanım), offer_id, product, product_id, quantity, unit_price |
Kabul edilen tekliften PO 4500123 ile sipariş oluştur |
create_ticket |
Firma için (ya da CRM'de olmayan kişi / firma adıyla) destek talebi açar. Çalışma alanının talep şablonu SLA hedefini, varsayılan görevliyi ve ilk görevleri belirler; görevliye bildirim gider. | assigned_to, category (Ürün kalitesi · Uygulama / proses · Teslimat / lojistik · Ambalaj / etiket · Doküman (TDS / SDS / CoA) · Fatura / ödeme · Diğer), company_id, company_name, contact_id, contact_name, detail, kind (Şikâyet · Teknik destek · Soru / bilgi · Numune / deneme · İade · Öneri), lot_no, opportunity_id, order_id, priority (Düşük · Normal · Yüksek · Acil), product, source (Telefon · E-posta · Ziyaret · WhatsApp · Web · Mobil), subject* |
Kuzey Plastik için 'film yırtılıyor' şikâyeti aç, öncelik yüksek, lot L-2291 |
update_ticket |
Talebin durumunu (çözüldü için çözüm metni gerekir), önceliğini (SLA hedefi yenilenir), görevlisini değiştirir ve / veya yorum ekler (iç not ya da müşteriye yanıt — yanıt ilk yanıt sayılır). | assigned_to, comment, comment_type (note · reply), priority (Düşük · Normal · Yüksek · Acil), resolution, status (new · in_progress · on_hold · resolved · closed), ticket_id* |
Yırtılma şikâyetini çözüldü yap: sarım gerginliği ayarlandı |
run_workflow |
Elle çalıştırılan iş akışını (list_automations: manual=true) en çok 200 fırsat ya da firmada çalıştırır; adımlar hemen yürür (görev, bildirim, alan güncelleme, uygulama / HTTP çağrısı). Koşula uymayan ya da düzenleyemediğiniz kayıtlar atlanır. | record_ids, record_type (opp · customer), workflow_id* |
'Kazanılan fırsatı devret' akışını bu üç fırsatta çalıştır |
send_sms |
Kişiye ya da firma telefonuna, çalışma alanının SMS sağlayıcısından tek SMS. kind=info (varsayılan; sipariş, sevkiyat, randevu, ödeme — kampanya içermez) ya da tacir (şirketin kurumsal hattına ticari ileti; kimlik ve ret satırı eklenir; yalnız İYS süzgeçli sağlayıcıda). Ret listesindeki numaraya ve kampanya içeren bilgilendirme metnine gönderilmez. SMS firmanın zaman tünelinde not olarak görünür. Göndermeden önce kullanıcıdan onay alın. | company_id, contact_id, kind (info · tacir), phone, text* |
Can Bey'e numunenin yarın kargoda olduğunu SMS'le bildir |
update_contact |
Kişiyi günceller (yalnız verilen alanlar). Ayrılan kişi için silmek yerine is_former=true. | contact_id*, department, email, is_former, is_main, name, note, phone, title |
Merve Ak'ın unvanını satın alma uzmanı yap |
update_opportunity |
Fırsat alanlarını günceller: ad, tür, ürün hattı, aylık miktar, birim fiyat, vade, kapanış ve sonraki adım tarihi, not, öngörü kategorisi. Aşama change_opportunity_stage ile. | close_date, forecast_cat (Pipeline · Best Case · Commit · Omitted), line, name, next_step_date, note, offer_price, opportunity_id*, payment_days, potential_kg, product_id, type |
Streç film fırsatının kapanışını 15 Aralık yap |
update_task |
Görevi değiştirir: başlık, ayrıntı, tarih / saat, öncelik, durum, görevli. | assigned_to, detail, done_on, due_date, due_time, priority (Düşük · Normal · Yüksek · Acil), status (Açık · Devam Ediyor · Tamamlandı), task_id*, title |
Fiyat listesi görevini Ozan'a ata, yarına al |
postpone_action |
Açık aksiyonu gün sayısıyla ya da bir tarihe öteler; neden geçmişte kalır. | date, days, id, kind (visit · demo · task · step), note |
Numune takibini bir hafta ertele: müşteri izinde |
update_note |
Yazdığım notun metnini (ve başlığını) değiştirir; yönetici her notu. | body, note_id, title |
Son notumu 'numune pazartesi gidiyor' diye düzelt |
create_email_template |
Yeni e-posta şablonu kaydeder; değişkenler {firma}, {kişi_ad}, {fırsat}, {ben_ad} …, yedekli {kişi_ad|Merhaba}. | body, name, shared, subject |
Numune takibi için ortak bir şablon oluştur |
update_email_template |
Şablonumu (yönetici: her şablonu) değiştirir; yalnız verilen alanlar. | body, name, shared, subject, template_id* |
Teklif takip şablonunun konusunu kısalt |
create_email_draft |
E-postayı TASLAK olarak kaydeder — asla göndermez; kullanıcı E-postalar › Taslaklar'dan kontrol edip gönderir. Konu + gövde ya da şablon; yazışmaya yanıt da olabilir. | bcc, body, cc, company_id, contact_id, in_reply_to_email_id, opportunity_id, subject, template_id, to |
Merve Ak'a teklif takibi için taslak hazırla |
update_email_draft |
Gönderilmemiş taslağımı değiştirir; göndermez. | bcc, body, cc, draft_id*, subject, to |
Taslağa teslim tarihini ekle |
mark_notifications_read |
Verilen bildirimleri ya da okunmamışların hepsini okundu yapar. | ids |
Bildirimlerimin hepsini okundu yap |
create_object_record |
Özel nesne kaydı açar; isteğe bağlı firmaya bağlı, alan değerleriyle. | company_id, fields, links, name, object_key |
Kuzey Plastik'e 4 numaralı hattı ekle |
update_object_record |
Özel nesne kaydının adını, sorumlusunu, durumunu, alanlarını ya da bağlantılarını değiştirir. | active, fields, links, name, object_key, owner_id, record_id |
3 numaralı hattın kapasitesini 1.200 kg yap |
create_workflow |
İş akışını KAPALI taslak olarak açar (yönetici) — hazır şablondan ya da düz anlatımdan; kullanıcı web'de inceleyip açar. | description, name, template (contract_service · cross_sell · deal_nudge · email_followup · health_check · install_anniv · lead_triage · lost_retry) |
7 gündür bekleyen teklif için sorumluya arama görevi açan bir akış taslağı hazırla |
create_calendar_event |
Takvimime etkinlik ekler, isteğe bağlı firmaya bağlı. | all_day, company_id, company_name, end, location, note, start, title |
Perşembe 14:00'e Kuzey Plastik toplantısı ekle |
fill_ai_field |
Firma, kişi ya da fırsattaki yapay zekâ alanını kaydın kendi verisinden doldurur ve kaydeder. | field_key, record_id, record_type* (customer · contact · opp) |
Kuzey Plastik'in 'segment' alanını doldur |
start_whatsapp_chat |
Numaranın ya da kişinin WhatsApp yazışmasını bulur / açar ve firmaya bağlar; bir şey göndermez (beta). | company_id, contact_id, phone |
Merve Ak'la WhatsApp yazışması aç |
send_whatsapp |
WhatsApp Business'tan ileti gönderir (gerçek gönderim): müşteri son 24 saatte yazdıysa serbest metin, değilse onaylı şablon; pazarlama şablonu yalnız izni olan kişiye (beta). | chat_id*, template, text, variables |
Merve Ak'a teklif hatırlatma şablonunu gönder |
add_to_call_list |
Kişinin ya da firmanın numarasını çalışma alanının çağrı merkezi bağlantısının (Solveline / Mantis ya da kayıt ekleme adresi olan başka bir çağrı merkezi) arama listesine (kampanyasına) ekler; çağrı merkezi numarayı arar — isteğe bağlı belirli bir saatte, temsilcinin dahilisine bağlayarak (randevu). Aranmasın listesindeki numara reddedilir; tekrar ekleme süresi içinde aynı kampanyaya eklenen numara force=true olmadan eklenmez. Firmanın Etkinlik akışında görünür. Eklemeden önce kullanıcıdan onay alın. | at, campaign, company_id, contact_id, force, link_id, note, phone, user_id |
Lale Metal'in satın almacısını yarın 14:30'da beni arayacak şekilde arama listesine ekle |
* zorunlu parametre.
Kalıcı silme araçları
Silme ve birleştirme araçları ayrı bir izindir: Claude bağlanırken onay ekranında Kalıcı silme (isteğe bağlı) kutusu çıkar, varsayılan olarak işaretsizdir. İşaretlemezseniz bağlantı yalnız okur, oluşturur ve günceller; bu araçlar listelenmez, çağrılırsa açıklamalı hata döner. Sonradan açmak için bağlantıyı kaldırıp yeniden kurun ve kutuyu işaretleyin. Kişisel API anahtarlarıyla (sk_…) silme yapılamaz.
Her silme aracı confirm: true ister — yalnız kullanıcı açıkça istediğinde. archive_company firmayı silmez, pasife alır (geçmiş korunur); kalıcı firma silme yalnız web'den, otomatik yedekle yapılır. merge_companies önce yedek alır. delete_opportunity, archive_company ve merge_companies yalnız yöneticiye listelenir. Her çağrı denetim günlüğüne yazılır.
| Araç | Açıklama | Parametreler | Örnek istem |
|---|---|---|---|
delete_task |
Görevi kalıcı siler. Yalnız kullanıcı açıkça isterse, confirm=true ile. | confirm, task_id |
Mükerrer açılan görevi sil |
delete_note |
Yazdığım notu (yönetici: her notu) kalıcı siler; confirm=true. | confirm, note_id |
Yanlış firmaya yazdığım notu sil |
delete_contact |
Kişiyi kalıcı siler; ayrılan kişi için update_contact is_former=true önerilir; confirm=true. | confirm, contact_id |
Mükerrer Merve Ak kaydını sil |
delete_opportunity |
Fırsatı ve aşama geçmişini kalıcı siler (yönetici). Kaybedildi / iptal olarak kapatmak çoğu zaman doğrusudur; confirm=true. | confirm, opportunity_id |
Test için açılan fırsatı sil |
archive_company |
Firmayı pasife alır (yönetici): geçmiş korunur, listelerden ve hatırlatıcılardan çıkar. Kalıcı silme yalnız web'den, otomatik yedekle; confirm=true. | company_id, confirm |
Faaliyetini durduran Kumsal Plastik'i pasife al |
merge_companies |
Mükerrer firmaları birleştirir (yönetici): bağlı her kayıt korunan firmaya geçer, boş alanlar doldurulur, önce yedek alınır; confirm=true. | confirm, duplicate_company_ids, keep_company_id* |
Kuzey Plastik ve Kuzey Plastik A.Ş. kayıtlarını birleştir |
delete_object_record |
Özel nesne kaydını kalıcı siler; confirm=true. | confirm, object_key, record_id* |
Sökülen 2 numaralı hattı sil |
delete_email_template |
Şablonumu (yönetici: her şablonu) kalıcı siler; bir iş akışı kullanıyorsa reddedilir; confirm=true. | confirm, template_id |
Eski kampanya şablonunu sil |
delete_calendar_event |
Solk'ta eklenen takvim etkinliğini siler (Google / Outlook'tan gelenler silinmez); confirm=true. | confirm, event_id |
Perşembe toplantısını takvimden kaldır |
delete_saved_view |
Kayıtlı görünümümü (yönetici: ortak olanları da) siler; confirm=true. | confirm, view_id |
Eski 'Ekim fırsatları' görünümünü sil |
* zorunlu parametre.
Yanıt biçimi
Araçlar sonucu hem metin (content[0].text, JSON) hem yapısal içerik (structuredContent) olarak döndürür. İş kuralı hatalarında (ör. aşama kapısı, benzer firma adı) isError: true ve nedeni açıklayan metin gelir; asistan bunu kullanıcıya aktarır ya da düzeltip yeniden dener.
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"content": [{ "type": "text", "text": "{\"counts\": {\"overdue\": 8, \"soon\": 0, \"today\": 0}, \"rows\": [ … ]}" }],
"structuredContent": { "counts": { "overdue": 8, "soon": 0, "today": 0 }, "rows": [ "…" ] },
"isError": false
}
}