# WorkOS + Brew

Starta automatiseringar i Brew med händelser från WorkOS för användare, autentisering, återställning av lösenord, organisationer, Directory Sync (SCIM), anslutningar och inbjudningar.

Kanonisk URL: https://brew.new/sv/browse/integrations/workos

- Riktning: Inkommande data
- Anslutning: Webhook-hemlighet
- Utlösare för företagsautentisering

## Tillgängliga funktioner

- **Händelseutlösare**: Starta automatiseringar i Brew med händelser från WorkOS för användare, autentisering, organisationer, Directory Sync och anslutningar.

## Gör WorkOS-händelser till användbara mejl

Anslut WorkOS för att trigga varumärkesenliga mejl när en användare skapas, verifierar sin e-postadress, återställer ett lösenord, går med i en organisation eller provisioneras via Directory Sync. Brew gör 18 händelsetyper från WorkOS till utlösare för automatiseringar.

WorkOS ansvarar fortfarande för SSO, Directory Sync, inloggning och återställning av lösenord. Brew lyssnar bara efter händelser och skapar och skickar mejlen som följer på dem.


## Det här kan du bygga

- Välkomstmejl: händelsen user.created utlöses när en användare provisioneras i WorkOS. Händelsen authentication.email_verification_succeeded utlöses när användaren verifierar sin e-postadress. Välj en enda utlösare, så att ingen får två välkomstmejl.
- Bekräftelser av återställda lösenord: händelsen password_reset.succeeded utlöses när en återställning har slutförts. Det är en händelse på toppnivå i WorkOS och ingår inte i authentication.*.
- Aviseringar om inloggningar: händelsen authentication.magic_auth_succeeded utlöses när en inloggning via magisk länk har slutförts, och authentication.password_failed när en inloggning med lösenord misslyckas. Båda går till användaren, och ingen av dem gör IP-adressen eller användaragenten tillgänglig som personaliseringstagg.
- Onboarding av teammedlemmar: händelserna organization_membership.created och invitation.accepted utlöses båda när någon går med, och båda innehåller role. Välj en enda utlösare, så att ingen får två välkomstmejl.
- Aviseringar om rollbyten: händelsen organization_membership.updated utlöses när ett medlemskap ändras, till exempel vid en ny roll.
- Användare från Directory Sync: händelserna dsync.user.created, dsync.user.updated och dsync.user.deleted håller kontakterna i Brew i synk med din SCIM-katalog.
- Aviseringar vid offboarding: händelserna user.deleted och organization_membership.deleted utlöses när en användare raderas eller lämnar en organisation.

## Organisations- och anslutningshändelser startar inga mejl

Händelserna organization.created, organization.updated, organization.deleted och connection.activated har ingen mottagare. Brew registrerar dem utan känd mottagare under Senaste händelser och startar ingen automatisering.

För att mejla en person om en ny organisation använder du en händelse som innehåller personens adress, till exempel organization_membership.created eller invitation.accepted.

Händelser för medlemskap, autentisering och kataloger som saknar e-postadress kan ändå bearbetas om Brew redan har sett en riktig e-postadress för samma användare, medlemskap eller kataloganvändare i WorkOS i den aktuella anslutningen.


## Konfigurera WorkOS i Brew

- Öppna Integrationer, välj WorkOS och klicka på Generera webhook-URL.
- Öppna Webhooks i kontrollpanelen för WorkOS, skapa en slutpunkt och klistra in URL:en från Brew.
- Prenumerera på de 18 händelser som stöds: user.*, authentication.email_verification_succeeded, authentication.magic_auth_succeeded, authentication.password_failed, password_reset.succeeded, organization.*, organization_membership.*, dsync.user.*, connection.activated och invitation.accepted. Välj inte authentication.*, eftersom det lägger till autentiseringshändelser som Brew inte stöder.
- Kopiera slutpunktens signeringshemlighet, klistra in den i Brew och klicka på Anslut. Brew verifierar varje leverans med signaturheadern från WorkOS och en tolerans på 180 sekunder för tidsstämpeln.
- Skicka en testhändelse av typen user.created från slutpunkten i WorkOS. Statusen i Brew ändras från ”Väntar på testhändelse” till ”Ansluten”. Brew hoppar över exempelhändelser från WorkOS som känns igen, men ett exempel som inte känns igen kan bearbetas som en riktig händelse, så skicka testet innan du publicerar en automatisering som använder den utlösaren.
- När du klickar på Anslut skapas utlösare för alla 18 händelser. Det finns inget reglage för att aktivera eller inaktivera händelser.
- Skapa en automatisering, välj dess WorkOS-händelse och skicka ett testutskick medan den fortfarande är ett utkast. Bara aktiva automatiseringar körs när en matchande händelse kommer in.

## WorkOS-händelser som stöds

Brew stöder följande 18 händelsetyper:

- 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

## Kontaktsynk och personalisering

Varje verifierad händelse med en riktig e-postadress skapar eller uppdaterar en kontakt i Brew, som matchas på e-postadressen, oavsett om någon automatisering använder händelsen. När uppgifterna finns sätter Brew för- och efternamn, workos_user_id och workos_email_verified.

Autentiseringshändelser sätter workos_last_verification_at, workos_last_failed_auth_at, workos_last_password_reset_at eller workos_last_magic_auth_at. Händelser för medlemskap och inbjudningar sätter workos_organization_id och workos_org_role. Kataloghändelser sätter workos_directory_user_id och workos_directory_id.

Händelserna user.deleted och dsync.user.deleted sätter workos_account_status till deleted, och organization_membership.deleted sätter fältet till removed_from_org. Brew tar inte bort kontakten.

Använd den valda händelsens deklarerade nyttolastschema för personaliseringstaggar. Varje händelse innehåller email, firstName, lastName och createdAt när de finns. Användarhändelser lägger till emailVerified, organisationshändelser lägger till organizationName och händelser för medlemskap och inbjudningar lägger till role. Fältet createdAt är en Unix-tidsstämpel i sekunder.

Objekt-ID:n från WorkOS är inga personaliseringstaggar, och det är inte heller IP-adressen och användaragenten i autentiseringshändelser.

Anställda som synkas via Directory Sync har oftast inte gett sitt samtycke till marknadsföring. Behandla dem som mottagare av konto- och transaktionsmeddelanden, om de inte har gett sitt samtycke separat.


## Varför syns en händelse utan att något mejl skickas?

Att ta emot en händelse och att skicka ett mejl är separata steg. Kontrollera att en matchande automatisering är aktiv, granska dess filter och körningshistorik och se över mottagarens nåbarhet och avsändardomänen. Organisations- och anslutningshändelser startar aldrig automatiseringar, och ett testexempel från WorkOS som känns igen registreras som en testhändelse.


## Begränsningar och felsökning

- Brew kan inte skapa eller ändra användare, organisationer, kataloger eller anslutningar i WorkOS.
- Ett 401-svar med timestamp_invalid:out_of_tolerance betyder att leveransens tidsstämpel avvek med mer än 180 sekunder. Kontrollera om det finns en klockavvikelse och skicka sedan leveransen igen från kontrollpanelen för WorkOS.
- Om automatiseringar för lösenordsåterställning aldrig utlöses kontrollerar du att slutpunkten prenumererar på password_reset.succeeded. WorkOS skickar aldrig authentication.password_reset_succeeded.
- Om varje leverans underkänns i signaturkontrollen kopierar du slutpunktens aktuella hemlighet från WorkOS och ansluter igen. Brew kräver att hemligheten är minst 16 tecken lång.
- Se över samtycket och syftet med varje mejl. Att synka användare från WorkOS ger inte rätt att skicka marknadsföring.

## Källor och konfigurationsguider

- [Konfigurationsguide för WorkOS](https://docs.brew.new/integrations/import/workos)
- [Bygg en automatisering](https://docs.brew.new/create-emails/build-an-automation)
- [Personaliseringstaggar](https://docs.brew.new/create-emails/merge-tags)
- [Vad du kan skicka med Brew](https://docs.brew.new/get-started/what-you-can-send)
- [Händelser i WorkOS](https://workos.com/docs/events)

## Relaterat

- [Alla integrationer](https://brew.new/sv/browse/integrations.md)
- [Skapa konto](https://brew.new/sv/sign-up.md)
- Webbplats: https://brew.new