# WorkOS + Brew

Spouštěj automatizace v Brew pomocí událostí ze služby WorkOS: uživatelé, autentizace, obnovení hesla, organizace, synchronizace adresářů (SCIM), připojení a pozvánky.

Kanonická URL: https://brew.new/cs/browse/integrations/workos

- Směr: Příchozí data
- Připojení: Tajemství webhooku
- Spouštěče podnikové autentizace

## Dostupné funkce

- **Spouštěče událostí**: Spouštěj automatizace v Brew pomocí událostí ze služby WorkOS: uživatelé, autentizace, organizace, synchronizace adresářů a připojení.

## Udělej z událostí WorkOS užitečné e-maily

Připoj WorkOS a spouštěj e-maily v duchu značky, když je uživatel vytvořen, ověří svůj e-mail, obnoví heslo, připojí se k organizaci nebo je zřízen přes synchronizaci adresářů. Brew promění 18 typů událostí ze služby WorkOS ve spouštěče automatizací.

SSO, synchronizaci adresářů, přihlašování a obnovu hesla má dál na starosti WorkOS. Brew události jen přijímá a vytváří a posílá e-maily, které na ně navazují.


## Co můžeš vytvořit

- Uvítací e-maily: událost user.created nastane, když se ve službě WorkOS zřídí uživatel. Událost authentication.email_verification_succeeded nastane, když uživatel ověří svůj e-mail. Vyber jen jeden spouštěč, aby uvítání nepřišlo dvakrát.
- Potvrzení obnovy hesla: událost password_reset.succeeded nastane po dokončení obnovy hesla. Jde o samostatnou událost WorkOS na nejvyšší úrovni, ne o součást authentication.*.
- Oznámení o přihlášení: událost authentication.magic_auth_succeeded nastane po úspěšném přihlášení přes magic link a authentication.password_failed, když se nepodaří přihlášení heslem. Obě míří na uživatele a ani jedna nezpřístupňuje IP adresu ani user agent jako proměnnou.
- Onboarding týmu: události organization_membership.created i invitation.accepted nastanou, když se někdo připojí, a obě obsahují pole role. Vyber jen jeden spouštěč, aby uvítání nepřišlo dvakrát.
- Oznámení o změně role: událost organization_membership.updated nastane, když se změní členství, například role.
- Uživatelé ze synchronizace adresářů: události dsync.user.created, dsync.user.updated a dsync.user.deleted udržují kontakty v Brew v souladu s tvým adresářem SCIM.
- Oznámení o odchodu: události user.deleted a organization_membership.deleted nastanou, když je uživatel smazán nebo opustí organizaci.

## Události organizací a připojení žádné e-maily nespouštějí

Události organization.created, organization.updated, organization.deleted a connection.activated neobsahují příjemce. Brew je v sekci Nedávné události zaznamená s nedohledaným příjemcem a nespustí žádnou automatizaci.

Pokud chceš o nové organizaci informovat konkrétního člověka, použij událost, která obsahuje jeho adresu, například organization_membership.created nebo invitation.accepted.

Události členství, autentizace a adresářů bez e-mailové adresy se přesto můžou zpracovat, pokud Brew na aktuálním připojení už zachytil skutečný e-mail pro stejného uživatele, členství nebo uživatele adresáře ve službě WorkOS.


## Nastavení WorkOS v Brew

- Otevři Integrace, vyber WorkOS a klikni na Vygenerovat URL webhooku.
- V administraci WorkOS otevři Webhooks, vytvoř endpoint a vlož URL z Brew.
- Nastav odběr 18 podporovaných událostí: user.*, authentication.email_verification_succeeded, authentication.magic_auth_succeeded, authentication.password_failed, password_reset.succeeded, organization.*, organization_membership.*, dsync.user.*, connection.activated a invitation.accepted. Nevybírej authentication.*, protože tím přidáš i události autentizace, které Brew nepodporuje.
- Zkopíruj podpisové tajemství endpointu, vlož ho do Brew a klikni na Připojit. Brew každé doručení ověřuje pomocí hlavičky s podpisem WorkOS a s tolerancí časového razítka 180 sekund.
- Ve službě WorkOS pošli z endpointu testovací událost user.created. Stav v Brew se změní z „Čeká na testovací událost“ na „Připojeno“. Ukázky WorkOS, které Brew rozpozná, přeskočí, ale nerozpoznanou ukázku může zpracovat jako skutečnou událost, takže test pošli dřív, než publikuješ automatizaci s tímto spouštěčem.
- Po kliknutí na Připojit vzniknou spouštěče pro všech 18 událostí. Jednotlivé události nejde zapnout ani vypnout.
- Vytvoř automatizaci, vyber pro ni událost ze služby WorkOS a pošli test, dokud je to ještě koncept. Když dorazí odpovídající událost, spustí se jen aktivní automatizace.

## Podporované události WorkOS

Brew podporuje těchto 18 typů událostí:

- 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

## Synchronizace kontaktů a personalizace

Každá ověřená událost se skutečnou e-mailovou adresou vytvoří nebo aktualizuje kontakt v Brew s touto adresou, a to bez ohledu na to, jestli událost používá nějaká automatizace. Pokud jsou data k dispozici, Brew nastaví jméno, příjmení, workos_user_id a workos_email_verified.

Události autentizace nastaví workos_last_verification_at, workos_last_failed_auth_at, workos_last_password_reset_at nebo workos_last_magic_auth_at. Události členství a pozvánek nastaví workos_organization_id a workos_org_role. Události adresářů nastaví workos_directory_user_id a workos_directory_id.

Události user.deleted a dsync.user.deleted nastaví workos_account_status na deleted a organization_membership.deleted na removed_from_org. Brew kontakt neodstraní.

Pro proměnné vycházej z deklarovaného schématu payloadu vybrané události. Každá událost obsahuje pole email, firstName, lastName a createdAt, pokud jsou k dispozici. Události uživatelů přidávají emailVerified, události organizací organizationName a události členství a pozvánek pole role. Pole createdAt je unixové časové razítko v sekundách.

Proměnnými nejsou identifikátory objektů WorkOS ani IP adresa a user agent u událostí autentizace.

Zaměstnanci ze synchronizace adresářů obvykle souhlas s marketingem nedali. Ber je jako příjemce oznámení k účtu a transakčních zpráv, pokud se k marketingu nepřihlásili zvlášť.


## Proč se událost zobrazí, ale e-mail neodejde?

Přijetí události a odeslání e-mailu jsou samostatné kroky. Ověř, že odpovídající automatizace je aktivní, a pak projdi její filtry a historii běhů a zkontroluj, jestli má příjemce na e-mail nárok a jak je na tom odesílací doména. Události organizací a připojení nikdy nespustí žádnou automatizaci a rozpoznaná testovací ukázka WorkOS se zaznamená jako testovací událost.


## Omezení a řešení potíží

- Brew nemůže vytvářet ani měnit uživatele, organizace, adresáře ani připojení ve službě WorkOS.
- Chyba 401 s kódem timestamp_invalid:out_of_tolerance znamená, že se časové razítko doručení lišilo o víc než 180 sekund. Zkontroluj, jestli se hodiny nerozcházejí, a pak událost doruč znovu z administrace WorkOS.
- Pokud se automatizace pro obnovu hesla nikdy nespustí, ověř, že endpoint odebírá událost password_reset.succeeded. WorkOS událost authentication.password_reset_succeeded nikdy neposílá.
- Pokud žádné doručení neprojde kontrolou podpisu, zkopíruj ze služby WorkOS aktuální tajemství endpointu a připoj WorkOS znovu. Brew vyžaduje, aby tajemství mělo alespoň 16 znaků.
- U každého e-mailu zkontroluj souhlas a účel. Synchronizace uživatelů ze služby WorkOS tě neopravňuje k propagačním rozesílkám.

## Zdroje a návody k nastavení

- [Návod k nastavení WorkOS](https://docs.brew.new/integrations/import/workos)
- [Vytvoř automatizaci](https://docs.brew.new/create-emails/build-an-automation)
- [Proměnné](https://docs.brew.new/create-emails/merge-tags)
- [Co můžeš posílat přes Brew](https://docs.brew.new/get-started/what-you-can-send)
- [Události WorkOS](https://workos.com/docs/events)

## Související

- [Všechny integrace](https://brew.new/cs/browse/integrations.md)
- [Registrace](https://brew.new/cs/sign-up.md)
- Web: https://brew.new