Görüşmeler
Görüşme kaydet
Hızlı Giriş: bir telefon görüşmesini ya da yüz yüze ziyareti tek istekte kaydeder. Firma adla bulunur (yoksa aday olarak açılır; benzer adlar varsa 409 similar), kişi yoksa eklenir, uygun açık aksiyonlar kapanır, sonraki aksiyon açılır ve proje web formundaki kurallarla ilerler. Yanıttaki parts neyin kaydedildiğini, warnings ve advice dikkat edilecekleri anlatır.
Yetkilendirme
AuthorizationheaderzorunluBearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).
Modül: Ziyaretler / AktivitelerKapsam:
crm.writeGövde application/json
customerstringzorunluFirma adı (tam ya da yakın).
visit_typestringisteğe bağlıF2F yüz yüze, Online online toplantı (v43b), Call telefon, Deneme deneme ziyareti.Değerler
F2FOnlineCallDenemevisit_datestringisteğe bağlıGörüşme günü (YYYY-MM-DD, varsayılan bugün).
contactstringisteğe bağlıGörüşülen kişi (yoksa eklenir).
contact_title / contact_phone / contact_emailstringisteğe bağlıYeni kişinin bilgileri.
topicstringisteğe bağlıKonu — serbest yazı, en çok 40 karakter (öneriler:
/qe/config → topics).notestringisteğe bağlıGörüşme notu.
resultstringisteğe bağlıSonuç.
next_actionstringisteğe bağlıSonraki aksiyon.
action_datestringisteğe bağlıSonraki aksiyon tarihi.
opp_idintegeristeğe bağlıKaydın bağlanacağı proje.
product / competitor / offer_price / payment_days / potential_kgmixedisteğe bağlıProje bilgileri (web formundaki alanlar).
order_kg / order_kindmixedisteğe bağlıSipariş miktarı (ürünün biriminde) ve türü (
İlk Sipariş, Yeni Sipariş); doluysa sipariş açılır.customer_postringisteğe bağlıMüşterinin satınalma sipariş numarası (PO) — açılan siparişe yazılır, ERP'ye siparişle gider (v55; en çok 60 karakter).
confirm_newbooleanisteğe bağlıBenzer adlar olsa da yeni firma aç.
geo_lat / geo_lng / geo_accnumberisteğe bağlıv66: ziyaret konumu (çıkış) — enlem, boylam, doğruluk (m). Yalnız
F2F / Deneme ve bugünün tarihiyle işlenir; açık Konumdayım girişi varsa giriş ondan gelir, süre hesaplanır. geo: {lat, lng, acc} de olur.geo_notestringisteğe bağlıv66: konum bırakılamadıysa neden (
denied, nosignal, elsewhere, other ya da serbest metin) — zorunlu kipte konumsuz kayıt için gerekir.Değerler
deniednosignalelsewhereotherHatalar
| HTTP | error | Anlamı |
|---|---|---|
400 | invalid | Eksik ya da geçersiz alan (`message` ayrıntıyı verir). |
400 | geo_required | v66: yüz yüze ziyaret konumla kaydedilir — `geo_lat` / `geo_lng` ya da `geo_note` (neden) gönderin; `reasons` seçenekleri verir. |
409 | similar | Benzer adlı firmalar var (`similar`); `confirm_new: true` ile yine açılır. |
İstek
curl -X POST https://ornek.solk.app/api/v1/quick \
-H "Authorization: Bearer $SOLK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"customer": "Kuzey Plastik Sanayi",
"visit_type": "Call",
"contact": "Emre Yıldız",
"note": "Deneme sonuçlarını konuştuk; kalınlık 23 mikron uygun.",
"result": "Olumlu",
"next_action": "Teklif gönder",
"action_date": "2026-10-18"
}'const res = await fetch("https://ornek.solk.app/api/v1/quick", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"customer": "Kuzey Plastik Sanayi",
"visit_type": "Call",
"contact": "Emre Yıldız",
"note": "Deneme sonuçlarını konuştuk; kalınlık 23 mikron uygun.",
"result": "Olumlu",
"next_action": "Teklif gönder",
"action_date": "2026-10-18"
}),
});
const data = await res.json();import os, requests
r = requests.post(
"https://ornek.solk.app/api/v1/quick",
headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
json={
"customer": "Kuzey Plastik Sanayi",
"visit_type": "Call",
"contact": "Emre Yıldız",
"note": "Deneme sonuçlarını konuştuk; kalınlık 23 mikron uygun.",
"result": "Olumlu",
"next_action": "Teklif gönder",
"action_date": "2026-10-18"
},
)
print(r.json())Yanıt
{
"advice": null,
"closed": [],
"created": false,
"customer": {
"active": true,
"at_risk": false,
"city": "Bursa",
"currency": "EUR",
"currency_default": "",
"id": 31,
"initials": "KP",
"last_visit": "2026-10-15",
"main_contact": {
"email": "emre.yildiz@kuzeyplastik.com.tr",
"name": "Emre Yıldız",
"phone": "+90 532 555 11 22",
"wa": "905325551122"
},
"name": "Kuzey Plastik Sanayi",
"next_visit_due": "2026-11-14",
"open_opps": 1,
"owner": {
"color": "#5867e8",
"full_name": "Deniz Aksoy",
"id": 1,
"photo": null,
"role": "admin",
"role_label": "Yönetici",
"username": "admin"
},
"pending_state": "soon",
"period": 30,
"phone": "+90 224 555 01 02",
"potential_kg": null,
"rid": "0017AMMvazTfMd5",
"sector": "Plastik",
"status": "AC",
"status_label": "Aktif Müşteri",
"unit": "kg",
"visit_overdue_days": -30,
"visit_state": "ok"
},
"message": "Kuzey Plastik Sanayi kaydedildi: ziyaret, proje #53 Streç film tedariki.",
"next_step": "F2F ziyaret planla ve gerçekleştir",
"ok": true,
"opp": {
"bant": 4,
"base_currency": "EUR",
"close_date": "2026-11-29",
"cur_sym": "€",
"currency": "EUR",
"customer": "Kuzey Plastik Sanayi",
"customer_city": "Bursa",
"customer_id": 31,
"days_in_stage": 0,
"detail_status": "",
"fc": "Best Case",
"health": {
"grade": "success",
"label": "sağlıklı",
"score": 95
},
"health_color": "g",
"health_manual": false,
"health_note": "",
"id": 53,
"initials": "KP",
"is_account": false,
"is_open": true,
"last_update": "2026-10-15",
"lifetime_left": 180,
"line": "",
"name": "Streç film tedariki",
"next_step": "F2F ziyaret planla ve gerçekleştir",
"offer_price": 2.35,
"owner": {
"color": "#5867e8",
"full_name": "Deniz Aksoy",
"id": 1,
"photo": null,
"role": "admin",
"role_label": "Yönetici",
"username": "admin"
},
"payment_days": 60,
"potential_kg": 12000.0,
"prob": 0.25,
"probability": null,
"product": "",
"product_id": null,
"pu": "€/kg",
"rid": "006mdby8Icru9GV",
"sla_days": 60,
"sla_left": 60,
"source": "",
"stage": "Viable",
"stage_label": "Viable",
"start_date": "2026-10-15",
"trend": "",
"trend_label": "Otomatik",
"type": "",
"unit": "kg",
"unit_code": "kg",
"value": 338400.0,
"value_base": 338400.0,
"value_short": "338K"
},
"opp_new": false,
"parts": [
"ziyaret",
"proje #53 Streç film tedariki"
],
"visit": {
"action_date": "2026-10-18",
"action_done": false,
"action_state": "soon",
"contact": "Emre Yıldız",
"customer": "Kuzey Plastik Sanayi",
"customer_id": 31,
"date": "2026-10-15",
"id": 106,
"line": "",
"next_action": "Teklif gönder",
"note": "Deneme sonuçlarını konuştuk; kalınlık 23 mikron uygun.",
"opp": "Streç film tedariki",
"opp_id": 53,
"product": "",
"result": "Olumlu",
"rid": "00UD3EWzPIzHikj",
"topic": "Görüşme",
"type": "Call",
"user": "Deniz Aksoy"
},
"warnings": []
}Örnek yanıt örnek veriyle çalışan bir v98 kurulumundan alındı; listeler en çok iki öğeyle kısaltıldı.