Talep Referans Listeleri
Talep yazarken geçerli değerleri veren dört liste ve bir istatistik ucu.
Genel Bakış
Bu beş uç veri değiştirmez; talep yazarken hangi değerlerin geçerli olduğunu söyler. Departman, personel, öncelik ve durum listeleri, talep oluşturma ve güncelleme uçlarının kabul ettiği değerleri buradan alır.
Dördü de kuruluma göre değişir. Departmanlar operatörün kurduğu kadardır, öncelik etiketleri dil dosyasından gelir ve durumlara kurulumun kendi durumları eklenebilir. Bu yüzden hiçbirini koda gömmeyin; başka bir kuruluma taşındığında liste tutmaz.
Beşincisi bir özet: seçtiğiniz dönem için açık ve çözülmüş talep sayıları, ortalama yanıt ve çözüm süreleri ile memnuniyet puanı.
Referans
Departmanları Listeleme
Talebin gönderilebileceği departmanları döndürür.
curl 'https://panel.ornek.com/api/v1/admin/tickets/departments' \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://panel.ornek.com/api/v1/admin/tickets/departments', {
headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();$ch = curl_init('https://panel.ornek.com/api/v1/admin/tickets/departments');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $apiKey],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);// Adlar KURULUMUN dilinde gelir; kendi ekraniniza cevirmeyi beklemeyin.
$departments = Api::Tickets()->GetTicketDepartments()['data'];Atanabilir Personeli Listeleme
Talebe atanabilecek personeli döndürür.
curl 'https://panel.ornek.com/api/v1/admin/tickets/assignable-staff' \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://panel.ornek.com/api/v1/admin/tickets/assignable-staff', {
headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();$ch = curl_init('https://panel.ornek.com/api/v1/admin/tickets/assignable-staff');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $apiKey],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);// Liste TUM yoneticiler degildir: yalniz bir departmana gorevli yazilmis kisiler doner.
$staff = Api::Tickets()->GetTicketAssignableStaff()['data'];Öncelikleri Listeleme
Talebe verilebilecek öncelikleri döndürür.
curl 'https://panel.ornek.com/api/v1/admin/tickets/priorities' \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://panel.ornek.com/api/v1/admin/tickets/priorities', {
headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();$ch = curl_init('https://panel.ornek.com/api/v1/admin/tickets/priorities');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $apiKey],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);// Etiket dil dosyasindan gelir; sayilari koda gomun, ADLARI degil.
$priorities = Api::Tickets()->GetTicketPriorities()['data'];Durumları Listeleme
Standart durumları ve kuruluma özel durumları birlikte döndürür.
curl 'https://panel.ornek.com/api/v1/admin/tickets/statuses' \
-H "Authorization: Bearer $API_KEY"const res = await fetch('https://panel.ornek.com/api/v1/admin/tickets/statuses', {
headers: { Authorization: `Bearer ${apiKey}` },
});
const { data } = await res.json();
const standard = data.filter((s) => s.type === 'standard');$ch = curl_init('https://panel.ornek.com/api/v1/admin/tickets/statuses');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $apiKey],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);// Iki ayri alana yazilirlar: standart olan durum alanina, ozel olan kendi alanina.
$all = Api::Tickets()->GetTicketStatuses()['data'];
$custom = array_filter($all, fn ($s) => $s['type'] === 'custom');İstatistikleri Okuma
Seçilen dönem için destek sayılarını ve hız ölçülerini döndürür.
today, yesterday, this_week, last_week, this_month, last_month, last_3_months, last_6_months, this_year, last_year, all_time. Öntanımlı olarak tüm zamanlar.curl 'https://panel.ornek.com/api/v1/admin/tickets/stats?period=this_month' \
-H "Authorization: Bearer $API_KEY"const url = new URL('https://panel.ornek.com/api/v1/admin/tickets/stats');
url.searchParams.set('period', 'this_month');
const res = await fetch(url, {
headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();$ch = curl_init('https://panel.ornek.com/api/v1/admin/tickets/stats?' . http_build_query(['period' => 'this_month']));
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $apiKey],
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);// Sure alanlari OKUNUR METINDIR ('2h 5m'); tabloya yazmadan once kendiniz ayristirin.
$s = Api::Tickets()->GetTicketStats([], ['period' => 'this_month'])['data'];
$rate = $s['resolution_rate'];Tuzaklar
Bu liste bir departmanda görevli yazılmış kişileri döndürür. Panelde oturum açabilen her yönetici burada çıkmaz. Kendi yönetici listenizden bir numara alıp atama yaparsanız çağrı geçersiz personel diyerek düşer; atama değerini daima buradan seçin.
Liste standart durumlarla kuruluma özel durumları birlikte döndürür, ama ikisi ayrı alanlara yazılır: standart olan durum alanına, özel olan kendi numarasıyla özel durum alanına gider. Özel bir durumun anahtarını durum alanına yazmak geçersiz durum hatası verir.
Ortalama yanıt ve çözüm süreleri okunur metin olarak gelir; doğrudan grafik çizemez ya da toplayamazsınız. Sayıya ihtiyacınız varsa kendiniz ayrıştırın. Aynı özette çözüm oranı ve puan sayısı gerçek sayıdır, o ikisi hesaba doğrudan girer.
Departman adları, öncelik etiketleri ve durum adları kurulumun geçerli dilinde gelir; anahtar bir kimlik değil, gösterilecek metindir. Karar verirken adları değil sayısal değerleri ve anahtarları kullanın, yoksa dil değiştiği gün mantığınız sessizce kayar.
Hiç talep olmayan bir dönemde sayılar sıfır, süreler sıfır dakika ve puan ortalaması boş gelir. Bunlar başarı göstergesi değildir: sıfır çözüm süresi hızlı çalıştığınız anlamına gelmez, o dönemde iş olmadığı anlamına gelir. Bir panoya basmadan önce toplam sayıya bakın.
İlgili Makaleler
Geri bildiriminiz için teşekkürler!
Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.