# WorkOS + Brew

Start automatiseringen in Brew vanuit events van WorkOS over gebruikers, authenticatie, wachtwoordherstel, organisaties, directory sync (SCIM), verbindingen en uitnodigingen.

Canonieke URL: https://brew.new/nl/browse/integrations/workos

- Richting: Inkomend
- Koppelmethode: Webhookgeheim
- Triggers voor enterprise-authenticatie

## Live mogelijkheden

- **Eventtriggers**: Start automatiseringen in Brew vanuit events van WorkOS over gebruikers, authenticatie, organisaties, directory sync en verbindingen.

## Maak van WorkOS-events nuttige e-mails

Koppel WorkOS om merkconforme e-mails te versturen wanneer een gebruiker wordt aangemaakt, een e-mailadres verifieert, een wachtwoord herstelt, lid wordt van een organisatie of via directory sync wordt toegevoegd. Brew zet 18 eventtypen van WorkOS om in triggers voor automatiseringen.

WorkOS blijft verantwoordelijk voor SSO, directory sync, inloggen en wachtwoordherstel. Brew luistert alleen naar events en maakt en verstuurt de e-mails die erop volgen.


## Wat je kunt bouwen

- Welkomstmails: WorkOS verstuurt user.created wanneer er een WorkOS-gebruiker wordt aangemaakt, en authentication.email_verification_succeeded wanneer de gebruiker het e-mailadres verifieert. Kies één trigger om twee welkomstmails te voorkomen.
- Bevestigingen van wachtwoordherstel: WorkOS verstuurt password_reset.succeeded wanneer een wachtwoordherstel is voltooid. Het is een WorkOS-event op het hoogste niveau en valt niet onder authentication.*.
- Inlogmeldingen: WorkOS verstuurt authentication.magic_auth_succeeded wanneer iemand met een magic link is ingelogd, en authentication.password_failed wanneer inloggen met een wachtwoord mislukt. Beide gaan naar de gebruiker, en geen van beide stelt het IP-adres of de user agent beschikbaar als personalisatietag.
- Teamonboarding: organization_membership.created en invitation.accepted worden allebei verstuurd wanneer iemand lid wordt, en bevatten role. Kies één trigger om twee welkomstmails te voorkomen.
- Meldingen over een rolwijziging: WorkOS verstuurt organization_membership.updated wanneer een lidmaatschap verandert, bijvoorbeeld door een nieuwe rol.
- Gebruikers uit directory sync: dsync.user.created, dsync.user.updated en dsync.user.deleted houden contacten in Brew gelijk met je SCIM-directory.
- Meldingen bij offboarding: WorkOS verstuurt user.deleted en organization_membership.deleted wanneer een gebruiker wordt verwijderd of een organisatie verlaat.

## Events over organisaties en verbindingen starten geen e-mails

organization.created, organization.updated, organization.deleted en connection.activated bevatten geen ontvanger. Brew legt ze in Recente events vast als onopgelost en start geen automatisering.

Wil je iemand mailen over een nieuwe organisatie, gebruik dan een event dat het adres van die persoon bevat, zoals organization_membership.created of invitation.accepted.

Events over lidmaatschappen, authenticatie en directory’s zonder e-mailadres kunnen toch worden verwerkt als Brew op de huidige koppeling al een echt e-mailadres heeft gezien voor dezelfde WorkOS-gebruiker, hetzelfde lidmaatschap of dezelfde directorygebruiker.


## WorkOS instellen in Brew

- Open Integraties, kies WorkOS en klik op Webhook-URL genereren.
- Open in het WorkOS Dashboard Webhooks, maak een endpoint aan en plak de URL van Brew.
- Abonneer je op de 18 ondersteunde events: user.*, authentication.email_verification_succeeded, authentication.magic_auth_succeeded, authentication.password_failed, password_reset.succeeded, organization.*, organization_membership.*, dsync.user.*, connection.activated en invitation.accepted. Selecteer niet authentication.*, want dan komen er authenticatie-events bij die Brew niet ondersteunt.
- Kopieer het ondertekeningsgeheim van het endpoint, plak het in Brew en klik op Koppelen. Brew verifieert elke levering aan de hand van de handtekeningheader van WorkOS en een tolerantie van 180 seconden voor de tijdstempel.
- Verstuur in WorkOS vanaf het endpoint een testevent user.created. De status in Brew verandert dan van “Wacht op testevent” in “Gekoppeld”. Brew slaat de voorbeeldevents van WorkOS over die het herkent, maar kan een voorbeeld dat het niet herkent als een echt event verwerken, dus verstuur de test voordat je een automatisering op die trigger publiceert.
- Bij het koppelen maakt Brew triggers aan voor alle 18 events. Er is geen schakelaar om events in of uit te schakelen.
- Maak een automatisering aan, selecteer het bijbehorende WorkOS-event en verstuur een test zolang de automatisering nog de status Concept heeft. Alleen automatiseringen met de status Live worden uitgevoerd wanneer er een overeenkomend event binnenkomt.

## Ondersteunde WorkOS-events

Brew ondersteunt de volgende 18 eventtypen:

- user.created
- user.updated
- user.deleted
- authentication.email_verification_succeeded
- authentication.password_failed
- password_reset.succeeded
- authentication.magic_auth_succeeded
- organization.created
- organization.updated
- organization.deleted
- organization_membership.created
- organization_membership.updated
- organization_membership.deleted
- dsync.user.created
- dsync.user.updated
- dsync.user.deleted
- connection.activated
- invitation.accepted

## Contactsynchronisatie en personalisatie

Elk geverifieerd event met een echt e-mailadres maakt een contact in Brew aan of werkt het contact met dat e-mailadres bij, ongeacht of een automatisering het event gebruikt. Als die gegevens er zijn, vult Brew de voor- en achternaam, workos_user_id en workos_email_verified.

Authenticatie-events vullen workos_last_verification_at, workos_last_failed_auth_at, workos_last_password_reset_at of workos_last_magic_auth_at. Events over lidmaatschappen en uitnodigingen vullen workos_organization_id en workos_org_role. Directory-events vullen workos_directory_user_id en workos_directory_id.

user.deleted en dsync.user.deleted zetten workos_account_status op deleted, en organization_membership.deleted zet het veld op removed_from_org. Brew verwijdert het contact niet.

Gebruik voor personalisatietags het gedeclareerde payloadschema van het gekozen event. Elk event bevat, voor zover beschikbaar, email, firstName, lastName en createdAt. Gebruikersevents voegen emailVerified toe, organisatie-events organizationName, en events over lidmaatschappen en uitnodigingen role. createdAt is een Unix-tijdstempel in seconden.

ID’s van WorkOS-objecten zijn geen personalisatietags, en het IP-adres en de user agent bij authenticatie-events evenmin.

Medewerkers die via directory sync binnenkomen, hebben meestal geen toestemming gegeven voor marketing. Behandel ze als ontvangers van account- en transactionele meldingen, tenzij ze apart toestemming hebben gegeven.


## Waarom verschijnt er een event zonder dat er een e-mail wordt verstuurd?

Een event ontvangen en een e-mail versturen zijn aparte stappen. Controleer of een overeenkomende automatisering op Live staat en bekijk daarna de filters, de uitvoeringsgeschiedenis, of de ontvanger in aanmerking komt en of het verzenddomein in orde is. Events over organisaties en verbindingen starten nooit automatiseringen, en een herkend testvoorbeeld van WorkOS wordt vastgelegd als testevent.


## Limieten en problemen oplossen

- Brew kan geen gebruikers, organisaties, directory’s of verbindingen in WorkOS aanmaken of wijzigen.
- Een 401 met timestamp_invalid:out_of_tolerance betekent dat de tijdstempel van de levering meer dan 180 seconden afweek. Controleer de klokafwijking en verstuur de levering daarna opnieuw vanuit het WorkOS Dashboard.
- Starten automatiseringen voor wachtwoordherstel nooit, controleer dan of het endpoint is geabonneerd op password_reset.succeeded. WorkOS verstuurt nooit authentication.password_reset_succeeded.
- Mislukt bij elke levering de handtekeningcontrole, kopieer dan het huidige geheim van het endpoint uit WorkOS en koppel opnieuw. Brew vereist dat het geheim minstens 16 tekens lang is.
- Controleer de toestemming en het doel van elke e-mail. WorkOS-gebruikers synchroniseren geeft je nog geen toestemming voor promotionele verzendingen.

## Bronnen en handleidingen

- [Handleiding voor WorkOS](https://docs.brew.new/integrations/import/workos)
- [Een automatisering bouwen](https://docs.brew.new/create-emails/build-an-automation)
- [Personalisatietags](https://docs.brew.new/create-emails/merge-tags)
- [Wat je met Brew kunt versturen](https://docs.brew.new/get-started/what-you-can-send)
- [Events in WorkOS](https://workos.com/docs/events)

## Gerelateerd

- [Alle integraties](https://brew.new/nl/browse/integrations.md)
- [Account aanmaken](https://brew.new/nl/sign-up.md)
- Website: https://brew.new