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.

POST/api/v1/quick

Yetkilendirme

Authorizationheaderzorunlu

Bearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).

Modül: Ziyaretler / AktivitelerKapsam: crm.write

Gövde application/json

customerstringzorunlu

Firma adı (tam ya da yakın).

visit_typestringisteğe bağlı

F2F yüz yüze, Call telefon, Deneme deneme ziyareti.

DeğerlerF2FCallDeneme

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

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

confirm_newbooleanisteğe bağlı

Benzer adlar olsa da yeni firma aç.

Hatalar

HTTP	error	Anlamı
`400`	`invalid`	Eksik ya da geçersiz alan (`message` ayrıntıyı 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-05"
}'

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-05"
  }),
});
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-05"
    },
)
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-02",
    "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-01",
    "open_opps": 1,
    "owner": {
      "full_name": "Deniz Aksoy",
      "id": 1,
      "role": "admin",
      "role_label": "Yönetici",
      "username": "admin"
    },
    "pending_state": "soon",
    "period": 30,
    "phone": "+90 224 555 01 02",
    "potential_kg": null,
    "rid": "001QJi5Zr1Hk2VH",
    "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-16",
    "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-02",
    "lifetime_left": 180,
    "line": "",
    "name": "Streç film tedariki",
    "next_step": "F2F ziyaret planla ve gerçekleştir",
    "offer_price": 2.35,
    "owner": {
      "full_name": "Deniz Aksoy",
      "id": 1,
      "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": "006BMHmVNZ9nFLS",
    "sla_days": 60,
    "sla_left": 60,
    "source": "",
    "stage": "Viable",
    "stage_label": "Viable",
    "start_date": "2026-10-02",
    "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-05",
    "action_done": false,
    "action_state": "soon",
    "contact": "Emre Yıldız",
    "customer": "Kuzey Plastik Sanayi",
    "customer_id": 31,
    "date": "2026-10-02",
    "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": "00UEIXukSoU4vCq",
    "topic": "Görüşme",
    "type": "Call",
    "user": "Deniz Aksoy"
  },
  "warnings": []
}

Örnek yanıt örnek veriyle çalışan bir v22 kurulumundan alındı; listeler en çok iki öğeyle kısaltıldı.