hc
34 uç · /api/crm/v1/hc
İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 34 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.
Makale datatable listesi — arama · beyaz-listeli sıralama · filtre-DSL · yazar ·
AI ajanı durumu · kategori/bölüm yolu.
curl -X GET "https://{slug}.crm.blesyum.app/api/crm/v1/hc/articles" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}Reorder articles
sectionIdcurl -X POST "https://{slug}.crm.blesyum.app/api/crm/v1/hc/manager/sections/<sectionId>/articles/reorder" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}GET /api/crm/v1/hc/public/new-ticket-form — yeni talep formunun alanları (müşteri
etiketiyle, yöneticinin sırasıyla). Kapsam ve süzgeç: hc_new_ticket::form_attributes.
curl -X GET "https://{slug}.crm.blesyum.app/api/crm/v1/hc/public/new-ticket-form" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}GET /api/crm/v1/hc/public/platform-yardimi — Blesyum'un yardım makaleleri tek pakette
(YARDIM-01). Destek kiracısı DEĞİLSE 404: başka kiracının yardım merkezi toplu dökülmez.
curl -X GET "https://{slug}.crm.blesyum.app/api/crm/v1/hc/public/platform-yardimi" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}POST /api/crm/v1/hc/public/tickets — giriş yapmamış ziyaretçinin talebi (misafir talebi).
Kiracının tickets.guest_tickets şalterine bağlıdır (varsayılan KAPALI,
settings::GUEST_TICKETS_KEY) ve HC ana şalterinin arkasındadır (require_hc_open).
Talep yazılan e-postanın kişi kaydına açılır; kayıt yoksa contact_only bir kişi
doğar — gelen e-postayla AYNI kapı (email::transform::resolve_or_create_contact).
Takip bağlantısı (IAM-41 sihirli bağlantı) O ADRESE gider.
Neden güvenli: adresin sahibi olduğunu kanıtlamayan ziyaretçi yalnız talep BIRAKIR;
o kişinin mevcut taleplerini okuyamaz — okumak için gelen kutusuna düşen tek
kullanımlık bağlantı gerekir. Destek adresine mail atmakla aynı güven düzeyi
(From satırı da kanıt değildir). Ad yalnız kayıt ADSIZSA yazılır: ziyaretçi var
olan bir müşterinin adını değiştiremez.
curl -X POST "https://{slug}.crm.blesyum.app/api/crm/v1/hc/public/tickets" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}