# WorkOS + Brew

Déclenchez des automatisations Brew à partir des événements WorkOS d’utilisateur, d’authentification, de réinitialisation de mot de passe, d’organisation, de synchronisation d’annuaire (SCIM), de connexion et d’invitation.

URL canonique : https://brew.new/fr/browse/integrations/workos

- Sens des données : Données entrantes
- Connexion : Secret de webhook
- Déclencheurs d’authentification entreprise

## Fonctionnalités disponibles

- **Déclencheurs par événement** : Déclenchez des automatisations Brew à partir des événements WorkOS d’utilisateur, d’authentification, d’organisation, de synchronisation d’annuaire et de connexion.

## Transformez vos événements WorkOS en e-mails utiles

Connectez WorkOS pour lancer des e-mails à l’image de votre marque quand un utilisateur est créé, vérifie son adresse e-mail, réinitialise son mot de passe, rejoint une organisation ou est provisionné par synchronisation d’annuaire. Brew transforme 18 types d’événements WorkOS en déclencheurs d’automatisation.

WorkOS reste responsable du SSO, de la synchronisation d’annuaire, de la connexion et des réinitialisations de mot de passe. Brew se contente d’écouter les événements, puis de créer et d’envoyer les e-mails qui en découlent.


## Ce que vous pouvez créer

- E-mails de bienvenue : l’événement user.created est envoyé quand un utilisateur WorkOS est provisionné. L’événement authentication.email_verification_succeeded est envoyé quand l’utilisateur vérifie son adresse e-mail. Choisissez un seul déclencheur pour éviter deux e-mails de bienvenue.
- Confirmations de réinitialisation du mot de passe : l’événement password_reset.succeeded est envoyé quand une réinitialisation aboutit. C’est un événement WorkOS de premier niveau, qui ne fait pas partie du groupe authentication.*.
- Avis de connexion : l’événement authentication.magic_auth_succeeded est envoyé quand une connexion par lien magique aboutit, et authentication.password_failed quand une connexion par mot de passe échoue. Tous deux ont l’utilisateur pour destinataire, et aucun n’expose l’adresse IP ni le user agent comme balise de fusion.
- Onboarding des équipes : les événements organization_membership.created et invitation.accepted sont tous deux envoyés quand quelqu’un rejoint une organisation, et ils contiennent role. Choisissez un seul déclencheur pour éviter deux e-mails de bienvenue.
- Avis de changement de rôle : l’événement organization_membership.updated est envoyé quand une adhésion est modifiée, par exemple en cas de nouveau rôle.
- Utilisateurs synchronisés depuis l’annuaire : les événements dsync.user.created, dsync.user.updated et dsync.user.deleted maintiennent les contacts Brew synchronisés avec votre annuaire SCIM.
- Avis de départ : les événements user.deleted et organization_membership.deleted sont envoyés quand un utilisateur est supprimé ou quitte une organisation.

## Les événements d’organisation et de connexion ne lancent aucun e-mail

Les événements organization.created, organization.updated, organization.deleted et connection.activated ne contiennent aucun destinataire. Brew les enregistre comme non résolus dans le panneau « Événements récents » et ne lance aucune automatisation.

Pour écrire à une personne au sujet d’une nouvelle organisation, utilisez un événement qui contient son adresse, comme organization_membership.created ou invitation.accepted.

Les événements d’adhésion, d’authentification et d’annuaire sans adresse e-mail peuvent tout de même être traités si Brew a déjà vu une adresse e-mail réelle pour le même utilisateur WorkOS, la même adhésion ou le même utilisateur d’annuaire sur la connexion actuelle.


## Configurer WorkOS dans Brew

- Ouvrez Intégrations, choisissez WorkOS, puis cliquez sur « Générer l’URL de webhook ».
- Dans le tableau de bord WorkOS, ouvrez Webhooks, créez un endpoint et collez l’URL Brew.
- Abonnez l’endpoint aux 18 événements pris en charge : user.*, authentication.email_verification_succeeded, authentication.magic_auth_succeeded, authentication.password_failed, password_reset.succeeded, organization.*, organization_membership.*, dsync.user.*, connection.activated et invitation.accepted. Ne sélectionnez pas authentication.*, qui ajoute des événements d’authentification que Brew ne prend pas en charge.
- Copiez le secret de signature de l’endpoint, collez-le dans Brew, puis cliquez sur « Connecter ». Brew vérifie chaque envoi grâce à l’en-tête de signature WorkOS, avec une tolérance de 180 secondes sur l’horodatage.
- Dans WorkOS, envoyez un événement de test user.created depuis l’endpoint. Dans Brew, le statut passe de « En attente d’un événement de test » à « Connecté ». Brew ignore les exemples WorkOS qu’il reconnaît, mais il peut traiter un exemple non reconnu comme un événement réel : envoyez donc le test avant de publier une automatisation sur ce déclencheur.
- La connexion crée un déclencheur pour chacun des 18 événements. Il n’existe pas d’interrupteur pour activer ou désactiver un événement.
- Créez une automatisation, sélectionnez son événement WorkOS et envoyez un test tant qu’elle est encore en brouillon. Seules les automatisations actives s’exécutent quand un événement correspondant arrive.

## Événements WorkOS pris en charge

Brew prend en charge les 18 types d’événements suivants :

- 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

## Synchronisation des contacts et personnalisation

Chaque événement vérifié qui contient une adresse e-mail réelle crée ou met à jour un contact Brew, identifié par son adresse e-mail, qu’une automatisation utilise l’événement ou non. Lorsque les données sont présentes, Brew renseigne le prénom, le nom, workos_user_id et workos_email_verified.

Les événements d’authentification renseignent workos_last_verification_at, workos_last_failed_auth_at, workos_last_password_reset_at ou workos_last_magic_auth_at. Les événements d’adhésion et d’invitation renseignent workos_organization_id et workos_org_role. Les événements d’annuaire renseignent workos_directory_user_id et workos_directory_id.

Les événements user.deleted et dsync.user.deleted donnent à workos_account_status la valeur deleted, et organization_membership.deleted lui donne la valeur removed_from_org. Brew ne supprime pas le contact.

Pour les balises de fusion, utilisez le schéma de payload déclaré par l’événement sélectionné. Tous les événements incluent email, firstName, lastName et createdAt, lorsque ces champs sont présents. Les événements d’utilisateur ajoutent emailVerified, les événements d’organisation ajoutent organizationName, et les événements d’adhésion et d’invitation ajoutent role. Le champ createdAt est un horodatage Unix en secondes.

Les ID des objets WorkOS ne sont pas des balises de fusion, pas plus que l’adresse IP et le user agent des événements d’authentification.

Les employés synchronisés depuis un annuaire n’ont généralement pas consenti à recevoir des communications marketing. Considérez-les comme destinataires d’avis liés au compte et d’e-mails transactionnels, sauf s’ils ont donné leur consentement séparément.


## Pourquoi un événement apparaît-il sans qu’aucun e-mail ne soit envoyé ?

Recevoir un événement et envoyer un e-mail sont deux étapes distinctes. Vérifiez qu’une automatisation correspondante est active, puis contrôlez ses filtres, son historique d’exécution, l’éligibilité du destinataire et le domaine d’envoi. Les événements d’organisation et de connexion ne lancent jamais d’automatisation, et un exemple de test WorkOS reconnu est enregistré comme événement de test.


## Limites et dépannage

- Brew ne peut ni créer ni modifier les utilisateurs, organisations, annuaires ou connexions WorkOS.
- Une erreur 401 avec timestamp_invalid:out_of_tolerance signifie que l’horodatage de l’envoi s’écartait de plus de 180 secondes. Vérifiez le décalage d’horloge, puis renvoyez l’événement depuis le tableau de bord WorkOS.
- Si les automatisations de réinitialisation du mot de passe ne se déclenchent jamais, vérifiez que l’endpoint est abonné à password_reset.succeeded. WorkOS n’envoie jamais authentication.password_reset_succeeded.
- Si chaque envoi échoue à la vérification de signature, copiez le secret actuel de l’endpoint depuis WorkOS et reconnectez WorkOS. Brew exige un secret d’au moins 16 caractères.
- Vérifiez le consentement et la finalité de chaque e-mail. Synchroniser vos utilisateurs WorkOS n’autorise pas les envois promotionnels.

## Sources et guides de configuration

- [Guide de configuration de WorkOS](https://docs.brew.new/integrations/import/workos)
- [Créer une automatisation](https://docs.brew.new/create-emails/build-an-automation)
- [Balises de fusion](https://docs.brew.new/create-emails/merge-tags)
- [Ce que vous pouvez envoyer avec Brew](https://docs.brew.new/get-started/what-you-can-send)
- [Événements WorkOS](https://workos.com/docs/events)

## Voir aussi

- [Toutes les intégrations](https://brew.new/fr/browse/integrations.md)
- [Inscription](https://brew.new/fr/sign-up.md)
- Site web : https://brew.new