Kayıt oluştur


POST https://app.apsilo.com/api/public/v1/records

Kişi için başvuru / fırsat kaydı açar ve kayıt numarası üretir. Kişinin ilk temas kaynağı kayda kopyalanır. record.created webhook olayı gönderilir.

Gerekli kapsam: records:write

Parametreler

Parametre	Yer	Tip	Gereklilik	Açıklama
`Idempotency-Key`	başlık	string	isteğe bağlı	İsteğe özgü benzersiz değer (1–255 yazdırılabilir ASCII; ör. UUID). Aynı anahtar + aynı yol ve gövde 24 saat içinde kaydedilmiş yanıtı döner (`Idempotent-Replayed: true`); farklı gövde veya işlenmekte olan istek `409 IDEMPOTENCY_CONFLICT`. Hata yanıtları saklanmaz.
`X-Request-Id`	başlık	string	isteğe bağlı	İsteğe bağlı istek kimliğiniz (8–100 karakter: harf, rakam, `._:-`); yanıtta aynen döner ve kayıtlara işlenir.

İstek gövdesi

Alan	Tip	Gereklilik	Açıklama
`contactId`	string (uuid)	zorunlu	Kaydın açılacağı kişi
`title`	string	zorunlu
`stageId`	string (uuid)	isteğe bağlı	Verilmezse ilk “devam ediyor” aşaması
`category`	string,null	isteğe bağlı	Konu
`department`	string,null	isteğe bağlı	İlgili birim
`value`	string,null	isteğe bağlı	Tutar (yalnızca satış kalıbında saklanır)
`currency`	`TRY` · `USD` · `EUR` · `GBP`	isteğe bağlı	Varsayılan TRY
`ownerUserId`	string,null (uuid)	isteğe bağlı	Sorumlu kullanıcı
`expectedCloseAt`	string,null (date-time)	isteğe bağlı
`conversationId`	string,null (uuid)	isteğe bağlı	İlgili sohbet (kişiye ait olmalı)
`note`	string,null	isteğe bağlı


{
  "contactId": "0b9e4c1a-6f2d-4a7b-9c3e-000000000010",
  "title": "Sokak lambası arızası",
  "category": "Sokak aydınlatması",
  "department": "Fen İşleri Müdürlüğü",
  "note": "Atatürk Cad. No: 12 önü"
}

Yanıtlar

Durum	Açıklama
`201`	Oluşturulan kayıt
`401`	Kimlik doğrulanamadı. Olası kodlar: `API_KEY_INVALID`, `API_KEY_REVOKED`, `API_KEY_EXPIRED`.
`403`	Erişim reddedildi. Olası kodlar: `FEATURE_NOT_LICENSED`, `API_SCOPE_MISSING`, `IP_NOT_ALLOWED`, `LICENSE_EXPIRED`, `LICENSE_NOT_FOUND`, `FORBIDDEN`.
`404`	Bulunamadı. Olası kodlar: `NOT_FOUND`.
`409`	Çakışma. Olası kodlar: `CONFLICT`, `IDEMPOTENCY_CONFLICT`, `MEDIA_IN_USE`, `SOCIAL_APPROVAL_REQUIRED`, `SOCIAL_POST_NOT_EDITABLE`.
`422`	İşlenemeyen istek. Olası kodlar: `VALIDATION_FAILED`, `MESSAGING_WINDOW_CLOSED`, `CHANNEL_ACCOUNT_MISSING`, `CONTACT_BLOCKED`, `STORAGE_LIMIT_REACHED`, `SOCIAL_POST_INVALID`, `SOCIAL_PLATFORM_UNAVAILABLE`.
`429`	Hız sınırı aşıldı. Olası kodlar: `RATE_LIMITED`.
`500`	Sunucu hatası. Olası kodlar: `INTERNAL`.

Yanıt gövdesi

Alan	Tip	Gereklilik	Açıklama
`data`	Record	zorunlu