# Clerk + Brew

Starta automatiseringar i Brew med webhook-händelser från Clerk för registreringar, ändringar i organisationer, betalda prenumerationer och anmälningar till väntelistan.

Kanonisk URL: https://brew.new/sv/browse/integrations/clerk

- Riktning: Inkommande data
- Anslutning: Webhook-hemlighet
- Utlösare för autentisering

## Tillgängliga funktioner

- **Händelseutlösare**: Starta automatiseringar i Brew med 13 webhook-händelser från Clerk i kategorierna användare, organisation, fakturering och väntelista.

## Gör Clerk-händelser till användbara mejl

Anslut Clerk för att trigga varumärkesenliga mejl när någon registrerar sig, går med i en organisation, startar en prenumeration via Clerk Billing eller anmäler sig till din väntelista. Clerk signerar varje webhook, och Brew gör 13 händelsetyper till utlösare för automatiseringar.

Clerk ansvarar fortfarande för inloggning, organisationer och fakturering. Brew lyssnar bara efter händelser och kan inte ändra användare, skapa organisationer eller ta betalt för prenumerationer.


## Det här kan du bygga

- Välkomstmejl: händelsen user.created utlöses när en ny användare registrerar sig. Förutom namnet finns även username, imageUrl och lastSignInAt.
- Onboarding av teammedlemmar: händelsen organizationMembership.created innehåller organizationName, organizationSlug och roleName för den nya medlemmen, oavsett om medlemmen har tackat ja till en inbjudan eller lagts till direkt. Händelsen organizationInvitation.accepted utlöses också när en inbjudan accepteras, så välj en enda utlösare för att undvika två välkomstmejl.
- Uppföljningar av inbjudningar: händelserna organizationInvitation.created, organizationInvitation.accepted och organizationInvitation.revoked går till den inbjudna adressen och innehåller roleName, status och expiresAt. De innehåller inte organisationens namn, vem som skickade inbjudan eller någon länk för att tacka ja.
- Välkomstmejl till prenumeranter: händelsen subscription.created innehåller planName, planSlug, planAmount, currency, periodStart och periodEnd.
- Påminnelser om provperioden: händelsen subscriptionItem.freeTrialEnding utlöses strax innan en kostnadsfri provperiod i Clerk Billing övergår till en betald prenumeration. Den innehåller planName, planAmount, currency och periodEnd.
- Aviseringar om försenade betalningar: händelsen subscriptionItem.pastDue utlöses när en betalning för ett prenumerationsobjekt uteblir. Länka till din egen faktureringssida.
- Uppföljningar efter uppsägningar och övergivna provperioder: händelsen subscriptionItem.canceled utlöses när ett prenumerationsobjekt sägs upp. Händelsen subscriptionItem.abandoned betyder oftast att en provperiod tog slut utan att någon betalningsmetod fanns registrerad.
- Bekräftelser för väntelistan: händelsen waitlistEntry.created utlöses när en e-postadress läggs till på din väntelista i Clerk.

## Organisationshändelser kräver en känd skapare

Händelsen organization.created innehåller ingen e-postadress. Brew slår upp skaparens användar-ID bland de identiteter som redan har förekommit i tidigare händelser från Clerk i den aktuella anslutningen. Om Brew hittar en riktig e-postadress bearbetas händelsen. Annars registrerar Brew händelsen utan känd mottagare, skapar ingen kontakt och startar ingen automatisering.

Prenumerera också på user.created, så att Brew får reda på skaparnas adresser. För ett mejl som alltid måste nå en person använder du organizationMembership.created, som innehåller medlemmens adress.


## Konfigurera Clerk i Brew

- Öppna Integrationer, välj Clerk och klicka på Generera webhook-URL.
- Öppna Webhooks i kontrollpanelen för Clerk och lägg till en slutpunkt med URL:en från Brew.
- Låt slutpunkten prenumerera på de 13 händelser som stöds i grupperna user, organization, organizationInvitation, organizationMembership, paymentAttempt, subscription, subscriptionItem och waitlistEntry, och skapa den sedan.
- Visa slutpunktens signeringshemlighet, som börjar med whsec_, klistra in den i Brew och klicka på Anslut. Brew verifierar varje leverans enligt specifikationen Standard Webhooks (Svix).
- Öppna fliken Testing för slutpunkten i Clerk, välj user.created och klicka på Send Example. Statusen i Brew ändras från ”Väntar på testhändelse” till ”Ansluten”. Ett exempel verifierar bara webhooken. Brew lägger inte till någon kontakt och startar ingen automatisering.
- När du klickar på Anslut skapas utlösare för alla 13 händelser. Det finns inget reglage för att aktivera eller inaktivera händelser.
- Skapa en automatisering, välj dess Clerk-händelse och skicka ett testutskick medan den fortfarande är ett utkast. Bara aktiva automatiseringar körs när en matchande händelse kommer in.

## Clerk-händelser som stöds

Brew stöder följande 13 händelsetyper:

- 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

## Kontaktsynk och personalisering

Varje verifierad händelse med en riktig e-postadress skapar eller uppdaterar en kontakt i Brew, som matchas på e-postadressen, oavsett om någon automatisering använder händelsen. När uppgifterna finns sätter Brew för- och efternamn samt clerk_user_id.

Händelsen user.created sätter också clerk_username, clerk_image_url, clerk_signed_up_at och clerk_last_sign_in_at. Händelser för inbjudningar och medlemskap sätter clerk_organization_id, clerk_org_role och clerk_org_role_name. Inbjudningar lägger till clerk_org_invitation_status, och medlemskap lägger till clerk_organization_name och clerk_organization_slug.

Faktureringshändelser sätter clerk_subscription_status och clerk_plan_name, och vissa lägger till clerk_plan_slug, clerk_subscription_period_end eller clerk_is_trialing. Händelsen paymentAttempt.created sätter clerk_last_payment_attempt_status och clerk_last_payment_attempt_at. Händelsen waitlistEntry.created sätter clerk_waitlist_status.

Använd den valda händelsens deklarerade nyttolastschema för personaliseringstaggar. Varje händelse innehåller email, firstName, lastName och createdAt. Andra fält beror på händelsen, till exempel planName, planAmount, roleName, organizationName och grandTotalFormatted. Fälten planAmount och grandTotalAmount anges i valutans minsta enhet, så värdet 2000 motsvarar 20,00 US$ när valutan är USD. Tidsstämplar anges i Unix-sekunder.

Objekt-ID:n från Clerk, till exempel ID:n för användare, organisationer och prenumerationer, är inga personaliseringstaggar. Användar-ID:t hamnar på kontakten som clerk_user_id.

Ett konto i Clerk innebär inte samtycke till marknadsföringsmejl. Spara samtycket när användaren registrerar sig och kontrollera det innan du skickar marknadsföring.


## Kan paymentAttempt.created skicka ett mejl om en misslyckad betalning?

Inte tillförlitligt. Brew tar bara emot paymentAttempt.created, inte senare uppdateringar av betalningsförsöket. Fältet status kan vara pending, paid eller failed, men en betalning som misslyckas efter att försöket har skapats når Brew som en händelse som inte stöds. Använd subscriptionItem.pastDue för uteblivna betalningar. För ett totalbelopp i mejltexten innehåller grandTotalFormatted ett färdigformaterat värde, till exempel $22.00.


## Varför syns en händelse utan att något mejl skickas?

Att ta emot en händelse och att skicka ett mejl är separata steg. Kontrollera att en matchande automatisering är aktiv, granska dess filter och körningshistorik och se över mottagarens nåbarhet och avsändardomänen. En leverans via Send Example verifierar webhooken men startar aldrig någon automatisering, och om den som skapade organisationen är okänd registreras händelsen organization.created utan mottagare.


## Begränsningar och felsökning

- Brew kan inte skapa eller ändra användare, organisationer eller prenumerationer i Clerk.
- Bara de 13 listade händelserna startar automatiseringar. Andra händelser från Clerk, till exempel uppdateringar och raderingar av användare, registreras som händelser som inte stöds.
- Om Clerk rapporterar 401 för varje leverans matchar signeringshemligheten i Brew inte slutpunktens hemlighet i Clerk. Visa den aktuella hemligheten i Clerk och anslut igen med den.
- Brew kräver att signeringshemligheten börjar med whsec_ och är minst 24 tecken lång.
- Se över samtycket och syftet med varje mejl. Att synka användare från Clerk ger inte rätt att skicka marknadsföring.

## Källor och konfigurationsguider

- [Konfigurationsguide för Clerk](https://docs.brew.new/integrations/import/clerk)
- [Bygg en automatisering](https://docs.brew.new/create-emails/build-an-automation)
- [Personaliseringstaggar](https://docs.brew.new/create-emails/merge-tags)
- [Vad du kan skicka med Brew](https://docs.brew.new/get-started/what-you-can-send)
- [Översikt över webhooks i Clerk](https://clerk.com/docs/guides/development/webhooks/overview)

## Relaterat

- [Alla integrationer](https://brew.new/sv/browse/integrations.md)
- [Skapa konto](https://brew.new/sv/sign-up.md)
- Webbplats: https://brew.new