Giriş
Pushizo geliştirici dokümantasyonu — çok kiracılı push, e-posta, SMS, in-app bildirim ve müşteri etkileşim platformu.
Pushizo, OneSignal ile uyumlu bir kavram modeli ve SDK yüzeyi sunan, kendi altyapınızda çalışan bildirim platformudur: push (iOS APNs, Android FCM, Web Push), e-posta (SMTP, Amazon SES, Resend), SMS (Twilio, Netgsm), in-app mesajlar ve bildirim kutusu; segmentler, şablonlar (Liquid), kampanyalar, A/B testleri, journey'ler, webhook'lar ve analitik.
Nereden başlamalı
Hızlı başlangıç
Kayıt → app → kanal → SDK kurulumu → ilk bildirim; 15 dakikada test push.
SDK rehberleri
Web, iOS, Android, Flutter istemci SDK'ları; Node, PHP, Python, Go, Java, .NET, Ruby sunucu SDK'ları.
API referansı
Kimlik doğrulama, kapsamlar, hata zarfı, idempotency, sayfalama; 169 işlemin listesi, OpenAPI ve Postman.
Webhook'lar
Olay türleri, HMAC imza doğrulama, yeniden deneme, replay.
OneSignal'den göç
Player aktarımı, API ve SDK eşleme tabloları, çift yazma dönemi.
Hata kataloğu
HS_* kodları, HTTP durumları ve ne yapılacağı.
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, admin). İstemciye gömülmez. |
Kullanıcı (hs_id, 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, web_push, email, sms). |
| 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. |
Yerel geliştirme
Monorepo'da npm run dev API'yi (http://localhost:4000, OpenAPI /openapi.json, API belgeleri /docs), dashboard'u (http://localhost:3100) ve worker'ı başlatır; bu site npm run dev -w apps/docs-site ile http://localhost:3300 adresinde çalışır. Seed girişi: admin@pushizo.test / Pushizo!2026.