IntegrazioneTrigger di autenticazione enterprise
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.
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.
Brew supporta questi 18 tipi di evento:
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 degli utenti impostano anche workos_external_id, workos_account_status, workos_created_at, workos_last_sign_in_at e workos_avatar_url, e i valori dei metadati vengono salvati come workos_metadata_<key>.
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, workos_org_role e workos_org_membership_status, che vale invited, active o removed. Gli eventi della directory impostano workos_directory_user_id, workos_directory_id, workos_job_title e workos_account_status.
Il campo workos_account_status vale active, disabled per un utente della directory inattivo, oppure deleted dopo user.deleted o dsync.user.deleted. Un’eliminazione o un utente della directory disattivato annulla l’iscrizione di un contatto esistente, a meno che il contatto non abbia un ID utente WorkOS o un ID utente della directory diverso, e non crea mai un contatto. L’evento organization_membership.deleted imposta workos_org_membership_status su removed e non annulla l’iscrizione del contatto. 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.
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.
Prova gratuita di 7 giorni. Carta di credito richiesta, disdici quando vuoi.