Bildirim.al Dokümantasyonu

WordPress eklentisi

1. ZIP’i indirip Eklentiler → Yeni Ekle → Eklenti Yükle yoluyla yükleyin.
2. Eklentiyi etkinleştirin. Ayarlar → Bildirim.al bölümüne paneldeki site numarasını girin.
3. Ayarları kaydedin. Sitenizin ana sayfasını yeni bir sekmede açın ve kurulumu doğrulama adımlarını uygulayın.

Özel yazılım sitenizi bağlayın

1. Entegrasyon → Web push kurulumu alanından sitenize ait kurulum kodunu kopyalayın.
2. Kodu, ziyaretçilerin bildirim izni vereceği sayfalara ekleyin. Ortak sayfa şablonunuz varsa bir kez oraya ekleyebilirsiniz.
3. Bildirimleri teslim alan küçük dosyayı, yani service worker’ı, sitenizin ana dizinine koyun. Kodları aşağıdaki bölümden alabilir veya geliştiricinize iletebilirsiniz.

<script defer src="https://api.bildirim.al/sdk/SITE_ID.js"></script>

importScripts('https://api.bildirim.al/sdk/sw.js');

<script defer src="https://api.bildirim.al/sdk/SITE_ID.js"
        data-worker-path="/service-worker.js" data-worker-scope="/"></script>

Kurulumu ve ilk bildirimi doğrulayın

1. Entegrasyon ekranında Kurulumu kontrol et ile site, SDK ve worker sonuçlarını inceleyin.
2. Sitenizi desteklenen bir tarayıcıda açıp bildirim izni verin. Aboneler ekranında bu tarayıcının kaydını kontrol edin.
3. Kontrollü bir sitede ilk bildirimi gönderin. Tarayıcıdaki bildirimi açıp hedef bağlantıyı doğrulayın.

E-ticaret kurulumu

Önce SDK ve worker kurulumunu tamamlayın. İlgili özellikleri destekleyen paketle Site Ayarları → E-Ticaret bölümünden stok ve sepet bildirimlerini etkinleştirin.

Ürün stoğa geldiğinde bildir

Tükenen ürün sayfasında bir Stoğa girince haber ver düğmesi gösterin. Ziyaretçi bildirim izni verip abone olduktan sonra düğme, ürünün sabit SKU veya kimliğiyle bekleme kaydı açar.

<button type="button" id="stok-haberi">Stoğa girince haber ver</button>
<p id="stok-sonucu" role="status"></p>
<script>
document.querySelector('#stok-haberi').addEventListener('click', async () => {
    const sonuc = document.querySelector('#stok-sonucu');
    try {
        const yanit = await window.bildirimal.watchStock({
            productRef: 'URUN-SKU-123',
            productUrl: window.location.href,
            productName: 'Ürün adı'
        });
        if (!yanit.ok) throw new Error();
        sonuc.textContent = 'Stok bildirimi kaydedildi.';
    } catch {
        sonuc.textContent = 'İstek kaydedilemedi. Bildirim iznini ve kurulumu kontrol edin.';
    }
});
</script>

Ürün stoğa geldiğinde panelde bekleyen ürünün Stoğa Girdi, Bildir düğmesini kullanın. Otomasyon için Entegrasyon → E-ticaret bölümündeki gizli webhook adresine sunucunuzdan aynı SKU’yu gönderin. WooCommerce kullanıyorsanız stok olayıyla gelen SKU’yu bu isteğin productRef alanına eşleyin.

POST [PANELDEKİ_GİZLİ_WEBHOOK_ADRESİ]
Content-Type: application/json

{"productRef":"URUN-SKU-123"}

Sepet hatırlatması

Site ayarlarından gecikmeyi ve mesajı belirleyin. İzinli abone sepete ürün eklediğinde veya sepeti güncellediğinde, kaydedilmiş sepet durumunu SDK’ya iletin. Ödeme onaylandığında bekleyen hatırlatmayı kapatın.

// Sepet kaydı başarıyla güncellendiğinde
window.bildirimal.trackCart({
    cartUrl: new URL('/sepet', window.location.origin).href,
    cartSummary: '2 ürün'
});

// Sipariş gerçekten onaylandığında
window.bildirimal.cartCompleted();

Sepet boşaltılırsa cartCompleted() çağrısıyla bekleyen kaydı kapatabilirsiniz. Testte önce bir ürünü sepette bırakıp ayarlanan süreyi bekleyin, ardından ayrı bir sepette ödemeyi tamamlayarak hatırlatmanın iptal edildiğini doğrulayın.

Metin2 ve özel yazılım otomasyonu

Metin2 entegrasyonu siteye tanımlandığında Entegrasyon → Otomasyon API’si bölümünden sunucu yayını isteğini ve hatırlatma işaretleyicisini alın. SDK yüklü sunucu detayında açılış tarihi ve saatini yapılandırılmış veride yayınlayın, hatırlatma düğmesini aşağıdaki işaretleyiciyle yerleştirin.

<div data-ba-metin2-reminder></div>

Yayın otomasyonunda her duyuru için benzersiz olay kimliği kullanın ve gizli anahtarı sunucuda saklayın.

E-posta ve Netgsm SMS

Yönetici önce E-posta bölümünde SMTP bağlantısını kurar. Site sahibi Entegrasyon → E-posta ve SMS ekranından kanalı açar ve izinli alıcıları kaydeder. Netgsm için API kullanıcısı, şifre, onaylı mesaj başlığı ve İYS alıcı türü gerekir.