CRM Yazma Araçları
CRM kaydı, kişi, not, görev ve arama kaydı oluşturma/güncelleme araçları
Bu domain'de CRM'inize yazan 8 araç bulunur: kayıt oluşturma ve güncelleme, kişi (contact) yönetimi, not ekleme, görev yönetimi ve telefon görüşmesi kaydı. Okuma işlemleri için CRM Okuma Araçları sayfasına bakın.
Araçlar
create_crm_record
Manuel bir CRM kaydı oluşturur (lead scraping'den gelmeyen bir işletme). Planın CRM kayıt limitine sayılır.
Önemli parametreler:
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
workspace_id | string (UUID) | Evet | Workspace ID |
business_name | string (1–300) | Evet | İşletme adı |
mails | string dizisi | Evet | En az bir e-posta adresi |
phones | string dizisi | Hayır | Telefon numaraları |
city / state / country | string | Hayır | Konum bilgileri |
tags | string dizisi | Hayır | Etiketler |
AI'a şöyle yazın: "CRM'e 'Yıldız Mobilya' diye yeni bir kayıt aç; e-postası info@yildizmobilya.com, etiketi 'mobilya' olsun."
promote_lead_to_crm
Mevcut bir scrape edilmiş lead'den CRM kaydı oluşturur; e-posta/telefonları taşır ve zenginleştirme kişilerini otomatik içe aktarır. Manuel CRM kotasını tüketmez; lead başına idempotent'tir (tekrar çağrılırsa yeni kayıt açmaz).
Önemli parametreler:
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
workspace_id | string (UUID) | Evet | Workspace ID |
lead_id | string | Evet | Lead satır ID'si (list_leads çıktısından) |
AI'a şöyle yazın: "Ankara scrape'inden e-postası olan tüm diş kliniklerini CRM'e taşı."
update_crm_record
CRM kaydı için birleşik güncelleyici: pipeline aşaması, etiketler (değiştir/ekle/çıkar), sıcaklık, opt-out, e-posta/telefonlar, sonraki eylem ve soft delete/geri alma. Yalnızca gönderilen alanlar değişir. Pipeline aşaması değişikliği sahiplik veya can_manage_tasks izni gerektirir.
Önemli parametreler:
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
workspace_id | string (UUID) | Evet | Workspace ID |
crm_id | number | Evet | CRM kayıt ID'si |
tracking_status | enum | Hayır | new, contacted, qualified, proposal, negotiation, closed_won, closed_lost |
tags_set | string dizisi | Hayır | Tüm etiketleri değiştirir |
tags_add / tags_remove | string dizisi | Hayır | Etiket ekler / çıkarır |
temperature | cold / warm / hot | Hayır | Lead sıcaklığı |
opted_out | boolean | Hayır | Opt-out işareti |
mails / phones | string dizisi | Hayır | E-posta / telefon listeleri |
next_action_at | string (tarih-saat) | Hayır | Sonraki eylem zamanı |
next_action_type | enum | Hayır | call, email, meeting, follow_up |
last_contact_at | string (tarih-saat) | Hayır | Son temas zamanı |
deleted | boolean | Hayır | true = soft delete, false = geri al |
AI'a şöyle yazın: "Yıldız Mobilya'yı 'pazarlık' aşamasına al, sıcaklığını hot yap ve 'öncelikli' etiketini ekle."
add_crm_contact
Bir CRM kaydının altına kişi düzeyinde iletişim ekler (kaynak: manuel).
Önemli parametreler:
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
workspace_id | string (UUID) | Evet | Workspace ID |
crm_id | number | Evet | CRM kayıt ID'si |
full_name | string (1–200) | Evet | Kişinin tam adı |
email | string (e-posta) | Hayır | E-posta adresi |
mobile_number | string | Hayır | Cep telefonu |
job_title | string | Hayır | Unvan |
company_name | string | Hayır | Şirket adı |
linkedin_url | string (URL) | Hayır | LinkedIn profili |
city / country | string | Hayır | Konum |
tags | string dizisi | Hayır | Etiketler |
opted_out | boolean | Hayır | Opt-out işareti |
AI'a şöyle yazın: "Yıldız Mobilya kaydına satın alma müdürü Mehmet Kaya'yı ekle; e-postası mehmet@yildizmobilya.com."
update_crm_contact
Mevcut bir kişinin alanlarını günceller. Yalnızca gönderilen alanlar değişir.
Önemli parametreler:
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
workspace_id | string (UUID) | Evet | Workspace ID |
contact_id | string (UUID) | Evet | Kişi ID'si |
| Diğer alanlar | — | Hayır | add_crm_contact ile aynı opsiyonel alanlar (full_name, email, job_title vb.) |
AI'a şöyle yazın: "Mehmet Kaya'nın unvanını 'Genel Müdür' olarak güncelle."
add_crm_note
Bir CRM kaydına not ekler; istenirse sabitlenir.
Önemli parametreler:
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
workspace_id | string (UUID) | Evet | Workspace ID |
crm_id | number | Evet | CRM kayıt ID'si |
content | string (1–10.000) | Evet | Not içeriği |
is_pinned | boolean | Hayır | Notu sabitle (varsayılan false) |
AI'a şöyle yazın: "Yıldız Mobilya'ya 'Fiyat teklifi gönderildi, cevap bekleniyor' notunu ekle ve sabitle."
manage_crm_task
Görev oluşturur, günceller, tamamlar veya iptal eder. action=create için title zorunludur; update, complete ve cancel için task_id gerekir. Üyeler yalnızca kendi oluşturdukları veya kendilerine atanmış görevleri değiştirebilir (can_manage_tasks izni yoksa).
Önemli parametreler:
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
workspace_id | string (UUID) | Evet | Workspace ID |
action | enum | Evet | create, update, complete, cancel |
task_id | string (UUID) | Duruma göre | update/complete/cancel için zorunlu |
crm_id | number | Hayır | Görevi bir CRM kaydına bağlar (yalnızca create) |
title | string (1–300) | Duruma göre | create için zorunlu |
description | string (≤5000) | Hayır | Görev açıklaması |
priority | enum | Hayır | low, medium, high |
due_date | string (tarih-saat) | Hayır | Son tarih |
assigned_to | string | Hayır | Atanan kişinin kullanıcı ID'si |
AI'a şöyle yazın: "Yıldız Mobilya için 'Cuma günü teklifi takip et' başlıklı yüksek öncelikli bir görev oluştur."
log_crm_call
Bir CRM kaydına telefon görüşmesi işler: tür, sonuç, süre ve notlar.
Önemli parametreler:
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
workspace_id | string (UUID) | Evet | Workspace ID |
crm_id | number | Evet | CRM kayıt ID'si |
call_type | enum | Hayır | outgoing, incoming, missed (varsayılan outgoing) |
outcome | enum | Evet | answered, no_answer, busy, voicemail, callback_scheduled |
duration_seconds | number | Hayır | Görüşme süresi (saniye) |
notes | string (≤5000) | Hayır | Görüşme notları |
callback_scheduled_at | string (tarih-saat) | Hayır | Planlanan geri arama zamanı |
called_at | string (tarih-saat) | Hayır | Görüşme zamanı (varsayılan: şimdi) |
AI'a şöyle yazın: "Yıldız Mobilya'yı aradım, cevap verdiler, 12 dakika sürdü; 'fiyatta anlaşıldı' notuyla kaydet."