For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /nl/docs/web/notifications.md (or send Accept: text/markdown).

Notificaties

In-app-meldingen, per-gebruiker-voorkeuren en admin-aankondigingen.

Vraag over deze handleiding

Walkthrough voor beginners

Vereisten: Lees de twee onderstaande beginnershandleidingen, voltooi de lokale webconfiguratie en open deze monorepo in de root van uw editor. Webinstellingen horen thuis in apps/web/.env.local; Next.js leest de root .env niet. /dashboard in de standaard nepmodus is een demo zonder database; /auth heeft een gemigreerde database nodig.

Korte termen: een werkruimte bestaat uit de afzonderlijke gebruikers, gegevens en instellingen van één team. De server is de vertrouwde backend; houd providersleutels uit de browser- en telefooncode. Een migratie is een versiebeheer van de database, waarbij tabellen worden gemaakt of bijgewerkt. Een AI-model is de motor die antwoord geeft; de modelcatalogus is de serverlijst met beschikbare model-ID's en prijzen. Een provider is een externe service, zoals een AI-, e-mail- of factureringsservice. Een recht is een subsidie waarmee een werkruimte een functie kan gebruiken. Een webhook is een bericht dat de ene service naar de URL van een andere service verzendt.

1. Meld u aan als testlid en open Instellingen → Meldingen om de beschikbare kanaalvoorkeuren te bekijken.

2. Gebruik twee testleden in één werkruimte en activeer een lokale testgebeurtenis, zoals een uitnodiging, met EMAIL_PROVIDER=local.

3. Bevestig dat alleen in aanmerking komende leden en ingeschakelde kanalen een melding ontvangen in de app of lokale outbox. Stuur geen testberichten naar echte leden.

Voor aangepaste code begint u met de meegeleverde prompts/README.md en kopieert u de dichtstbijzijnde prompt: prompts/new-app-screen.md voor een app-scherm of prompts/new-landing-page.md voor een openbare pagina. Voor server-, database- of providerwerk geeft u uw codeeragent de taak van deze handleiding en vraagt u hem om AGENTS.md, .ai/PROJECT_CONTEXT.md en overeenkomende .ai/-mirrors te lezen; inspecteer de exacte bronbestanden die hier worden genoemd; maak een lijst van bestanden en controleer deze voordat u deze bewerkt; behoud van het eigendom van de werkruimte en geheimen voor de server; en laat je het verschil zien. Vertel het gewenste gedrag, invoer- en uitvoervelden, toegestane rollen, verwacht succes en fouten, en het testaccount, de provider of het apparaat. Gebruik voorbeeldwaarden; plak nooit een echt geheim.

Gebruik de productgebeurtenispijplijn

notification-events.ts brengt facturerings-, budget-, uitnodigings-, lidmaatschaps- en verbonden accountgebeurtenissen in kaart naar gelokaliseerde kopieën en leveringsplannen per lid. De API- en app-clients lezen de meldingen van de ingelogde werkruimte; voorkeuren bepalen in aanmerking komende kanalen.

Sommige evenementen blijven opzettelijk in de app. Fouten bij het vernieuwen van verbonden accounts mogen bijvoorbeeld geen tokendetails blootleggen of ongevraagde e-mail activeren.

Respecteer de voorkeuren van de ontvanger

Gebruik de bestaande leveringsplanner, standaardvoorkeuren en opties voor het uitsluiten van actoren in plaats van afzonderlijk een bericht naar elk lid te sturen. Transactionele e-mail gebruikt nog steeds de geconfigureerde provider en registreert zijn eigen bezorgingsresultaat.

Controleer ontvangers en staat

Test een uitgeschakelde voorkeur, uitgesloten acteur, verwijderd lid, ongelezen/gelezen gedrag en een andere werkruimte. Houd dynamische updates toegankelijk en verifieer gelokaliseerde berichten.

Setup en configuratie

De notificatieservice (notification-service.ts) slaat workspace-gescopede in-app-records op; GET /api/notifications lijst ze voor het ingelogde lid en de mark-read-route werkt de status bij. Per-gebruiker-voorkeursflags sturen categorieën zoals productupdates en beveiligingswaarschuwingen.

Leden beheren voorkeuren onder /settings/notifications. Platformaankondigingen worden geschreven via announcement-actions en via dezelfde pipeline geleverd.

GET   /api/notifications
PATCH /api/notifications   (mark-read)

Emitted on mutations, e.g.:
  member.left
  member.role_changed

Implementatieworkflow

Emit een notificatie na een geslaagde mutatie — nooit voordat de schrijving is gecommit. Houd payloads gestructureerd (type, workspace, referenties) zodat de UI ze kan renderen en routeren zonder proza te parsen.

Check de voorkeursflag voordat je een uitschakelbare categorie levert; beveiligingsrelevante meldingen (nieuwe sessie, sleutelwijzigingen) moeten verplicht blijven.

Verificatie en probleemoplossing

Verifieer dat een uitgeschakelde voorkeur levering onderdrukt, dat mark-read over sessies heen persisteert, dat een andere workspace de records niet kan lijsten en dat aankondigingen de beoogde leden bereiken. Houd notificatie-fan-out buiten het kritieke requestpad naarmate het volume groeit.