Personel Yanıt Kancaları

1.7k görüntülenme Markdown

Personel yanıtları, iç notlar ve atamanın dokuz kancası.

Genel Bakış

Personelin bir talebe dokunduğu her nokta burada: yanıt yazmak, düzenlemek, silmek, iç not eklemek ve atama yapmak.

Yanıt kancaları üçtür ve karıştırılmamalıdır: personelin yazdığı, müşterinin yazdığı ve zamanlanmış görevin yazdığı. Sonuncusu parametrelerini tek dizide taşır.

İçerikten ayrı bir soru daha var: mesaja kimin adı gidecek. Yazar kancası bunu yazma anından önce belirler.

Referans

Yazar adını ve imzayı değiştirme

filterticket.reply_author
AdminTickets değerler referansla önizlemede de çalışır

Personel mesajının müşteriye görünen yazar adını ve mesaja eklenecek imzayı, mesaj yazılmadan önce değiştirir.

Parametreler 3
&$namestringYanıtta görünecek ad. Yalnız ad değişir: gerçek personel kaydı yerinde kalır ve avatar da o hesaptan okunur. Ad ile hesap ayrıştığında personel akışında başka birinin fotoğrafı görünür.
&$signaturestringMesajın sonuna eklenecek imza; düz metin verirsiniz, kaçışı çekirdek yapar. Boş bırakırsanız hiçbir imza eklenmez.
$ctxarrayBağlam; değiştirilemez. Anahtarları: ticket_id (talep açma formunda henüz sıfır), lang (talebin açıldığı dil), user_id (talebin sahibi; misafir talebinde sıfır), staff_id, source, explicit_name, ai. source beş değer alır. Yazma yolları: panel, panel-create, api. Önizleme yolları: panel-form, panel-create-form.
Dönüş 1
voidDönüş yoksayılır; iki değeri de yerinde değiştirirsiniz. explicit_name doğruysa çağıran yazarı bilerek seçmiştir; ada dokunmayın.
Dinleyici 
Hook::add('filter:ticket.reply_author', 10, function (&$name, &$signature, $ctx) {
    // Cagiran adi kendi verdiyse ona dokunmayin: API author_name, yapay zeka personasi.
    if (!empty($ctx['explicit_name'])) return;

    // Onizleme yollari sayfa her acildiginda calisir: burada yan etki uretmeyin.
    $agent = Acme::pickAgent((int) ($ctx['ticket_id'] ?? 0), (string) ($ctx['lang'] ?? ''));
    if (!$agent) return;

    $name      = $agent['name'];
    $signature = $agent['signature'];
});

Personel yanıtını durdurma

gateticket.reply
AdminTickets imza eklenmiş

Personel yanıtı gönderilmeden önce çalışır.

Parametreler 3
$ticketarrayYanıtlanan talep.
$messagestringGönderilecek nihai metin. İşaretleme içerir ve imza çoktan eklenmiştir: uzunluk ölçüyorsanız bunu hesaba katın.
$admin_idintYanıtı yazan personel.
Dönüş 1
string|nullBoş olmayan bir metin işlemi engeller ve hata olarak gösterilir. Boş dönüş devam ettirir.
Dinleyici 
Hook::add('gate:ticket.reply', 10, function ($ticket, $message, $admin_id) {
    // Imza coktan eklendi: uzunluk olcerken hesaba katin.
    if (Acme::containsSecret($message)) return 'Yanitta paylasilmamasi gereken bir deger var.';

    return null;
});

Personel yanıtını izleme

actionticket.reply_added
AdminTickets hidratlı yanıt

Personel yanıtı eklendikten sonra çalışır.

Parametreler 3
$ticketarrayYanıt sonrası taze talep.
$reply_idintEklenen yanıtın kimliği.
$replyarrayYanıtın tamamı: metni, yazarı, ekleri ve adresi.
Dönüş 1
voidDönüş yoksayılır.
Dinleyici 
Hook::add('action:ticket.reply_added', 10, function ($ticket, $reply_id, $reply) {
    Acme::stopSlaClock((int) ($ticket['id'] ?? 0));
});

Otomatik yanıtı izleme

actionticket.replied
cronjobs tek bağlam dizisi

Zamanlanmış görev bir talebe yanıt eklediğinde çalışır. Kardeşlerinin aksine parametreleri tek bir dizide gelir.

Parametreler 1
$contextarrayHer şey burada: kaynağı, güncel talep ve eklenen yanıt. Ayrı parametre beklemeyin; bu kanca tek dizi taşır.
Dönüş 1
voidDönüş yoksayılır.
Dinleyici 
Hook::add('action:ticket.replied', 10, function ($context) {
    // Tek dizi: kardeslerinden farkli.
    $ticket = $context['request'] ?? [];
    Acme::noteAutoReply((int) ($ticket['id'] ?? 0));
});

Yanıt düzenlemesini izleme

actionticket.reply_updated
AdminTickets düzenleme sonrası

Bir yanıt düzenlendikten sonra çalışır.

Parametreler 3
$ticketIdintTalebin kimliği.
$replyIdintDüzenlenen yanıtın kimliği.
$replyarrayGüncellenmiş yanıt. Önceki hâli geçilmez: değişikliği karşılaştırmak istiyorsanız kendi kopyanızı tutmuş olmanız gerekir.
Dönüş 1
voidDönüş yoksayılır.
Dinleyici 
Hook::add('action:ticket.reply_updated', 10, function ($ticketId, $replyId, $reply) {
    // Onceki hali gecilmez.
    Acme::reindexReply($replyId, $reply['message'] ?? '');
});

Yanıt silinmesini izleme

actionticket.reply_deleted
AdminTickets silme sonrası

Bir yanıt silindikten sonra çalışır.

Parametreler 3
$ticketIdintTalebin kimliği.
$replyIdintSilinen yanıtın kimliği.
$replyarraySilinen yanıtın kaydı: sahibi ve personel olup olmadığı.
Dönüş 1
voidDönüş yoksayılır.
Dinleyici 
Hook::add('action:ticket.reply_deleted', 10, function ($ticketId, $replyId, $reply) {
    Acme::dropFromIndex('reply', $replyId);
});

İç not eklemeyi durdurma

gateticket.note_add
AdminTickets müşteri görmez

Personel iç not eklemeden önce çalışır. Notlar müşteriye görünmez.

Parametreler 3
$ticketarrayNotun ekleneceği talep.
$messagestringNot içeriği.
$admin_idintNotu ekleyen personel.
Dönüş 1
string|nullBoş olmayan bir metin işlemi engeller ve hata olarak gösterilir. Boş dönüş devam ettirir.
Dinleyici 
Hook::add('gate:ticket.note_add', 10, function ($ticket, $message, $admin_id) {
    if (Acme::tooLong($message)) return 'Not cok uzun.';

    return null;
});

İç not eklenmesini izleme

actionticket.note_added
AdminTickets not boş gelebilir

İç not eklendikten sonra çalışır.

Parametreler 3
$ticketarrayNotun eklendiği talep.
$admin_idintNotu ekleyen personel.
$notearrayNotun verisi: metni, sabitlenmiş olup olmadığı ve ekleri. ? Boş gelebilir: not okunamadıysa bu değer yoktur. Erişmeden önce sınayın.
Dönüş 1
voidDönüş yoksayılır.
Dinleyici 
Hook::add('action:ticket.note_added', 10, function ($ticket, $admin_id, $note) {
    // Not BOS gelebilir.
    if (!$note) return;

    Acme::mirrorNote((int) ($ticket['id'] ?? 0), $note['message'] ?? '');
});

Atamayı izleme

actionticket.assigned
AdminTickets sıfır = atama yok

Bir talep personele atandığında ya da ataması kaldırıldığında çalışır.

Parametreler 3
$ticketarrayAtama öncesi talep verisi.
$old_assigned_idintÖnceki atanan; sıfır ise atanmamıştı.
$new_assigned_idintYeni atanan; sıfır ise atama kaldırılmıştır.
Dönüş 1
voidDönüş yoksayılır.
Dinleyici 
Hook::add('action:ticket.assigned', 10,
    function ($ticket, $old_assigned_id, $new_assigned_id) {
        // Sifir = atama kaldirildi.
        if (!$new_assigned_id) { Acme::backToPool((int) ($ticket['id'] ?? 0)); return; }

        Acme::notifyAgent($new_assigned_id, (int) ($ticket['id'] ?? 0));
    });

Tuzaklar

Yazar kancası önizlemede de çalışır

Yanıt formundaki imza kutusu değerini bu kancadan alır, yazma anında kanca yeniden çalışır. İki sonucu var: dinleyiciniz sayfa her açıldığında da çalıştığı için orada sayaç artırmamalı ya da kayıt yazmamalıdır; ve imzayı koşulsuz belirliyorsanız kutu bir önizlemedir, bir girdi değil. Operatörün kutuda yaptığı elle düzenleme yazma anında ezilir.

Not verisi boş gelebilir

İç not kancasının üçüncü parametresi, not okunamadığında boştur. İçine doğrudan erişen bir dinleyici o durumda hata üretir; ilk satırda sınayın.

Otomatik yanıt kancası tek dizi taşır

Kardeşleri talebi, yanıt kimliğini ve yanıtı ayrı parametreler olarak verir; zamanlanmış görevin yanıtı ise hepsini tek bir bağlam dizisinde taşır. Aynı imzayı bekleyen bir dinleyici burada boş değerlerle çalışır.

Faydalı oldu mu?

Geri bildiriminiz için teşekkürler!

Hâlâ Yardıma mı İhtiyacınız Var?

Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.

Bize Ulaşın Destek Talebi Oluştur

Oturumunuzu açık tutmak, dil ve para birimi tercihinizi hatırlamak ve siteyi geliştirmek için çerez kullanıyoruz. Çerez Politikası