IntegrazioneTrigger da eventi di autenticazione
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 17 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 17 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.
Gli eventi user.created e user.updated impostano clerk_account_status, clerk_created_at, clerk_last_sign_in_at, clerk_last_active_at, clerk_email_verified, clerk_phone, clerk_username, clerk_avatar_url, clerk_auth_provider e clerk_external_id. I valori scalari di public_metadata vengono salvati come clerk_metadata_<key>.
Il campo clerk_account_status vale active, banned quando Clerk banna l’utente, oppure deleted dopo user.deleted. Un ban o un’eliminazione annulla l’iscrizione di un contatto esistente, a meno che il contatto non abbia un clerk_user_id diverso, e non crea mai un contatto. La revoca del ban riporta lo stato su active, ma non iscrive di nuovo il contatto. L’evento user.deleted contiene solo l’ID utente, quindi Brew usa l’indirizzo email che ha visto per quell’utente in un evento Clerk precedente. Se non ne ha uno, l’evento viene registrato come non risolto.
Gli eventi di invito e di appartenenza impostano clerk_organization_id, clerk_org_role e clerk_org_role_name, oltre a clerk_organization_name e clerk_organization_slug quando l’evento li contiene. Il campo clerk_org_membership_status vale invited, active o removed. Lasciare un’organizzazione non annulla l’iscrizione del contatto.
Gli eventi di fatturazione impostano clerk_subscription_status con i valori di Stripe, come trialing, active, past_due, canceled e incomplete_expired. L’evento subscriptionItem.canceled lascia lo stato su active e imposta clerk_cancel_at_period_end su true, perché Clerk mantiene il piano fino alla fine del periodo. Poi subscriptionItem.ended lo imposta su canceled e svuota i campi del piano. Gli eventi di fatturazione impostano anche clerk_subscription_plan, clerk_subscription_plan_slug, clerk_plan_amount_cents, clerk_plan_interval, clerk_currency, clerk_renews_at e clerk_trial_ends_at, quando l’evento li contiene.
L’evento paymentAttempt.created imposta clerk_last_payment_attempt_status, clerk_last_payment_attempt_at e clerk_last_payment_amount_cents. I campi che terminano in _cents sono espressi nell’unità più piccola della valuta, e clerk_currency è un codice ISO 4217 in minuscolo, ad esempio usd. 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 o user.deleted senza un indirizzo email noto viene registrato come non risolto.
Prova gratuita di 7 giorni. Carta di credito richiesta, disdici quando vuoi.