Transformez vos e-mails en revenus avec Brew.
Déclencheurs d’authentification
Connectez Clerk pour lancer des e-mails à l’image de votre marque quand quelqu’un s’inscrit, rejoint une organisation, souscrit un abonnement Clerk Billing ou s’ajoute à votre liste d’attente. Clerk signe chaque webhook, et Brew transforme 13 types d’événements en déclencheurs d’automatisation.
Clerk reste responsable de la connexion, des organisations et de la facturation. Brew se contente d’écouter les événements : il ne peut ni modifier les utilisateurs, ni créer d’organisations, ni facturer d’abonnements.
L’événement organization.created ne contient aucune adresse e-mail. Brew recherche l’ID utilisateur du créateur parmi les identités qu’il a déjà vues dans des événements Clerk antérieurs, sur la connexion actuelle. S’il trouve une adresse e-mail réelle, l’événement est traité. Sinon, Brew enregistre l’événement avec un destinataire non résolu, ne crée aucun contact et ne lance aucune automatisation.
Abonnez aussi l’endpoint à user.created, pour que Brew puisse connaître l’adresse des créateurs. Pour un e-mail qui doit parvenir à une personne à chaque fois, utilisez organizationMembership.created, qui contient l’adresse du membre.
Brew prend en charge les 13 types d’événements suivants :
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 et clerk_user_id.
L’événement user.created renseigne aussi clerk_username, clerk_image_url, clerk_signed_up_at et clerk_last_sign_in_at. Les événements d’invitation et d’adhésion renseignent clerk_organization_id, clerk_org_role et clerk_org_role_name. Les invitations ajoutent clerk_org_invitation_status, et les adhésions ajoutent clerk_organization_name et clerk_organization_slug.
Les événements de facturation renseignent clerk_subscription_status et clerk_plan_name, et certains ajoutent clerk_plan_slug, clerk_subscription_period_end ou clerk_is_trialing. L’événement paymentAttempt.created renseigne clerk_last_payment_attempt_status et clerk_last_payment_attempt_at. L’événement waitlistEntry.created renseigne clerk_waitlist_status.
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. Les autres champs, comme planName, planAmount, roleName, organizationName et grandTotalFormatted, dépendent de l’événement. Les champs planAmount et grandTotalAmount sont exprimés dans la plus petite unité de la devise : 2000 correspond donc à 20,00 $ en USD. Les horodatages sont exprimés en secondes Unix.
Les ID des objets Clerk, comme les ID d’utilisateur, d’organisation et d’abonnement, ne sont pas des balises de fusion. L’ID utilisateur est enregistré sur le contact dans clerk_user_id.
Un compte Clerk ne vaut pas consentement aux e-mails marketing. Enregistrez le consentement lors de l’inscription et vérifiez-le avant tout envoi promotionnel.
Pas de manière fiable. Brew ne reçoit que paymentAttempt.created, et non les mises à jour ultérieures de la tentative. Son champ status peut valoir pending, paid ou failed, mais un paiement qui échoue après la création de la tentative parvient à Brew sous la forme d’un événement non pris en charge. Pour les paiements manqués, utilisez subscriptionItem.pastDue. Pour indiquer un total dans le texte de l’e-mail, utilisez grandTotalFormatted, qui contient une valeur déjà formatée, comme $22.00.
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. Un envoi via Send Example vérifie le webhook mais ne lance jamais d’automatisation, et un événement organization.created sans créateur connu est enregistré comme non résolu.
