Cum să configurați notificările push Webpushr pentru WordPress

Webpushr este o platformă de notificări push web care livrează notificări în timp real prin browser utilizatorilor abonați, chiar și atunci când aceștia au navigat complet în afara site-ului tău. Spre deosebire de email sau SMS, push-ul web nu necesită informații de contact personale — abonații primesc notificări direct prin sistemul nativ de notificări al browserului, prin intermediul Web Push Protocol și al Push API.

Acest ghid parcurge întregul proces de configurare: de la crearea contului și configurarea plugin-ului WordPress până la segmentare avansată, automatizare bazată pe declanșatoare și analize ale abonaților. Acoperă, de asemenea, cazuri tehnice speciale — conflicte de service worker, cerințe HTTPS, lacune de compatibilitate iOS și considerații de performanță — pe care majoritatea tutorialelor le omit complet.

Cerințe Preliminare Înainte de a Începe

Înainte de a accesa panoul de control WordPress, verificați că mediul dvs. îndeplinește următoarele cerințe obligatorii:

• HTTPS este obligatoriu. Push API și service worker-ele sunt restricționate la origini securizate. Un site care rulează pe HTTP simplu nu poate înregistra un service worker și, prin urmare, nu poate livra notificări push web. Dacă site-ul dvs. nu este încă securizat, aveți nevoie de un certificat SSL valid — AlexHost oferă Certificate SSL care acoperă această cerință.
• WordPress 5.0 sau superior este recomandat pentru compatibilitate completă cu editorul de blocuri Gutenberg și cu meta box-ul Webpushr.
• PHP 7.4 sau superior pe partea de server, pentru a evita avertismentele privind funcțiile depreciate care pot întrerupe silențios inițializarea plugin-ului.
• Conștientizarea suportului browserelor: Chrome, Firefox și Edge pe desktop și Android suportă Web Push Protocol. Safari pe macOS a adăugat suport în Safari 16 (macOS Ventura). iOS Safari a adăugat suport limitat în iOS 16.4 doar pentru PWA-uri adăugate pe ecranul principal — push-ul web standard bazat pe browser pe iOS rămâne nesigur la momentul scrierii acestui ghid.
• Fără service worker-e conflictuale. Dacă rulați deja un plugin PWA sau un alt serviciu de notificări push, service worker-ele acestora pot intra în conflict cu cel al Webpushr. Auditați service worker-ele active la chrome://serviceworker-internals/ înainte de a continua.

Pasul 1: Creați și Configurați Contul Webpushr

Navigați la webpushr.com și înregistrați un cont nou. În timpul procesului de integrare, vi se va solicita domeniul site-ului dvs. Introduceți domeniul exact așa cum apare în bara de adrese a browserului, inclusiv prefixul www sau absența acestuia — această valoare este utilizată pentru a delimita service worker-ul, iar nepotrivirile vor cauza eșecuri la abonare.

După înregistrare, Webpushr furnizează două credențiale esențiale:

• API Key — utilizat de plugin-ul WordPress pentru a autentifica apelurile REST API la trimiterea notificărilor.
• Auth Token — utilizat pentru solicitările API de pe server dacă ulterior construiți integrări personalizate.

Localizați ambele valori în Account > API Keys din panoul de control Webpushr și stocați-le în siguranță. API Key nu este un secret în sensul tradițional (este încorporat în solicitările de pe partea clientului), dar Auth Token trebuie păstrat privat.

Limitele Planului Gratuit vs. Planurilor Plătite Webpushr

Pentru majoritatea site-urilor WordPress mici, nivelul gratuit este suficient pentru a valida canalul înainte de a se angaja la un plan plătit.

Pasul 2: Instalați Plugin-ul WordPress Webpushr

Conectați-vă la panoul de administrare WordPress și urmați această cale:

1. Mergeți la Plugins > Add New.
2. Căutați Webpushr.
3. Localizați plugin-ul oficial publicat de Webpushr Inc. — verificați numele editorului pentru a evita instalarea unui plugin cu nume similar.
4. Faceți clic pe Install Now, apoi pe Activate.

Alternativ, instalați prin WP-CLI dacă gestionați WordPress din linia de comandă:

wp plugin install webpushr-web-push-notifications --activate

După activare, un nou element de meniu Webpushr apare în navigarea din stânga a WordPress.

Ce Face Plugin-ul de Fapt la Nivel de Server

Înțelegerea arhitecturii plugin-ului vă ajută să depanați problemele în mod inteligent. La activare, plugin-ul:

1. Înregistrează o regulă de rescriere pentru a servi fișierul service worker (webpushr-sw.js) din rădăcina site-ului. Acest lucru este esențial — service worker-ele trebuie servite din domeniul rădăcină pentru a controla întreaga origine.
2. Injectează un fragment JavaScript în fiecare pagină front-end prin wp_enqueue_scripts care încarcă SDK-ul Webpushr și înregistrează service worker-ul.
3. Se conectează la acțiunile WordPress publish_post și publish_page pentru a declanșa notificări push automate când conținutul este publicat.

Dacă plugin-ul dvs. de cache stochează agresiv fișierul service worker, abonații pot primi payload-uri push învechite sau pot eșua complet la înregistrare. Excludeți webpushr-sw.js din regulile de cache.

Pasul 3: Conectați Plugin-ul la Contul Dvs. Webpushr

Navigați la Webpushr > Settings în panoul de control WordPress. Veți vedea un câmp etichetat API Key. Lipiți API Key-ul obținut din panoul de control Webpushr în Pasul 1.

Faceți clic pe Save Changes. Plugin-ul va face o solicitare de validare către API-ul Webpushr. Dacă cheia este validă, apare o confirmare de succes. Dacă vedeți o eroare:

• Confirmați că nu există spații albe la începutul sau sfârșitul cheii lipite.
• Verificați că serverul dvs. poate face solicitări HTTPS de ieșire către api.webpushr.com. Unele configurații VPS întărite blochează conexiunile de ieșire în mod implicit. Pe un server Linux, testați cu:

curl -I https://api.webpushr.com

Un răspuns 200 OK sau 301 confirmă conectivitatea. Dacă conexiunea expiră, verificați regulile firewall-ului cu iptables -L OUTPUT sau ACL-ul de rețea al furnizorului dvs. de hosting.

Dacă rulați WordPress pe un mediu de VPS Hosting, aveți control deplin asupra regulilor firewall și puteți lista direct endpoint-ul API Webpushr pe lista albă.

Pasul 4: Configurați Promptul de Abonare

Promptul de abonare este dialogul de permisiune al browserului care solicită utilizatorilor să permită notificările. Dialogul nativ de permisiune al browserului nu poate fi stilizat — este redat de browser însuși. Cu toate acestea, Webpushr oferă un prompt de pre-permisiune (un overlay personalizat care apare înainte de dialogul nativ) pe care îl puteți personaliza complet.

Configurați promptul de pre-permisiune în panoul de control Webpushr sub Settings > Opt-in Prompt:

• Stilul promptului: Alegeți între un widget cu clopoțel, o bară de sus, o casetă glisantă sau un modal personalizat.
• Textul promptului: Scrieți un text care comunică clar valoarea abonării. Prompturile vagi precum „Permiteți notificările?” au în mod constant performanțe mai slabe decât prompturile care specifică ce vor primi abonații, cum ar fi „Fiți notificat imediat când publicăm noi avize de securitate.”
• Întârzierea promptului: Setați o întârziere (în secunde sau vizualizări de pagini) înainte de a afișa promptul. Afișarea imediată la încărcarea paginii produce rate de abonare mai mici decât așteptarea până când un utilizator a interacționat cu cel puțin o bucată de conținut.
• Intervalul de re-afișare: Definiți câte zile trebuie să treacă înainte ca un utilizator care a respins promptul să îl vadă din nou. Re-afișarea agresivă dăunează experienței utilizatorului și crește rata de respingere.

Repere ale Ratei de Abonare pe Tip de Prompt

Prompturile contextuale — afișate după ce un utilizator finalizează o acțiune semnificativă, cum ar fi citirea unui articol până la capăt — depășesc în mod constant toate celelalte abordări.

Pasul 5: Configurați Setările de Livrare a Notificărilor

Push Automat la Publicarea Articolului

În Webpushr > Settings, comutatorul Auto-Push Notification controlează dacă o notificare push se declanșează automat de fiecare dată când publicați un articol. Când este activat, Webpushr preia titlul articolului, rezumatul și URL-ul imaginii principale și construiește automat payload-ul notificării.

Caz special: Dacă utilizați un flux de lucru de la staging la producție unde articolele sunt importate sau statusul lor este schimbat programatic (de ex., prin WP-CLI sau un script de migrare), hook-ul publish_post se va declanșa pentru fiecare articol importat, inundând potențial abonații cu zeci de notificări în câteva secunde. Dezactivați auto-push înainte de a rula importuri în masă:

wp option update webpushr_auto_push 0

Reactivați-l după finalizarea importului.

Push Manual din Editorul de Articole

Pentru control granular, dezactivați auto-push global și utilizați meta box-ul Webpushr per articol în editorul de articole. Acest meta box apare sub editorul principal de conținut și expune următoarele controale:

• Trimite notificare push: O casetă de selectare care, atunci când este bifată, pune în coadă o notificare la publicare sau actualizare.
• Titlu personalizat al notificării: Înlocuiți titlul articolului cu un titlu mai atractiv pentru notificare.
• Mesaj personalizat al notificării: Înlocuiți rezumatul generat automat.
• URL personalizat al notificării: Redirecționați abonații către o pagină de destinație specifică în loc de permalink-ul articolului — util pentru campanii promoționale.
• Pictogramă personalizată a notificării: Înlocuiți pictograma implicită a site-ului cu o imagine specifică campaniei.

Anatomia Payload-ului Notificării

Un payload de notificare push web constă din:

• title — afișat cu caractere aldine în partea de sus a notificării.
• body — textul descriptiv de sub titlu.
• icon — o imagine pătrată (recomandat 192×192 px) afișată alături de notificare.
• image — o imagine banner mare afișată sub corp pe platformele suportate (Chrome pe Android, Chrome pe Windows).
• badge — o pictogramă mică monocromatică afișată în bara de stare Android.
• url — URL-ul de destinație când utilizatorul face clic pe notificare.
• actions — până la două butoane de acțiune cu etichete și URL-uri personalizate (suportate pe Chrome și Edge).

Menținerea title sub 50 de caractere și a body sub 120 de caractere previne truncherea pe majoritatea platformelor.

Pasul 6: Testați Notificările Push de la Capăt la Capăt

Testarea în aceeași sesiune de browser în care sunteți conectat la WordPress nu vă va oferi o imagine precisă a experienței abonatului. Utilizați un profil de browser separat sau o fereastră incognito:

1. Deschideți site-ul dvs. într-o fereastră privată/incognito.
2. Promptul de pre-permisiune ar trebui să apară după întârzierea configurată.
3. Faceți clic pe call-to-action-ul promptului, apoi faceți clic pe Allow în dialogul nativ de permisiune al browserului.
4. Reveniți la panoul de control WordPress și publicați un articol de test, sau utilizați butonul Send Test Notification din panoul de control Webpushr.
5. Verificați că notificarea apare cu titlul, corpul, pictograma corecte și că făcând clic pe ea navighează la URL-ul corect.

Moduri comune de eșec în timpul testării:

• Notificarea nu apare: Verificați că notificările browserului nu sunt blocate la nivel de sistem de operare (Windows Focus Assist, macOS Do Not Disturb, canale de notificări Android).
• Service worker-ul nu se înregistrează: Deschideți DevTools > Application > Service Workers și confirmați că webpushr-sw.js este listat ca activ. Dacă apare ca „waiting”, un alt service worker blochează activarea.
• Pictograma nu se încarcă: URL-ul pictogramei trebuie să fie absolut (începând cu https://) și imaginea trebuie servită cu anteturi CORS permisive dacă este găzduită pe un CDN.

Pasul 7: Funcționalități Avansate — Segmentare, Programare și Declanșatoare

Segmentarea Audienței

Motorul de segmentare al Webpushr vă permite să etichetați abonații pe baza:

• Segmente bazate pe URL: Etichetați automat abonații care vizitează URL-uri sau tipare de URL specifice (de ex., toți utilizatorii care vizitează /category/security/ sunt etichetați security-readers).
• Atribute personalizate: Transmiteți perechi cheie-valoare arbitrare prin SDK-ul JavaScript pentru a construi segmente bazate pe proprietățile utilizatorilor pe care aplicația dvs. le urmărește deja.
• Segmente de implicare: Webpushr urmărește automat marcajele temporale ale ultimei vizite, permițându-vă să creați campanii de re-implicare care vizează abonații care nu au primit o notificare în ultimele 30+ de zile.

Segmentarea necesită un plan plătit și este configurată în panoul de control Webpushr sub Segments.

Notificări Programate

Programarea vă permite să compuneți o notificare acum și să o livrați la o dată și oră viitoare, cu suport pentru fus orar. Acest lucru este deosebit de valoros pentru:

• Promoții sensibile la timp cu un termen limită strict.
• Conținut publicat în afara orelor de vârf de trafic pe care doriți să îl livrați în ferestre de implicare ridicată.
• Notificări periodice de tip digest (de ex., rezumate săptămânale).

Notificări Personalizate Bazate pe Declanșatoare

Declanșatoarele personalizate trimit notificări pe baza evenimentelor JavaScript de pe site-ul dvs. De exemplu, puteți trimite o notificare la 24 de ore după ce un utilizator abandonează un coș de cumpărături, sau când un utilizator atinge o anumită adâncime de derulare. Declanșatoarele sunt configurate prin SDK-ul JavaScript Webpushr și necesită muncă de dezvoltare personalizată dincolo de capabilitățile implicite ale plugin-ului WordPress.

Testarea A/B a Textului Notificărilor

Pe planurile plătite, Webpushr suportă testarea împărțită a titlurilor și textului notificărilor pe segmente de abonați. Rulați teste A/B pentru a determina ce mesaje generează rate de clic mai mari înainte de a lansa o campanie completă.

Pasul 8: Monitorizați Analizele Abonaților

Panoul de control Webpushr oferă următoarele metrici:

• Total abonați: Numărul de endpoint-uri active, dezabonate și expirate.
• Rata de livrare: Procentul de notificări trimise care au fost livrate cu succes serviciului push al browserului (FCM pentru Chrome/Edge, Mozilla Autopush pentru Firefox).
• Rata de clic (CTR): Procentul de notificări livrate care au rezultat într-un clic.
• Creșterea abonamentelor în timp: Tendințele zilnice și săptămânale de achiziție a abonaților.

Notă tehnică importantă privind „livrat” vs. „primit”: O notificare este marcată ca livrată când serviciul push al browserului (de ex., FCM de la Google) acceptă payload-ul. Dacă dispozitivul utilizatorului este offline, FCM pune notificarea în coadă și o livrează când dispozitivul se reconectează — dar numai în fereastra TTL (Time to Live) pe care o configurați. TTL-ul implicit este de 28 de zile. Pentru notificările sensibile la timp, setați un TTL mai scurt pentru a evita livrarea de conținut învechit.

Matricea de Compatibilitate a Platformelor și Browserelor

„Suport complet” înseamnă că Web Push Protocol, service worker-ele și acțiunile de notificare sunt toate suportate. Utilizatorii iOS din sesiunile standard de browser rămân în afara razei de acțiune a push-ului web, ceea ce reprezintă un decalaj semnificativ de audiență pentru site-urile cu trafic majoritar mobil.

Considerații privind Infrastructura de Hosting

Livrarea notificărilor push web este gestionată în mare parte de servicii push terțe (FCM, Mozilla Autopush), astfel că debitul brut al serverului dvs. nu reprezintă un blocaj pentru livrare. Cu toate acestea, mediul dvs. de hosting afectează:

• Viteza de servire a service worker-ului: Fișierul webpushr-sw.js trebuie preluat rapid la fiecare încărcare de pagină pentru ca browserele să verifice că service worker-ul este actualizat. Un server lent crește Time to First Byte (TTFB) pentru acest fișier.
• Timpul de răspuns al API-ului: Când un articol nou este publicat, plugin-ul face un apel API sincron către Webpushr. Pe hosting-ul partajat cu limite restrictive de conexiuni de ieșire, acest apel poate expira și poate eșua silențios.
• Fiabilitatea webhook-urilor: Dacă configurați webhook-uri Webpushr pentru a notifica serverul dvs. despre evenimentele de abonare, serverul dvs. trebuie să accepte în mod fiabil solicitările POST de intrare.

Rularea WordPress pe un VPS cu cPanel vă oferă controlul necesar pentru a ajusta timeout-urile de execuție PHP, a configura regulile firewall de ieșire și a monitoriza livrarea service worker-ului fără restricțiile mediilor partajate. Pentru site-urile cu trafic ridicat unde campaniile de notificări push generează vârfuri semnificative de trafic concurrent, un Server Dedicat asigură că originea dvs. poate absorbi încărcarea rezultată din click-uri fără limitare.

Pentru echipele care gestionează mai multe proprietăți WordPress, Email Hosting combinat cu Webpushr creează o strategie de re-implicare pe două canale — push pentru imediateță, email pentru profunzime.

Matricea de Decizie Tehnică: Când să Utilizați Webpushr vs. Alternative

Nivelul gratuit al Webpushr este mai limitat decât cel al OneSignal, dar implementarea service worker-ului său este notabil mai curată și mai puțin predispusă la conflicte cu alte plugin-uri WordPress — un avantaj practic pe instalările complexe de WordPress.

Listă de Verificare Practică Înainte de Lansare

• HTTPS este activ și certificatul SSL este valid și nu este auto-semnat.
• Service worker-ul webpushr-sw.js este accesibil la https://yourdomain.com/webpushr-sw.js și returnează un status 200.
• Fișierul service worker este exclus din regulile de cache ale plugin-ului dvs. de caching.
• Întârzierea promptului de abonare este setată la cel puțin 5 secunde sau o vizualizare de pagină.
• Auto-push este dezactivat dacă rulați importuri în masă programate sau migrări de conținut.
• O notificare de test a fost primită de la capăt la capăt într-o sesiune de browser curată.
• Dimensiunile pictogramei notificării sunt 192×192 px și URL-ul este HTTPS absolut.
• TTL-ul este configurat corespunzător pentru sensibilitatea la timp a conținutului dvs.
• Linia de bază a analizelor este înregistrată înainte de prima campanie, astfel încât să aveți un punct de comparație semnificativ.
• Politica de confidențialitate/GDPR actualizată pentru a dezvălui colectarea datelor prin notificări push.

Întrebări Frecvente

Funcționează Webpushr fără HTTPS?

Nu. Web Push API și service worker-ele sunt restricționate la origini securizate prin specificația browserului. Orice site care rulează pe HTTP nu poate înregistra un service worker și, prin urmare, nu poate trimite sau primi notificări push web. Un certificat SSL este o cerință tehnică obligatorie, nu o bună practică opțională.

De ce notificările mele push nu sunt livrate unor abonați?

Cele mai comune cauze sunt: dispozitivul abonatului a fost offline dincolo de fereastra TTL a notificării; utilizatorul a revocat permisiunile de notificare la nivel de browser sau sistem de operare; sau endpoint-ul serviciului push al browserului (FCM, Mozilla Autopush) a returnat o înregistrare expirată sau invalidă. Panoul de control Webpushr marchează acestea ca livrări „eșuate” și elimină automat endpoint-urile care returnează un răspuns 410 Gone, ceea ce reprezintă comportamentul corect conform specificației Web Push Protocol.

Pot trimite notificări push utilizatorilor iOS?

Începând cu iOS 16.4, push-ul web este suportat doar pentru Progressive Web Apps (PWA) care au fost adăugate pe ecranul principal. Utilizatorii care navighează pe site-ul dvs. în Safari sau orice alt browser iOS fără a-l adăuga pe ecranul principal nu vor primi notificări push web. Aceasta este o restricție la nivel de platformă impusă de Apple, nu o limitare a Webpushr.

Va intra service worker-ul Webpushr în conflict cu PWA-ul sau plugin-ul de caching existent?

Este posibil. Doar un service worker poate controla un domeniu dat la un moment dat. Dacă un plugin PWA (de ex., Super PWA) sau un alt serviciu push a înregistrat deja un service worker la domeniul rădăcină, service worker-ul Webpushr va intra în coadă într-o stare de „așteptare” și nu se va activa niciodată. Soluția este să utilizați un service worker care importă ambele scripturi, sau să alegeți un singur furnizor push și să îi dezactivați pe ceilalți. Verificați chrome://serviceworker-internals/ pentru a audita toți worker-ii înregistrați pe domeniul dvs.

Dezactivarea plugin-ului Webpushr dezabonează abonații existenți?

Nu. Dezactivarea plugin-ului elimină SDK-ul JavaScript din front end-ul dvs., ceea ce previne abonamentele noi și oprește notificările automate. Cu toate acestea, înregistrările existente ale endpoint-urilor push rămân valide în browser până când utilizatorul revocă explicit permisiunea sau endpoint-ul expiră. Dacă reactivați plugin-ul cu același API Key, acei abonați vor fi din nou accesibili imediat.