# Clerk + Brew

Avvia le automazioni di Brew dagli eventi webhook di Clerk: registrazioni degli utenti, modifiche alle organizzazioni, abbonamenti a pagamento e iscrizioni alla lista d’attesa.

URL canonico: https://brew.new/it/browse/integrations/clerk

- Direzione: Dati in entrata
- Collegamento: Secret del webhook
- Trigger da eventi di autenticazione

## Funzionalità disponibili

- **Trigger da evento**: Avvia le automazioni di Brew da 13 eventi webhook di Clerk nelle categorie utente, organizzazione, fatturazione e lista d’attesa.

## Trasforma gli eventi di Clerk in email utili

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.


## Cosa puoi creare

- Email di benvenuto: l’evento user.created scatta quando un nuovo utente si registra. Oltre al nome, sono disponibili username, imageUrl e lastSignInAt.
- Onboarding del team: l’evento organizationMembership.created contiene organizationName, organizationSlug e roleName del nuovo membro, che abbia accettato un invito o che sia stato aggiunto direttamente. Anche l’evento organizationInvitation.accepted scatta quando un invito viene accettato, quindi scegli un solo trigger per non inviare due volte il benvenuto.
- Follow-up sugli inviti: gli eventi organizationInvitation.created, organizationInvitation.accepted e organizationInvitation.revoked hanno come destinatario l’indirizzo invitato e contengono roleName, status ed expiresAt. Non contengono né il nome dell’organizzazione, né chi ha inviato l’invito, né un link per accettarlo.
- Email di benvenuto per gli abbonati: l’evento subscription.created contiene planName, planSlug, planAmount, currency, periodStart e periodEnd.
- Promemoria di fine prova: l’evento subscriptionItem.freeTrialEnding scatta poco prima che una prova gratuita di Clerk Billing diventi un abbonamento a pagamento, con planName, planAmount, currency e periodEnd.
- Avvisi di pagamento in ritardo: l’evento subscriptionItem.pastDue scatta quando una voce dell’abbonamento risulta non pagata. Inserisci un link alla tua pagina di fatturazione.
- Follow-up dopo una disdetta o una prova abbandonata: l’evento subscriptionItem.canceled scatta quando una voce viene disdetta. L’evento subscriptionItem.abandoned di solito indica che una prova è terminata senza un metodo di pagamento registrato.
- Conferme di iscrizione alla lista d’attesa: l’evento waitlistEntry.created scatta quando un indirizzo email viene aggiunto alla tua lista d’attesa di Clerk.

## Gli eventi delle organizzazioni richiedono un creatore noto

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.


## Configura Clerk in Brew

- Apri Integrazioni, scegli Clerk e seleziona Genera l’URL del webhook.
- Nella dashboard di Clerk, apri Webhooks e aggiungi un endpoint con l’URL di Brew.
- Iscrivi l’endpoint ai 13 eventi supportati dei gruppi user, organization, organizationInvitation, organizationMembership, paymentAttempt, subscription, subscriptionItem e waitlistEntry, poi crealo.
- Mostra il secret di firma dell’endpoint, che inizia con whsec_, incollalo in Brew e seleziona Collega. Brew verifica ogni consegna secondo la specifica Standard Webhooks (Svix).
- In Clerk, apri la scheda Testing dell’endpoint, scegli user.created e seleziona Send Example. In Brew lo stato passa da “In attesa dell’evento di test” a “Collegato”. Un esempio serve solo a verificare il webhook: Brew non aggiunge contatti e non avvia automazioni.
- Il collegamento crea un trigger per ciascuno dei 13 eventi. Non esiste un interruttore per attivare o disattivare gli eventi.
- Crea un’automazione, seleziona il suo evento Clerk e invia un test mentre è ancora in bozza. Quando arriva un evento corrispondente, vengono eseguite solo le automazioni attive.

## Eventi Clerk supportati

Brew supporta questi 13 tipi di evento:

- user.created
- organization.created
- organizationInvitation.created
- organizationInvitation.accepted
- organizationInvitation.revoked
- organizationMembership.created
- paymentAttempt.created
- subscription.created
- subscriptionItem.freeTrialEnding
- subscriptionItem.pastDue
- subscriptionItem.canceled
- subscriptionItem.abandoned
- waitlistEntry.created

## Sincronizzazione dei contatti e personalizzazione

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.


## Posso usare paymentAttempt.created per un’email di pagamento non riuscito?

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.


## Perché un evento compare senza che venga inviata un’email?

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.


## Limiti e risoluzione dei problemi

- Brew non può creare né modificare utenti, organizzazioni o abbonamenti di Clerk.
- Solo i 13 eventi elencati avviano automazioni. Gli altri eventi Clerk, come gli aggiornamenti e le eliminazioni degli utenti, vengono registrati come non supportati.
- Se Clerk segnala un errore 401 a ogni consegna, il secret di firma in Brew non corrisponde al secret dell’endpoint in Clerk. Mostra il secret attuale in Clerk e ricollega Clerk con quel valore.
- Brew richiede che il secret di firma inizi con whsec_ e sia lungo almeno 24 caratteri.
- Verifica il consenso e la finalità di ogni email. Sincronizzare gli utenti Clerk non autorizza gli invii promozionali.

## Fonti e guide alla configurazione

- [Guida alla configurazione di Clerk](https://docs.brew.new/integrations/import/clerk)
- [Crea un’automazione](https://docs.brew.new/create-emails/build-an-automation)
- [Merge tag](https://docs.brew.new/create-emails/merge-tags)
- [Cosa puoi inviare con Brew](https://docs.brew.new/get-started/what-you-can-send)
- [Panoramica dei webhook di Clerk](https://clerk.com/docs/guides/development/webhooks/overview)

## Correlati

- [Tutte le integrazioni](https://brew.new/it/browse/integrations.md)
- [Registrati](https://brew.new/it/sign-up.md)
- Sito web: https://brew.new