Trasforma le email in fatturato con Brew.
Collega Clerk per far partire email in linea con il tuo brand quando qualcuno si registra, entra in un’organizzazione, sottoscrive un abbonamento con Clerk Billing o si iscrive alla tua lista d’attesa. Clerk firma ogni webhook e Brew trasforma 13 tipi di evento in trigger delle automazioni.
Clerk resta responsabile di accesso, organizzazioni e fatturazione. Brew si limita ad ascoltare gli eventi: non può modificare gli utenti, creare organizzazioni o addebitare gli abbonamenti.
L’evento organization.created non contiene alcun indirizzo email. Brew cerca l’ID utente del creatore tra le identità che ha già visto in eventi Clerk precedenti sul collegamento attuale. Se trova un’email reale, l’evento viene elaborato. Altrimenti Brew registra l’evento con un destinatario non risolto, non crea alcun contatto e non avvia alcuna automazione.
Iscrivi l’endpoint anche a user.created, così Brew può conoscere gli indirizzi dei creatori. Per un’email che deve arrivare a una persona in ogni caso, usa organizationMembership.created, che contiene l’indirizzo del membro.
Brew supporta questi 13 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 e clerk_user_id.
L’evento user.created imposta anche clerk_username, clerk_image_url, clerk_signed_up_at e clerk_last_sign_in_at. Gli eventi di invito e di appartenenza impostano clerk_organization_id, clerk_org_role e clerk_org_role_name. Gli inviti aggiungono clerk_org_invitation_status, le appartenenze clerk_organization_name e clerk_organization_slug.
Gli eventi di fatturazione impostano clerk_subscription_status e clerk_plan_name, e alcuni aggiungono clerk_plan_slug, clerk_subscription_period_end o clerk_is_trialing. L’evento paymentAttempt.created imposta clerk_last_payment_attempt_status e clerk_last_payment_attempt_at. L’evento waitlistEntry.created imposta clerk_waitlist_status.
Per i merge tag, usa lo schema del payload dichiarato dall’evento selezionato. Ogni evento include email, firstName, lastName e createdAt. Gli altri campi dipendono dall’evento, ad esempio planName, planAmount, roleName, organizationName e grandTotalFormatted. I campi planAmount e grandTotalAmount sono espressi nell’unità più piccola della valuta, quindi in USD 2000 corrisponde a 20,00 dollari. I timestamp sono in secondi Unix.
Gli ID degli oggetti Clerk, come gli ID di utenti, organizzazioni e abbonamenti, non sono merge tag. L’ID utente viene salvato sul contatto come clerk_user_id.
Un account Clerk non costituisce un consenso all’email di marketing. Raccogli il consenso al momento della registrazione e verificalo prima degli invii promozionali.
Non in modo affidabile. Brew riceve solo paymentAttempt.created, non gli aggiornamenti successivi del tentativo. Il suo campo status può valere pending, paid o failed, ma un pagamento che non va a buon fine dopo la creazione del tentativo arriva a Brew come evento non supportato. Per i pagamenti mancati, usa subscriptionItem.pastDue. Per indicare un totale nel testo dell’email, grandTotalFormatted contiene un valore già formattato, come $22.00.
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. Una consegna inviata con Send Example verifica il webhook ma non avvia mai un’automazione, e un evento organization.created senza un creatore noto viene registrato come non risolto.
