Web hızlı başlangıç
Tarayıcı push için en kısa yol — Web Push kanalını açın, script etiketini ekleyin, service worker'ı yerleştirin, izin isteyin ve test push gönderin.
Web Push, Chrome, Edge, Firefox ve Safari 16.4+ (iOS'ta ana ekrana eklenmiş PWA) tarayıcılarında çalışır; HTTPS zorunludur (localhost muaf). Bu sayfa en kısa kurulumu verir; tüm seçenekler için Web SDK.
Kanalı etkinleştirin
Dashboard → App ayarları → Kanallar → Web Push → Etkinleştir. VAPID anahtar çifti otomatik üretilir; gönderici subject olarak mailto: ya da https:// adresi verin. Kanal anında active olur. API ile: PUT /v1/apps/{app_id}/channels/web_push (admin).
Script etiketini ekleyin
<script src="https://api.pushizo.com/sdk-web/PushizoSDK.js" async></script>
<script>
window.PushizoDeferred = window.PushizoDeferred || [];
PushizoDeferred.push(async (Pushizo) => {
await Pushizo.init({ appId: 'app_…' }); // kendi sunucunuzda: apiUrl: 'https://api.example.com'
});
</script>npm ile (@pushizo/web, yayın sonrası):
import Pushizo from '@pushizo/web';
await Pushizo.init({ appId: 'app_…' });Service worker'ı yerleştirin
Sitenizin kökünde PushizoSDKWorker.js:
const apiUrl = new URL(self.location.href).searchParams.get('apiUrl') || 'https://api.pushizo.com';
importScripts(`${apiUrl}/sdk-web/PushizoSDKWorker.js`);Mevcut bir service worker'ınız varsa aynı importScripts satırını ona ekleyip init içinde serviceWorkerPath verin. Kök dışındaki dosya için sunucu Service-Worker-Allowed: / başlığı göndermelidir.
İzin isteyin ve kullanıcıyı tanıtın
await Pushizo.Notifications.requestPermission(); // bir düğmeye bağlayın; tarayıcı istemi kullanıcı hareketi ister
await Pushizo.login('user_42'); // kimliği bildiğiniz anda; cihazlar aynı kullanıcıda birleşir
await Pushizo.User.addTags({ plan: 'pro' });Yumuşak istem (slidedown) ve zil için init seçenekleri slidedown / bell (istemler).
Test push gönderin
Dashboard → Abonelikler → kaydı Test cihazı yapın → Mesajlar → Test push gönder. API ile target.test_devices_only: true kullanın (ilk bildirim). Teslimat zaman çizelgesi Mesaj İzleme ekranında görünür.
Sık karşılaşılanlar
- İzin istemi açılmıyor:
requestPermissionbir kullanıcı hareketinden (tıklama) çağrılmalı; tarayıcı daha önce reddettiyse site ayarlarından sıfırlanır. - Abonelik oluşmuyor: sayfa HTTPS mi,
PushizoSDKWorker.js200 dönüyor mu, konsoldalogLevel: 'debug'ile SDK günlüğünü açın. - iOS Safari: yalnızca ana ekrana eklenen PWA; manifest ve kurulum rehberi: iOS web push ve PWA.
- React/Vue/Angular: çatı rehberleri; SSR çatılarında SDK'yı istemci tarafında başlatın.