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
- 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.
- 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. - Raporu inceleyen kişi açık onay verirse (
preflight_ack=true) işlem sürer; onay denetim kaydına (campaign.preflight_acknowledged) ve kampanyanınpreflightözetine (acknowledged_by,acknowledged_at) yazılır. - 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
| Kategori | Kod | Önem | Açıklama |
|---|---|---|---|
| Marka kılavuzu | brand_name_casing | uyarı | Marka kitindeki ad farklı yazılmış (ör. PUSHIZO). |
| Marka kılavuzu | off_brand_color | not | E-posta HTML'inde marka paleti ve gri tonlar dışında renk. |
| Marka kılavuzu | off_brand_font | not | E-posta HTML'inde marka yazı tipi dışında yazı tipi. |
| Yasaklı ifade | banned_phrase | kritik | Organizasyonun AI ayarlarındaki yasaklı ifade listesinden bir ifade. |
| Yasaklı ifade | phishing_term | kritik | Platform kimlik avı listesindeki ifade (şifre, kart bilgisi isteme vb.). |
| Bağlantı | link_unsafe_host | kritik | javascript:, localhost, özel/iç ağ adresi. Genel IP adresi uyarıdır. |
| Bağlantı | link_broken | kritik | Bağlantı denetiminde 4xx/5xx yanıt (405 sorun sayılmaz). |
| Bağlantı | link_insecure_http | uyarı | http:// bağlantı. |
| Bağlantı | link_shortener | uyarı | bit.ly, t.co gibi kısaltıcılar. |
| Bağlantı | link_unreachable | uyarı | Zaman aşımı veya ağ hatası. |
| Bağlantı | link_invalid | uyarı | Ayrıştırılamayan adres. |
| Bağlantı | link_missing_utm | not | utm_source parametresi yok. |
| Kişiselleştirme | liquid_syntax_error | kritik | Liquid ayrıştırma hatası veya yasak etiket. |
| Kişiselleştirme | liquid_missing_default | uyarı | Kişiye göre boş gelebilen değişkende default filtresi yok. |
| Kişiselleştirme | liquid_unknown_variable | uyarı | Render kapsamında olmayan değişken (ör. {{ isim }}). |
| Kişiselleştirme | liquid_undefined_property | uyarı | Özellik/etiket, kişilerin 5000 kişilik örnekleminde hiç yok. |
| KVKK/İYS | iys_sms_filter_informational | kritik | Ticari kampanyada Netgsm SMS kanalı İYS bilgilendirme filtresinde. |
| KVKK/İYS | sms_missing_opt_out | uyarı | Ticari SMS gövdesinde ret bilgisi (RET, İPTAL, STOP) yok. |
| KVKK/İYS | email_missing_postal_address | uyarı | Ticari e-posta için kanal ayarında posta adresi yok. |
| KVKK/İYS | send_time_outside_hours | uyarı | App saat diliminde 08.00–21.00 dışında gönderim (sessiz saatler tanımlı değilse). |
| KVKK/İYS | commercial_no_category | not | Tercih 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
HEADisteğ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.