Verbinde WorkOS, um markenkonforme E-Mails auszulösen, wenn ein Nutzer angelegt wird, die E-Mail-Adresse verifiziert, ein Passwort zurücksetzt, einer Organisation beitritt oder über Directory Sync bereitgestellt wird. Brew macht aus 18 Event-Typen von WorkOS Trigger für Automatisierungen.
Für SSO, Directory Sync, Anmeldung und Passwort-Resets bleibt WorkOS zuständig. Brew nimmt nur Events entgegen und erstellt und versendet die E-Mails, die darauf folgen.
Die Events organization.created, organization.updated, organization.deleted und connection.activated enthalten keinen Empfänger. Brew erfasst sie unter „Letzte Events“ als nicht aufgelöst und startet keine Automatisierung.
Um einer Person eine E-Mail zu einer neuen Organisation zu schicken, nutze ein Event, das ihre Adresse enthält, etwa organization_membership.created oder invitation.accepted.
Mitgliedschafts-, Authentifizierungs- und Directory-Events ohne E-Mail-Adresse können trotzdem weiterverarbeitet werden, wenn Brew über die aktuelle Verbindung bereits eine echte E-Mail-Adresse für denselben WorkOS-Nutzer, dieselbe Mitgliedschaft oder denselben Directory-Nutzer gesehen hat.
Brew unterstützt diese 18 Event-Typen:
Jedes verifizierte Event mit einer echten E-Mail-Adresse legt einen Brew-Kontakt an oder aktualisiert ihn – zugeordnet über die E-Mail-Adresse und unabhängig davon, ob eine Automatisierung das Event nutzt. Wenn die Daten vorhanden sind, setzt Brew Vor- und Nachname, workos_user_id und workos_email_verified.
Authentifizierungs-Events setzen workos_last_verification_at, workos_last_failed_auth_at, workos_last_password_reset_at oder workos_last_magic_auth_at. Mitgliedschafts- und Einladungs-Events setzen workos_organization_id und workos_org_role, Directory-Events workos_directory_user_id und workos_directory_id.
Die Events user.deleted und dsync.user.deleted setzen workos_account_status auf deleted, organization_membership.deleted setzt das Feld auf removed_from_org. Brew entfernt den Kontakt nicht.
Richte dich bei Merge-Tags nach dem deklarierten Payload-Schema des gewählten Events. Jedes Event enthält email, firstName, lastName und createdAt, sofern vorhanden. Nutzer-Events ergänzen emailVerified, Organisations-Events organizationName und Mitgliedschafts- und Einladungs-Events role. Das Feld createdAt ist ein Unix-Zeitstempel in Sekunden.
IDs von WorkOS-Objekten sind keine Merge-Tags, ebenso wenig IP-Adresse und User-Agent aus Authentifizierungs-Events.
Mitarbeitende, die über Directory Sync synchronisiert werden, haben in der Regel nicht in Marketing eingewilligt. Behandle sie als Empfänger von Konto- und Transaktionshinweisen, sofern sie nicht separat eingewilligt haben.
Ein Event zu empfangen und eine E-Mail zu senden, sind getrennte Schritte. Prüfe, ob eine passende Automatisierung live ist, sieh dir dann ihre Filter und ihren Ausführungsverlauf an und prüfe, ob der Empfänger erreichbar und die Versanddomain bereit ist. Organisations- und Verbindungs-Events starten nie Automatisierungen, und ein erkanntes Beispiel-Event von WorkOS wird als Test-Event erfasst.
