Müşteri Hizmet ve Mesaj Kancaları

1.6k görüntülenme Markdown

Hizmet detayı ve toplu mesajın on üç kancası: modül paneli, eklentiler, paket değişimi, kullanım grafiği ve mesaj gönderimi.

Genel Bakış

Müşterinin hizmet detayında gördüğü veri ve toplu mesaj gönderimi burada.

Hizmet filtrelerinin ortak deseni görünürlük işaretidir: bir bölümü gizlemek ile içini boşaltmak farklı sonuçlar verir. Mesaj tarafında ise her şey parça üzerinden hesaplanır; alıcı sayısı ücreti vermez.

Referans

Modül panelini değiştirme

filterclient.service_management_content
ClientServices ham işaretleme

Sunucu modülünün ürettiği panel müşteriye gösterilmeden önce çalışır. Uzak panelin çıktısına dokunmanın tek yeri burasıdır.

Parametreler 2
$contentstringbağlaModülün ürettiği ham işaretleme. ? Bu çıktı uzak sunucudan gelen değerleri taşıyabilir ve kaçışsız gösterilir. İçine dışarıdan bir değer eklerseniz kendiniz temizleyin.
$ctxarrayBağlam: hizmet kaydı ve istenen panel sayfası.
Dönüş 1
voidDönüş yoksayılır; verinin üzerine yazarsınız.
Dinleyici 
Hook::add('filter:client.service_management_content', 10, function (&$content, $ctx) {
    // Cikti KACISSIZ gosterilir.
    if (($ctx['page'] ?? '') !== 'dashboard') return;

    $content .= '<div class="alert alert-info">Acme</div>';
});

Eklenti listelerini değiştirme

filterclient.service_detail.addons
ClientServices iki liste

Hizmet detayındaki eklenti listeleri hazırlandıktan sonra çalışır. İki ayrı liste gelir: sahip olunanlar ve satın alınabilecekler.

Parametreler 3
$addonsOwnedarraybağlaHizmetin sahip olduğu eklentiler; etkin ve bekleyenler birlikte.
$addonsAvailablearraybağlaSatın alınabilecek eklenti teklifleri. Bir eklentiyi tekliflerden çıkarmak satın almayı da engeller: müşteri onu göremez.
$ctxarrayBağlam: hizmet kaydı ve hesap kimliği.
Dönüş 1
voidDönüş yoksayılır; verinin üzerine yazarsınız.
Dinleyici 
Hook::add('filter:client.service_detail.addons', 10,
    function (&$addonsOwned, &$addonsAvailable, $ctx) {
        // Tekliflerden cikarmak satin almayi da engeller.
        $addonsAvailable = array_values(array_filter($addonsAvailable,
            fn ($a) => Acme::offerAllowed($a, $ctx['service'] ?? [])));
    });

Paket değişimi kataloğunu değiştirme

filterclient.service_detail.upgrade_plans
ClientServices görünürlük işareti

Paket yükseltme ve düşürme seçenekleri hazırlandıktan sonra çalışır.

Parametreler 2
$updownarraybağlaPlan kataloğu ve durum işaretleri: görünürlük, plan listesi ve fiyatlar. Görünürlük işaretini kapatmak bölümü tümüyle gizler; plan listesini boşaltmak ise bölümü boş gösterir. İkisi farklı sonuçtur.
$ctxarrayBağlam: hizmet kaydı.
Dönüş 1
voidDönüş yoksayılır; verinin üzerine yazarsınız.
Dinleyici 
Hook::add('filter:client.service_detail.upgrade_plans', 10, function (&$updown, $ctx) {
    // Gizlemek ile bosaltmak farkli sonuclardir.
    if (Acme::locked($ctx['service'] ?? [])) $updown['visible'] = false;
});

Lisans devri bölümünü değiştirme

filterclient.service_detail.license_transfer
ClientServices ücret notu dâhil

Yazılım lisansının devir bölümü hazırlandıktan sonra çalışır.

Parametreler 2
$ltarraybağlaDevir verisi: görünürlüğü, kipi, bekleyen bir devir olup olmadığı, ücreti kimin ödediği ve ücret notu.
$ctxarrayBağlam: hizmet kaydı ve tipi.
Dönüş 1
voidDönüş yoksayılır; verinin üzerine yazarsınız.
Dinleyici 
Hook::add('filter:client.service_detail.license_transfer', 10, function (&$lt, $ctx) {
    // Devredilemeyen lisansta bolumu hic gostermeyin.
    if (Acme::nonTransferable($ctx['service'] ?? [])) $lt['visible'] = false;
});

Hizmet zaman çizelgesini değiştirme

filterclient.service_detail.activity
ClientServices zaman çizelgesi

Hizmetin geçmiş satırları ekrana gitmeden önce çalışır. Kendi olaylarınızı çekirdek geçmişin arasına koymanın yeri.

Parametreler 2
$activityarraybağlaZaman çizelgesi satırları.
$ctxarrayBağlam: hizmetin kimliği.
Dönüş 1
voidDönüş yoksayılır; verinin üzerine yazarsınız.
Dinleyici 
Hook::add('filter:client.service_detail.activity', 10, function (&$activity, $ctx) {
    foreach (Acme::events((int) ($ctx['service_id'] ?? 0)) as $e) $activity[] = $e;
});

Kullanım grafiğini değiştirme

filterclient.service_metric_chart
ClientServices boşluk için null

Metrik kullanım grafiğinin verisi hazırlandıktan sonra çalışır.

Parametreler 2
$chartarraybağlaGrafik verisi: gün etiketleri ve gün başına değerler. ? Veri olmayan günde değer boş gelir, sıfır değil: bunları sıfıra çevirmek grafiğe gerçekte olmayan bir düşüş koyar.
$ctxarrayBağlam: hizmet, metrik anahtarı ve grafiklenen ay.
Dönüş 1
voidDönüş yoksayılır; verinin üzerine yazarsınız.
Dinleyici 
Hook::add('filter:client.service_metric_chart', 10, function (&$chart, $ctx) {
    // Veri olmayan gun BOS gelir: sifira cevirmeyin.
    $chart['acme_limit'] = Acme::planLimit($ctx['metric'] ?? '');
});

Mesaj gönderimini durdurma

gateclient.sms_send
ClientSms gönderimden önce

Müşteri toplu mesaj göndermeden önce çalışır. Ücret hesaplanmış ama henüz tahsil edilmemiştir.

Parametreler 4
$uidintGönderen hesap.
$originstringGönderici kimliği.
$quotearrayGönderim özeti: alıcı sayısı, toplam tutar ve ülkeler.
$sendCtxarrayEk bağlam: liste, grup ve para birimi.
Dönüş 1
string|nullBoş olmayan bir metin işlemi engeller ve müşteriye hata olarak gösterilir. Boş dönüş devam ettirir.
Dinleyici 
Hook::add('gate:client.sms_send', 10, function ($uid, $origin, $quote, $sendCtx) {
    // Ucret hesaplandi ama HENUZ tahsil edilmedi.
    if ((int) ($quote['recipients'] ?? 0) > Acme::dailyCap($uid))
        return 'Gunluk gonderim sinirini asiyorsunuz.';

    return null;
});

Mesaj gönderimini izleme

actionclient.sms_sent
ClientSms faturalanan gerçek

Toplu mesaj gönderildikten sonra çalışır.

Parametreler 4
$uidintGönderen hesap.
$originstringGönderici kimliği.
$quotearrayGönderimin özeti. Bu faturalanan gerçektir: alıcı sayısı, parça sayısı, uzunluk ve kodlama. Mesaj uzunsa parça sayısı alıcı sayısından fazladır; ücret parça üzerinden hesaplanır.
$sentCtxarrayBağlam: para birimi, gönderici kaydı, modül ve toplu gönderim numarası.
Dönüş 1
voidDönüş yoksayılır.
Dinleyici 
Hook::add('action:client.sms_sent', 10, function ($uid, $origin, $quote, $sentCtx) {
    // Ucret PARCA uzerinden hesaplanir, alici sayisi uzerinden degil.
    Acme::recordUsage($uid, (int) ($quote['total_parts'] ?? 0));
});

Gönderici kimliği eklemeyi durdurma

gateclient.sms_sender_add
ClientSms biçim doğrulanmış

Müşteri yeni bir gönderici kimliği eklemeden önce çalışır.

Parametreler 2
$uidintİsteği yapan hesap.
$namestringTalep edilen gönderici adı. Biçimi çoktan doğrulanmıştır: en fazla on bir harf ya da rakam, boşluksuz. Sizin denetiminiz içeriğe bakmalıdır, biçime değil.
Dönüş 1
string|nullBoş olmayan bir metin işlemi engeller ve müşteriye hata olarak gösterilir. Boş dönüş devam ettirir.
Dinleyici 
Hook::add('gate:client.sms_sender_add', 10, function ($uid, $name) {
    // Bicim zaten dogrulandi: icerige bakin.
    if (Acme::reservedBrand($name)) return 'Bu ad kullanilamaz.';

    return null;
});

Gönderici kimliğinin eklenmesini izleme

actionclient.sms_sender_created
ClientSms eklendi, onaylanmadı

Yeni bir gönderici kimliği eklendikten sonra çalışır. Eklenmiş olması kullanılabilir olduğu anlamına gelmez: bazı ülkelerde ayrıca başvuru gerekir.

Parametreler 2
$uidintEkleyen hesap.
$originarrayOluşan kaydın özeti: kimliği ve adı.
Dönüş 1
voidDönüş yoksayılır.
Dinleyici 
Hook::add('action:client.sms_sender_created', 10, function ($uid, $origin) {
    // Eklenmis olmasi kullanilabilir oldugu anlamina gelmez.
    Acme::noteSender($uid, $origin['name'] ?? '');
});

Gönderici başvurusunu izleme

actionclient.sms_sender_requested
ClientSms ülke listesi

Gönderici kimliği için ön kayıt başvurusu yapıldıktan sonra çalışır.

Parametreler 3
$uidintBaşvuran hesap.
$originarrayGönderici kimliğinin özeti.
$codesarrayBaşvurulan ülkelerin kodları. İlk başvuruda birden çok ülke olabilir; yeniden başvuruda genellikle tek ülkedir. Her zaman liste gelir.
Dönüş 1
voidDönüş yoksayılır.
Dinleyici 
Hook::add('action:client.sms_sender_requested', 10, function ($uid, $origin, $codes) {
    // Her zaman liste gelir.
    foreach ($codes as $iso) Acme::trackApplication($uid, $origin['name'] ?? '', $iso);
});

Kişi içe aktarımını izleme

actionclient.sms_contacts_imported
ClientSms atlananlar ayrı

Müşteri kişi listesini içe aktardıktan sonra çalışır.

Parametreler 4
$uidintİçe aktarımı yapan hesap.
$importedintGerçekten yazılan kişi sayısı; her zaman birden büyüktür.
$skippedintGeçersiz ad ya da numara yüzünden atlanan satır sayısı. Otomatik atlanan başlık satırı bu sayıya dâhil değildir: kullanıcıya rapor verirken ikisini karıştırmayın.
$group_idintHedef grup; sıfır ise kişiler grupsuz kaydedilmiştir.
Dönüş 1
voidDönüş yoksayılır.
Dinleyici 
Hook::add('action:client.sms_contacts_imported', 10,
    function ($uid, $imported, $skipped, $group_id) {
        // Baslik satiri atlananlara dahil degil.
        if ($skipped > 0) Acme::warnImportQuality($uid, $imported, $skipped);
    });

Ülke fiyat tablosunu değiştirme

filterclient.sms_rate
ClientSms parça başına

Müşteriye gösterilen ülke fiyatları hazırlandıktan sonra çalışır.

Parametreler 2
$outarraybağlaÜlke karşılık fiyat tablosu; her ülke için ücret ve ön kayıt gerekip gerekmediği. ? Ücret parça başınadır, mesaj başına değil: uzun bir mesaj birden çok parçaya bölünür ve o kadar ücretlendirilir.
$ctxarrayBağlam: fiyatların çözüldüğü para birimi.
Dönüş 1
voidDönüş yoksayılır; verinin üzerine yazarsınız.
Dinleyici 
Hook::add('filter:client.sms_rate', 10, function (&$out, $ctx) {
    // Ucret PARCA basinadir.
    foreach ($out as $iso => $row)
        $out[$iso]['rate'] = Acme::applyMargin((float) ($row['rate'] ?? 0));
});

Tuzaklar

Grafikte boş gün sıfır değildir

Kullanım grafiğinde veri toplanmamış bir gün boş gelir. Bunu sıfıra çevirmek grafiğe gerçekte yaşanmamış bir düşüş koyar ve müşteriye yanlış bir kullanım tablosu gösterir. Boşluğu boş bırakın.

Mesaj ücreti parça başınadır

Uzun bir mesaj birden çok parçaya bölünür ve her parça ayrı ücretlendirilir. Alıcı sayısını maliyet sanan bir hesap, uzun mesajlarda gerçek tutarın çok altında kalır. Gönderim özetindeki parça sayısını kullanın.

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ı