# WorkOS + Brew

Avvia le automazioni di Brew dagli eventi WorkOS su utenti, autenticazione, reimpostazione della password, organizzazioni, sincronizzazione delle directory (SCIM), collegamenti e inviti.

URL canonico: https://brew.new/it/browse/integrations/workos

- Direzione: Dati in entrata
- Collegamento: Secret del webhook
- Trigger di autenticazione enterprise

## Funzionalità disponibili

- **Trigger da evento**: Avvia le automazioni di Brew dagli eventi WorkOS su utenti, autenticazione, organizzazioni, sincronizzazione delle directory e collegamenti.

## Trasforma gli eventi di WorkOS in email utili

Collega WorkOS per far partire email in linea con il tuo brand quando un utente viene creato, verifica la propria email, reimposta una password, entra in un’organizzazione o viene aggiunto tramite la sincronizzazione delle directory. Brew trasforma 18 tipi di evento di WorkOS in trigger delle automazioni.

WorkOS resta responsabile di SSO, sincronizzazione delle directory, accesso e reimpostazione della password. Brew si limita ad ascoltare gli eventi e a creare e inviare le email che li seguono.


## Cosa puoi creare

- Email di benvenuto: l’evento user.created scatta quando viene creato un utente WorkOS. L’evento authentication.email_verification_succeeded scatta quando l’utente verifica la propria email. Scegli un solo trigger per non inviare due volte il benvenuto.
- Conferme di reimpostazione della password: l’evento password_reset.succeeded scatta quando una reimpostazione viene completata. È un evento WorkOS di primo livello e non fa parte di authentication.*.
- Avvisi di accesso: l’evento authentication.magic_auth_succeeded scatta quando viene completato un accesso tramite magic link, e authentication.password_failed quando un accesso con password non riesce. In entrambi i casi il destinatario è l’utente, e nessuno dei due eventi espone l’indirizzo IP o lo user agent come merge tag.
- Onboarding del team: gli eventi organization_membership.created e invitation.accepted scattano entrambi quando qualcuno entra in un’organizzazione, e contengono role. Scegli un solo trigger per non inviare due volte il benvenuto.
- Avvisi di cambio di ruolo: l’evento organization_membership.updated scatta quando un’appartenenza cambia, ad esempio per un nuovo ruolo.
- Utenti sincronizzati dalla directory: gli eventi dsync.user.created, dsync.user.updated e dsync.user.deleted mantengono i contatti di Brew allineati con la tua directory SCIM.
- Avvisi di offboarding: gli eventi user.deleted e organization_membership.deleted scattano quando un utente viene eliminato o lascia un’organizzazione.

## Gli eventi delle organizzazioni e dei collegamenti non avviano email

Gli eventi organization.created, organization.updated, organization.deleted e connection.activated non contengono alcun destinatario. Brew li registra in Eventi recenti come non risolti e non avvia alcuna automazione.

Per inviare a una persona un’email su una nuova organizzazione, usa un evento che contiene il suo indirizzo, come organization_membership.created o invitation.accepted.

Gli eventi di appartenenza, autenticazione e directory senza indirizzo email possono comunque essere elaborati se Brew ha già visto un’email reale per lo stesso utente WorkOS, la stessa appartenenza o lo stesso utente della directory sul collegamento attuale.


## Configura WorkOS in Brew

- Apri Integrazioni, scegli WorkOS e seleziona Genera l’URL del webhook.
- Nella dashboard di WorkOS, apri Webhooks, crea un endpoint e incolla l’URL di Brew.
- Iscrivi l’endpoint ai 18 eventi supportati: user.*, authentication.email_verification_succeeded, authentication.magic_auth_succeeded, authentication.password_failed, password_reset.succeeded, organization.*, organization_membership.*, dsync.user.*, connection.activated e invitation.accepted. Non selezionare authentication.*, che aggiunge eventi di autenticazione non supportati da Brew.
- Copia il secret di firma dell’endpoint, incollalo in Brew e seleziona Collega. Brew verifica ogni consegna con l’header della firma di WorkOS e una tolleranza di 180 secondi sul timestamp.
- In WorkOS, invia dall’endpoint un evento user.created di test. In Brew lo stato passa da “In attesa dell’evento di test” a “Collegato”. Brew ignora gli esempi di WorkOS che riconosce, ma potrebbe elaborare un esempio non riconosciuto come un evento reale, quindi invia il test prima di pubblicare un’automazione su quel trigger.
- Il collegamento crea un trigger per ciascuno dei 18 eventi. Non esiste un interruttore per attivare o disattivare gli eventi.
- Crea un’automazione, seleziona il suo evento WorkOS e invia un test mentre è ancora in bozza. Quando arriva un evento corrispondente, vengono eseguite solo le automazioni attive.

## Eventi WorkOS supportati

Brew supporta questi 18 tipi di evento:

- 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

## Sincronizzazione dei contatti e personalizzazione

Ogni evento verificato con un indirizzo email reale crea o aggiorna un contatto di Brew, abbinato in base all’email, che un’automazione usi o meno l’evento. Quando i dati sono presenti, Brew imposta nome, cognome, workos_user_id e workos_email_verified.

Gli eventi di autenticazione impostano workos_last_verification_at, workos_last_failed_auth_at, workos_last_password_reset_at o workos_last_magic_auth_at. Gli eventi di appartenenza e di invito impostano workos_organization_id e workos_org_role. Gli eventi della directory impostano workos_directory_user_id e workos_directory_id.

Gli eventi user.deleted e dsync.user.deleted impostano workos_account_status su deleted, mentre organization_membership.deleted lo imposta su removed_from_org. Brew non rimuove il contatto.

Per i merge tag, usa lo schema del payload dichiarato dall’evento selezionato. Ogni evento include email, firstName, lastName e createdAt, quando presenti. Gli eventi degli utenti aggiungono emailVerified, quelli delle organizzazioni organizationName, e quelli di appartenenza e di invito role. Il campo createdAt è un timestamp Unix in secondi.

Gli ID degli oggetti WorkOS non sono merge tag, e non lo sono nemmeno l’indirizzo IP e lo user agent degli eventi di autenticazione.

I dipendenti sincronizzati dalla directory di solito non hanno dato il consenso al marketing. Considerali destinatari di avvisi sull’account e di comunicazioni transazionali, a meno che non abbiano dato il consenso separatamente.


## Perché un evento compare senza che venga inviata un’email?

Ricevere un evento e inviare un’email sono passaggi separati. Verifica che un’automazione corrispondente sia attiva, poi controlla i suoi filtri, la cronologia delle esecuzioni, l’idoneità del destinatario e il dominio di invio. Gli eventi delle organizzazioni e dei collegamenti non avviano mai automazioni, e un esempio di test di WorkOS riconosciuto viene registrato come evento di test.


## Limiti e risoluzione dei problemi

- Brew non può creare né modificare utenti, organizzazioni, directory o collegamenti di WorkOS.
- Un errore 401 con timestamp_invalid:out_of_tolerance significa che il timestamp della consegna si discostava di oltre 180 secondi. Controlla il disallineamento dell’orologio, poi invia di nuovo la consegna dalla dashboard di WorkOS.
- Se le automazioni di reimpostazione della password non partono mai, verifica che l’endpoint sia iscritto a password_reset.succeeded. WorkOS non invia mai authentication.password_reset_succeeded.
- Se nessuna consegna supera la verifica della firma, copia da WorkOS il secret attuale dell’endpoint e ricollega WorkOS. Brew richiede che il secret sia lungo almeno 16 caratteri.
- Verifica il consenso e la finalità di ogni email. Sincronizzare gli utenti WorkOS non autorizza gli invii promozionali.

## Fonti e guide alla configurazione

- [Guida alla configurazione di WorkOS](https://docs.brew.new/integrations/import/workos)
- [Crea un’automazione](https://docs.brew.new/create-emails/build-an-automation)
- [Merge tag](https://docs.brew.new/create-emails/merge-tags)
- [Cosa puoi inviare con Brew](https://docs.brew.new/get-started/what-you-can-send)
- [Eventi di WorkOS](https://workos.com/docs/events)

## Correlati

- [Tutte le integrazioni](https://brew.new/it/browse/integrations.md)
- [Registrati](https://brew.new/it/sign-up.md)
- Sito web: https://brew.new