Bir eklenti, masaüstü uygulaması veya web sitesi gibi kendi uygulamalarınız, kullanıcıları için talep açabilir ve uygulamanın ya da sunucunun sürümü gibi teknik ayrıntıları da gönderebilir. Her uygulamanın kendi anahtarı vardır. Bir anahtarı iptal ettiğinizde o uygulama anında durur.
Nerede bulunur: Kurulum → Destek → Uygulama anahtarları (yalnızca yöneticiler).
Uygulama anahtarı oluşturma
- Kurulum → Destek → Uygulama anahtarları'nı açın.
- Uygulama adını girin, örneğin
WordPress plugin. Personel bu adı, uygulamanın açtığı taleplerin kanalı olarak görür. - İstek ürün belirtmediğinde kullanılacak ürün'ü veya İstek ürünü belirtmelidir seçeneğini seçin.
- Anahtar oluştur'a tıklayın.
- Anahtarı şimdi kopyalayın ve uygulamanın ayarlarında saklayın. Anahtar yalnızca bu seferlik gösterilir; Ticketix yalnızca anahtarın bir özetini (hash) saklar.
Liste her uygulamayı anahtarının başlangıcı, ürünü, talep sayısı, Son kullanım zamanı ve oluşturulma tarihiyle gösterir. İptal et bir anahtarı anında durdurur; uygulamanın açtığı talepler uygulamanın adını korur.
Talep açma
Kurulumunuzun adresi altındaki /api/ticket-create.php adresine JSON gövdeli bir POST isteği gönderin, örneğin https://support.example.com/api/ticket-create.php. Anahtarı Authorization: Bearer başlığında gönderin; sunucunuz Authorization başlığını kaldırıyorsa X-Ticketix-Key başlığını kullanın.
POST /api/ticket-create.php
Authorization: Bearer tkx_…
Content-Type: application/json
{
"email": "customer@example.com",
"name": "Customer Name",
"product": "helpdesk",
"subject": "Licence shows Inactive after moving the site",
"message": "We moved the site to a new domain …",
"priority": "normal",
"technical_details": {
"WordPress": "6.8",
"PHP": "8.3",
"Plugin version": "2.0.2"
}
}
| Alan | Zorunlu | Anlamı |
|---|---|---|
| Evet | Müşterinin e-posta adresi; bilinmeyen bir adres için yeni bir müşteri oluşturulur | |
| name | Hayır | Müşterinin adı, en fazla 120 karakter |
| product | Hayır | Bir ürün anahtarı; belirtilmezse anahtarın ürünü kullanılır |
| subject | Evet | En fazla 200 karakter |
| message | Evet | Düz metin, en fazla 20.000 karakter |
| priority | Hayır | low, normal (varsayılan) veya high |
| technical_details | Hayır | En fazla 30 ad ve değer; ad en fazla 60, değer en fazla 500 karakter; değerler metin, sayı veya true ve false olabilir |
İstek gövdesi en fazla 64 KB olabilir.
Talebe ne olur
- Talep anında açılır; anahtar isteğin güvenilirliğini doğruladığı için e-posta doğrulaması yapılmaz.
- Müşteri, talep bağlantısını içeren olağan Talep oluşturuldu e-postasını alır; personel de olağan bildirimleri alır.
- Yönlendirme kuralları, iş akışları, SLA politikaları ve yapay zekâ ön değerlendirmesi her yeni talepte olduğu gibi çalışır.
- Talep ekranı, kanal olarak uygulamanın adını "teknik ayrıntılarla" ifadesiyle birlikte, teknik ayrıntıları da ilk mesajın altında ("Gönderen" ve uygulama adı) gösterir. Müşteri de kendi talebinde aynı ayrıntıları görür.
Yanıtlar
| Durum | Anlamı |
|---|---|
| 201 | Talep açıldı; yanıt ticket_no ve status içerir |
| 401 | Anahtar eksik, yanlış veya iptal edilmiş |
| 405 | İstek bir POST değil |
| 413 | Gövde 64 KB'tan büyük |
| 415 | Gövde JSON değil (Content-Type: application/json) |
| 422 | Bir alan hatalı; fields her alanı nedeniyle birlikte belirtir |
| 429 | Çok fazla talep: uygulama başına saatte 60, müşteri başına saatte 10 |
Nginx kullanıyorsanız sunucunun api klasöründe PHP çalıştırması gerekir; bkz. Ticketix sunucu gereksinimleri.