Hızlı Giriş

Nottan öneriler

Görüşme notundan kural tabanlı öneriler (dışarıya çağrı yapılmaz, her pakette çalışır): ürün, fiyat ve vade, miktar (ton → kg), deneme sonucu, sonraki adım ve tarihi, notta geçen kişiler ve kayıtlar. Her öneri bir bloğa (block + fields) ya da sonraki adıma (next) uygulanır.

POST/api/v1/qe/suggest

Yetkilendirme

Authorizationheaderzorunlu

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

Modül: Ziyaretler / AktivitelerKapsam: crm.read

Gövde application/json

notestringzorunlu

Not metni (en çok 4 000 karakter).

customer_idintegeristeğe bağlı

Firma (kişi ve kayıt eşleştirmesi için).

Hatalar

HTTP	error	Anlamı
`403`	`module`	Modül lisansta ya da kullanıcının izinlerinde kapalı.

İstek

curl -X POST https://ornek.solk.app/api/v1/qe/suggest \
  -H "Authorization: Bearer $SOLK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "customer_id": 1,
  "note": "Aylık 15 ton, 1,85 €/kg ve 60 gün vade konuşuldu. Hat 3'\''te deneme olumlu. Perşembe numune göndereceğiz."
}'

const res = await fetch("https://ornek.solk.app/api/v1/qe/suggest", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "customer_id": 1,
    "note": "Aylık 15 ton, 1,85 €/kg ve 60 gün vade konuşuldu. Hat 3'te deneme olumlu. Perşembe numune göndereceğiz."
  }),
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/qe/suggest",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    json={
        "customer_id": 1,
        "note": "Aylık 15 ton, 1,85 €/kg ve 60 gün vade konuşuldu. Hat 3'te deneme olumlu. Perşembe numune göndereceğiz."
    },
)
print(r.json())

Yanıt

{
  "items": [
    {
      "block": "teklif",
      "fields": {
        "offer_price": "1,85"
      },
      "id": "price",
      "kind": "block",
      "label": "Teklif: 1,85 €/kg"
    },
    {
      "block": "teklif",
      "fields": {
        "payment_days": "60"
      },
      "id": "days",
      "kind": "block",
      "label": "Vade: 60 gün"
    }
  ],
  "ok": true
}

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