Pushizo dokümantasyonu
Pushizo geliştirici dokümantasyonu — çok kanallı push, e-posta, SMS, WhatsApp, RCS, in-app bildirim ve müşteri etkileşim platformu için başlangıç, kanal, SDK, API ve operasyon rehberleri.
Pushizo, OneSignal ile uyumlu bir kavram modeli ve SDK yüzeyi sunan, kendi altyapınızda da çalışan bildirim platformudur: push (iOS APNs, Android FCM, Huawei HMS, Web Push), e-posta (SMTP, Amazon SES, Resend), SMS (Twilio, Netgsm), WhatsApp, RCS, in-app mesajlar ve bildirim kutusu; segmentler, Liquid şablonları, kampanyalar, A/B testleri, journey'ler, webhook'lar ve analitik.
- 15 dakikada ilk bildirim
- POST /v1/notifications
- Web SDK
- Webhook imzası
- HS_* hata kodları
- openapi.yaml
- Postman
Bölümler
Başlarken
Kavramlar, hızlı başlangıç ve platform başına (web, iOS, Android, Flutter, sunucu) kurulum; planlar ve kota.
Kanallar
Web Push, iOS, Android, Huawei; e-posta ve teslim edilebilirlik; SMS, WhatsApp, RCS; in-app, bildirim kutusu, Live Activities.
Kullanıcılar & segmentler
Kimlik modeli (kullanıcı, alias, abonelik), tag/özellik, segment koşul dili, tercihler, suppression list, KVKK.
Mesajlaşma & kampanyalar
Çok kanallı içerik, hedefleme, zamanlama, kampanyalar, şablonlar, Dynamic Content ve AI asistanı.
Journeys
Olay ve segment tetikli otomasyon: 13 düğüm türü, bekleme, koşul, split, hedefler, sürümleme.
A/B testleri
Kampanya, journey ve in-app varyantları; holdout, anlamlılık, otomatik kazanan.
Analitik & veri
Raporlar, Event Streams, veri ambarı dışa aktarımı, CSV export/import.
Entegrasyonlar
Segment, Amplitude, Mixpanel, Zapier, Slack, WordPress, GTM, MCP sunucusu; React, Vue, Angular.
SDK'lar
Web, iOS, Android, Flutter, React Native, Capacitor, Cordova, MAUI, Unity; Node, PHP, Python, Go, Java, .NET, Ruby.
API referansı
Kimlik doğrulama, kapsamlar, hız sınırları, idempotency, sayfalama; etiket başına tüm işlemler ve şemalar.
Webhook'lar
Olay türleri, Pushizo-Signature doğrulama, secret rotasyonu, yeniden deneme ve replay.
Güvenlik & uyum
KVKK/GDPR, veri yerleşimi (EU/TR), SSO/SCIM, API anahtarları, bot koruması, white-label.
Operasyon
Docker Compose ve Helm ile kurulum, yedek/geri yükleme, status ve izleme, DMARC, runbook'lar.
Göç
OneSignal ve Firebase (FCM) kurulumlarından Pushizo'ya geçiş.
Hata kataloğu
HS_* kodları, HTTP durumları ve ne yapılacağı.
Son güncellemeler
v1.0.0 · 2026-10-16- Pushizo marka adı: ürün HeroSignal'den Pushizo'ya taşındı; paketler @pushizo/*, imajlar ghcr.io/exec0de/pushizo-*, SDK paket adları ve varsayılan API kökü…
- v2 fazları (15–21): kurumsal kimlik (SAML/OIDC SSO, SCIM, JWT kimlik doğrulama), ölçek mimarisi (ClickHouse, Kafka, Go dispatcher, Helm), iOS Live Activities, Huawei…
- Platform yönetim paneli (/admin): organizasyonlar, hesaplar, faturalama, özellik bayrakları, kötüye kullanım, destek, olaylar (incident), app taşıma onayları, sistem…
- OneSignal tarzı kurulum akışı: "Başlarken" ve SDK kurulum sayfaları (platform seçimi, adım adım kurulum, kod örneklerinde genel API adresi).
- Tanıtım sitesi ve SEO: apps/web (pushizo.com) — çok dilli statik sayfalar, sitemap, robots, llms.txt, OG görselleri, IndexNow; dokümantasyon sitesi docs.pushizo.com.
Tüm sürüm notlarıAPI değişiklik günlüğüAPI 1.0.0 · 232 işlem
Temel kavramlar
| Kavram | Açıklama |
|---|---|
| Organizasyon | Hesabınızın çalıştığı kiracı; üyeler, roller, faturalama ve API anahtarları organizasyona bağlıdır. |
App (app_…) | Bildirim gönderilen ürün. Kanal kimlik bilgileri, kullanıcılar, abonelikler, segmentler ve kampanyalar app'e aittir. İstemci SDK'ları yalnızca App ID ile çalışır. |
API anahtarı (hs_live_…) | Sunucu tarafı erişim; kapsamlı (notifications:write, users:read, users:write, events:write, segments:read, analytics:read, mcp:write, admin). İstemciye gömülmez. |
Kullanıcı (usr_…, external_id, alias'lar) | Sizin kullanıcınız; birden fazla aboneliği olabilir. login(externalId) anonim cihazı kullanıcıya bağlar. |
Abonelik (sub_…) | Tek bir kanal ucu: cihaz token'ı, tarayıcı aboneliği, e-posta adresi ya da telefon numarası (ios_push, android_push, hms_push, web_push, email, sms, whatsapp, rcs). |
| Tag / özellik / olay | Segmentleme ve kişiselleştirme verisi; olaylar journey ve in-app tetikleri ile dönüşüm atribüsyonunu besler. |
Mesaj (msg_…) ve teslimat (dlv_…) | POST /v1/notifications bir mesaj oluşturur; her alıcı aboneliği için bir teslimat kaydı queued → sent → delivered/received → opened/clicked zaman çizelgesi taşır. |
Adresler
| Yüzey | Adres |
|---|---|
| Uygulama (dashboard) | https://app.pushizo.com |
| Public REST API | https://api.pushizo.com/v1 (etkileşimli belge) |
| Dokümantasyon | https://docs.pushizo.com |
| Durum sayfası | https://status.pushizo.com |
Kendi sunucunuzda çalıştırıyorsanız adresler kurulumunuza göre değişir (Operasyon); SDK'larda apiUrl / baseUrl ile verilir.