PushizoDocs
Başlarken

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: requestPermission bir 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.js 200 dönüyor mu, konsolda logLevel: '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.

Bu sayfada