B Blengi docs

Je workspace beheren

Pushmeldingen

Pushmeldingen waarschuwen je team in de browser — en in geïnstalleerde PWA’s — zodra er iets is dat je aandacht nodig heeft: een nieuwe lead, een bezoeker die met iemand wil praten, een nieuw gesprek of een widgetfout. In tegenstelling tot de ‘browserwaarschuwingen’ in het tabblad (die alleen verschijnen zolang een dashboardtabblad openstaat), komen pushmeldingen ook binnen als het tabblad gesloten is .

Web Push, geen Firebase
Blengi maakt gebruik van de browser-eigen Web Push-standaard (VAPID) via je bestaande service worker. Geen SDK van derden, geen leveranciersaccount en geen apparaattokens die je server verlaten — een perfecte oplossing voor GDPR-gevoelige installaties.

Wat zorgt ervoor dat er een push wordt verstuurd

  • Nieuwe lead vastgelegd — naar elke werkruimte-eigenaar/beheerder.
  • Verzoek om menselijke overname — naar operators die beschikbaar zijn voor live chat. Tijdgevoelig, dus dit is de meest waardevolle push.
  • Nieuw gesprek — het eerste bericht van een gloednieuw gesprek (niet elk bericht), naar eigenaren/beheerders.
  • Widget-/systeemfout — naar super_admins wanneer de Widget Monitor een ernstige fout registreert. Beperkt tot één melding per fouttype per 10 minuten, zodat een reeks storingen slechts één melding oplevert.
Buiten het hot path van de bezoeker
Elke push wordt verzonden vanuit een taak in de wachtrij (de analytics-wachtrij), nooit vanuit de live SSE-stream. Een push vertraagt nooit het antwoord van een bezoeker.

Eenmalige instelling (beheerder)

Web Push-berichten worden ondertekend met een VAPID-sleutelpaar. Genereer dit eenmalig op de server:

php artisan pitchbar:webpush-vapid

Het sleutelpaar wordt opgeslagen in de app_settings -tabel (de privésleutel is versleuteld in rust), dus het blijft behouden bij implementaties en hoeft niet te worden bewerkt in .env . Controleer of het gelukt is onder Instellingen → Systeem → E-mail , waar het paneel voor Web Push- meldingen Geconfigureerd aangeeft en de openbare sleutel toont.

VlagGevolg
--force Genereer het sleutelpaar opnieuw. Dit maakt alle bestaande browserabonnementen ongeldig — beheerders moeten push opnieuw inschakelen — dus gebruik dit alleen als er een sleutel is gelekt.
--subject=mailto:you@example.com Het VAPID-contactonderwerp overschrijven (standaard is dit een mailto:, samengesteld op basis van je "van"-adres in de e-mail).

Push inschakelen (per beheerder)

Zodra er VAPID-sleutels zijn, meldt elk teamlid zich aan via Instellingen › Meldingen › Pushmeldingen door op Inschakelen te klikken en de toestemmingsvraag van de browser te accepteren. Het abonnement wordt per gebruiker en per apparaat opgeslagen — als je het op een laptop inschakelt, wordt het niet op een telefoon ingeschakeld, en andersom. Als je dit uitschakelt, wordt de abonnement voor dat apparaat verwijderd.

Voor iOS moet een PWA geïnstalleerd zijn
Op iPhone/iPad werkt Web Push alleen als het dashboard is toegevoegd aan het startscherm (geïnstalleerd als PWA) op iOS 16.4+ . In een gewoon Safari-tabblad blijft de knop Inschakelen verborgen omdat de browser aangeeft geen ondersteuning voor pushmeldingen te hebben . Chrome/Edge/Firefox/Safari op de desktop en Chrome op Android werken in een normaal tabblad.

Stuur een test-push

Snelste manier om te controleren: zodra je op ‘Inschakelen’ hebt geklikt, verschijnt er een knop ‘Test verzenden’ in dezelfde kaart, onder Instellingen › Mijn account › Meldingen (/settings/notifications ). Klik erop om meteen een melding naar je eigen apparaat te sturen — je hebt geen terminal nodig.

Vanaf de server kun je ook end-to-end naar elke gebruiker pushen:

php artisan pitchbar:webpush-test --email=you@example.com

Er wordt een melding ‘Web Push werkt’ verzonden naar de apparaten waarop die gebruiker zich heeft abonneerd. Laat --email weg om de eerste geabonneerde gebruiker te targeten, of gebruik --body="…" voor aangepaste tekst. Het commando mislukt met een duidelijke foutmelding als er geen VAPID-sleutels bestaan of als de gebruiker geen abonnement heeft, dus het dient ook als een snelle diagnose.

Problemen oplossen

  • De knop Inschakelen ontbreekt — de browser ondersteunt geen pushberichten (bijv. iOS Safari-tabblad — installeer eerst de PWA), of er zijn geen VAPID-sleutels geconfigureerd (voer het bovenstaande commando uit).
  • "Meldingen zijn geblokkeerd" — de provider heeft de toestemming voor de browser geweigerd. Je kunt deze alleen opnieuw toekennen via de site-instellingen van de browser, en daarna de pagina opnieuw laden.
  • Ingeschakeld maar er komt niets binnen — controleer of er een wachtrij-worker draait en de analytics-wachtrij leegmaakt (push-taken worden daar via verwerkt). Zie Implementatie.