PushizoDocs

Yayın öncesi denetim

Kampanya gönderilmeden veya zamanlanmadan önce içerik otomatik olarak denetlenir: marka kılavuzu, yasaklı ifadeler ve kimlik avı (phishing), bağlantılar, kişiselleştirme (Liquid) hataları ve KVKK/İYS kuralları. Denetim…

Kampanya gönderilmeden veya zamanlanmadan önce içerik otomatik olarak denetlenir: marka kılavuzu, yasaklı ifadeler ve kimlik avı (phishing), bağlantılar, kişiselleştirme (Liquid) hataları ve KVKK/İYS kuralları. Denetim her planda açıktır (ADR-0089).

Nasıl çalışır

  1. Kampanya düzenleyicinin Gözden geçir adımında rapor otomatik alınır. Bağlantıları da denetle düğmesi bağlantılara istek atarak kırık bağlantıları da bulur.
  2. Gönder veya zamanla isteğinde aynı denetim yeniden çalışır (bağlantılara istek atılmaz). Kritik bulgu varsa istek 409 HS_CONFLICT (details.reason = preflight_blocked, raporun tamamı details.report) ile durur.
  3. Raporu inceleyen kişi açık onay verirse (preflight_ack=true) işlem sürer; onay denetim kaydına (campaign.preflight_acknowledged) ve kampanyanın preflight özetine (acknowledged_by, acknowledged_at) yazılır.
  4. Onay akışı açıksa onaylayan kişi de kritik bulguları görür ve onaylarken açık onay verir. Kritik bulgulu kampanya Slack'ten onaylanamaz; panelden onaylanır.

Uyarı ve notlar gönderimi durdurmaz; yalnızca raporda görünür.

Kurallar

KategoriKodÖnemAçıklama
Marka kılavuzubrand_name_casinguyarıMarka kitindeki ad farklı yazılmış (ör. PUSHIZO).
Marka kılavuzuoff_brand_colornotE-posta HTML'inde marka paleti ve gri tonlar dışında renk.
Marka kılavuzuoff_brand_fontnotE-posta HTML'inde marka yazı tipi dışında yazı tipi.
Yasaklı ifadebanned_phrasekritikOrganizasyonun AI ayarlarındaki yasaklı ifade listesinden bir ifade.
Yasaklı ifadephishing_termkritikPlatform kimlik avı listesindeki ifade (şifre, kart bilgisi isteme vb.).
Bağlantılink_unsafe_hostkritikjavascript:, localhost, özel/iç ağ adresi. Genel IP adresi uyarıdır.
Bağlantılink_brokenkritikBağlantı denetiminde 4xx/5xx yanıt (405 sorun sayılmaz).
Bağlantılink_insecure_httpuyarıhttp:// bağlantı.
Bağlantılink_shorteneruyarıbit.ly, t.co gibi kısaltıcılar.
Bağlantılink_unreachableuyarıZaman aşımı veya ağ hatası.
Bağlantılink_invaliduyarıAyrıştırılamayan adres.
Bağlantılink_missing_utmnotutm_source parametresi yok.
Kişiselleştirmeliquid_syntax_errorkritikLiquid ayrıştırma hatası veya yasak etiket.
Kişiselleştirmeliquid_missing_defaultuyarıKişiye göre boş gelebilen değişkende default filtresi yok.
Kişiselleştirmeliquid_unknown_variableuyarıRender kapsamında olmayan değişken (ör. {{ isim }}).
Kişiselleştirmeliquid_undefined_propertyuyarıÖzellik/etiket, kişilerin 5000 kişilik örnekleminde hiç yok.
KVKK/İYSiys_sms_filter_informationalkritikTicari kampanyada Netgsm SMS kanalı İYS bilgilendirme filtresinde.
KVKK/İYSsms_missing_opt_outuyarıTicari SMS gövdesinde ret bilgisi (RET, İPTAL, STOP) yok.
KVKK/İYSemail_missing_postal_addressuyarıTicari e-posta için kanal ayarında posta adresi yok.
KVKK/İYSsend_time_outside_hoursuyarıApp saat diliminde 08.00–21.00 dışında gönderim (sessiz saatler tanımlı değilse).
KVKK/İYScommercial_no_categorynotTercih kategorisi seçilmemiş ticari kampanya.

transactional türündeki kampanyalar ticari ileti sayılmaz; KVKK/İYS kuralları uygulanmaz. E-posta altbilgisindeki abonelikten çıkma bağlantısı her zaman otomatik eklenir.

API

Rapor (her planda; panel ve public API):

curl -X POST "https://api.pushizo.com/v1/apps/$APP_ID/campaigns/$CAMPAIGN_ID/preflight?check_links=true" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Yanıt özeti summary (critical, warning, info, blocked) ve findings listesidir. Bulgu metni kodla verilir; params yalnızca sorunun yerini gösteren kısa değerlerdir:

{
  "summary": { "critical": 1, "warning": 2, "info": 1, "blocked": true },
  "findings": [
    { "code": "banned_phrase", "category": "content", "severity": "critical", "field": "content.contents.tr", "params": { "phrase": "bedava hediye" } }
  ]
}

Kritik bulguya rağmen göndermek için POST .../campaigns/{id}/send?preflight_ack=true (zamanlama ve onay uçları da aynı parametreyi alır). Node SDK: hs.campaigns.preflight(id, undefined, { checkLinks: true }), hs.campaigns.send(id, undefined, { preflightAck: true }).

Sınırlar

  • Kampanya başına en çok 50 bağlantı denetlenir; bağlantı denetiminde en çok 15 bağlantıya 4 sn zaman aşımlı, SSRF denetimli HEAD isteği atılır (yönlendirme izlenmez).
  • Rapor kişisel veri içermez; özellik varlığı yalnızca anahtar adıyla aranır.
  • Kural tabanlıdır; hukuki inceleme yerine geçmez.

Bu sayfada