# Clerk + Brew

Spouštěj automatizace v Brew pomocí událostí webhooků ze služby Clerk – registrací uživatelů, změn v organizacích, placených předplatných a zápisů na čekací listinu.

Kanonická URL: https://brew.new/cs/browse/integrations/clerk

- Směr: Příchozí data
- Připojení: Tajemství webhooku
- Spouštěče událostí autentizace

## Dostupné funkce

- **Spouštěče událostí**: Spouštěj automatizace v Brew pomocí 13 událostí webhooků ze služby Clerk napříč kategoriemi uživatel, organizace, fakturace a čekací listina.

## Udělej z událostí Clerk užitečné e-maily

Připoj Clerk a spouštěj e-maily v duchu značky, když se někdo zaregistruje, připojí se k organizaci, pořídí si předplatné přes Clerk Billing nebo se zapíše na tvou čekací listinu. Clerk každý webhook podepisuje a Brew promění 13 typů událostí ve spouštěče automatizací.

Přihlašování, organizace a fakturaci má dál na starosti Clerk. Brew události jen přijímá. Nemůže měnit uživatele, zakládat organizace ani účtovat předplatné.


## Co můžeš vytvořit

- Uvítací e-maily: událost user.created nastane, když se zaregistruje nový uživatel. Kromě jména jsou k dispozici i pole username, imageUrl a lastSignInAt.
- Onboarding týmu: událost organizationMembership.created obsahuje pro nového člena pole organizationName, organizationSlug a roleName, ať už přijal pozvánku, nebo ho do organizace někdo přidal přímo. Při přijetí pozvánky nastane i událost organizationInvitation.accepted, takže vyber jen jeden spouštěč, aby uvítání nepřišlo dvakrát.
- Navazující e-maily k pozvánkám: události organizationInvitation.created, organizationInvitation.accepted a organizationInvitation.revoked míří na pozvanou adresu a obsahují pole roleName, status a expiresAt. Neobsahují název organizace, údaje o tom, kdo pozvánku poslal, ani odkaz na její přijetí.
- Uvítací e-maily pro předplatitele: událost subscription.created obsahuje pole planName, planSlug, planAmount, currency, periodStart a periodEnd.
- Připomínky konce zkušební verze: událost subscriptionItem.freeTrialEnding nastane krátce předtím, než se bezplatná zkušební verze v Clerk Billing změní na placené předplatné, a obsahuje pole planName, planAmount, currency a periodEnd.
- Upozornění na platbu po splatnosti: událost subscriptionItem.pastDue nastane, když u položky předplatného neproběhne platba. Odkaž na vlastní stránku s fakturací.
- Navazující e-maily po zrušení nebo opuštění zkušební verze: událost subscriptionItem.canceled nastane, když je položka předplatného zrušena. Událost subscriptionItem.abandoned obvykle znamená, že zkušební verze skončila bez uložené platební metody.
- Potvrzení zápisu na čekací listinu: událost waitlistEntry.created nastane, když se na tvou čekací listinu ve službě Clerk zapíše e-mailová adresa.

## Události organizací potřebují známého zakladatele

Událost organization.created neobsahuje e-mailovou adresu. Brew proto hledá ID uživatele, který organizaci založil, mezi identitami, které už zachytil v dřívějších událostech ze služby Clerk na aktuálním připojení. Pokud najde skutečný e-mail, událost se zpracuje dál. Pokud ne, Brew událost zaznamená s nedohledaným příjemcem, nevytvoří žádný kontakt a nespustí žádnou automatizaci.

Nech endpoint odebírat i událost user.created, aby Brew adresy zakladatelů znal. Pokud musí e-mail dorazit ke konkrétnímu člověku pokaždé, použij událost organizationMembership.created, která obsahuje adresu člena.


## Nastavení Clerk v Brew

- Otevři Integrace, vyber Clerk a klikni na Vygenerovat URL webhooku.
- V administraci Clerk otevři Webhooks a přidej endpoint s URL z Brew.
- Nastav endpoint tak, aby odebíral 13 podporovaných událostí ze skupin user, organization, organizationInvitation, organizationMembership, paymentAttempt, subscription, subscriptionItem a waitlistEntry, a pak ho vytvoř.
- Zobraz podpisové tajemství endpointu (začíná na whsec_), vlož ho do Brew a klikni na Připojit. Brew každé doručení ověřuje podle specifikace Standard Webhooks (Svix).
- Ve službě Clerk otevři u endpointu kartu Testing, vyber user.created a klikni na Send Example. Stav v Brew se změní z „Čeká na testovací událost“ na „Připojeno“. Ukázková událost webhook jen ověří. Brew nepřidá žádný kontakt a nespustí žádnou automatizaci.
- Po kliknutí na Připojit vzniknou spouštěče pro všech 13 událostí. Jednotlivé události nejde zapnout ani vypnout.
- Vytvoř automatizaci, vyber pro ni událost ze služby Clerk a pošli test, dokud je to ještě koncept. Když dorazí odpovídající událost, spustí se jen aktivní automatizace.

## Podporované události Clerk

Brew podporuje těchto 13 typů událostí:

- 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

## Synchronizace kontaktů a personalizace

Každá ověřená událost se skutečnou e-mailovou adresou vytvoří nebo aktualizuje kontakt v Brew s touto adresou, a to bez ohledu na to, jestli událost používá nějaká automatizace. Pokud jsou data k dispozici, Brew nastaví jméno, příjmení a clerk_user_id.

Událost user.created navíc nastaví clerk_username, clerk_image_url, clerk_signed_up_at a clerk_last_sign_in_at. Události pozvánek a členství nastaví clerk_organization_id, clerk_org_role a clerk_org_role_name. Pozvánky k tomu přidají clerk_org_invitation_status a členství clerk_organization_name a clerk_organization_slug.

Fakturační události nastaví clerk_subscription_status a clerk_plan_name a některé přidají i clerk_plan_slug, clerk_subscription_period_end nebo clerk_is_trialing. Událost paymentAttempt.created nastaví clerk_last_payment_attempt_status a clerk_last_payment_attempt_at. Událost waitlistEntry.created nastaví clerk_waitlist_status.

Pro proměnné vycházej z deklarovaného schématu payloadu vybrané události. Každá událost obsahuje pole email, firstName, lastName a createdAt. Další pole závisí na události, například planName, planAmount, roleName, organizationName a grandTotalFormatted. Hodnoty planAmount a grandTotalAmount jsou v nejmenší jednotce měny, takže 2000 v USD znamená 20,00 US$. Časová razítka jsou unixový čas v sekundách.

Identifikátory objektů Clerk, například ID uživatelů, organizací a předplatných, nejsou proměnné. ID uživatele se u kontaktu uloží jako clerk_user_id.

Účet ve službě Clerk neznamená souhlas s marketingovými e-maily. Souhlas zaznamenej už při registraci a před propagačními rozesílkami ho ověř.


## Může událost paymentAttempt.created spustit e-mail o neúspěšné platbě?

Spolehlivě ne. Brew přijímá jen událost paymentAttempt.created, ne pozdější aktualizace daného pokusu o platbu. Její pole status může mít hodnotu pending, paid nebo failed, ale platba, která selže až po vytvoření pokusu, dorazí do Brew jako nepodporovaná událost. Pro zmeškané platby použij subscriptionItem.pastDue. Pokud chceš v textu e-mailu uvést celkovou částku, pole grandTotalFormatted obsahuje už naformátovanou hodnotu, například $22.00.


## Proč se událost zobrazí, ale e-mail neodejde?

Přijetí události a odeslání e-mailu jsou samostatné kroky. Ověř, že odpovídající automatizace je aktivní, a pak projdi její filtry a historii běhů a zkontroluj, jestli má příjemce na e-mail nárok a jak je na tom odesílací doména. Doručení přes Send Example webhook ověří, ale nikdy nespustí žádnou automatizaci, a událost organization.created bez známého zakladatele se zaznamená s nedohledaným příjemcem.


## Omezení a řešení potíží

- Brew nemůže vytvářet ani měnit uživatele, organizace ani předplatná ve službě Clerk.
- Jen 13 uvedených událostí spouští automatizace. Ostatní události ze služby Clerk, například úpravy a smazání uživatelů, se zaznamenají jako nepodporované.
- Pokud Clerk u každého doručení hlásí chybu 401, podpisové tajemství v Brew neodpovídá tajemství endpointu ve službě Clerk. Zobraz ve službě Clerk aktuální tajemství a připoj Clerk s ním znovu.
- Brew vyžaduje, aby podpisové tajemství začínalo na whsec_ a mělo alespoň 24 znaků.
- U každého e-mailu zkontroluj souhlas a účel. Synchronizace uživatelů ze služby Clerk tě neopravňuje k propagačním rozesílkám.

## Zdroje a návody k nastavení

- [Návod k nastavení Clerk](https://docs.brew.new/integrations/import/clerk)
- [Vytvoř automatizaci](https://docs.brew.new/create-emails/build-an-automation)
- [Proměnné](https://docs.brew.new/create-emails/merge-tags)
- [Co můžeš posílat přes Brew](https://docs.brew.new/get-started/what-you-can-send)
- [Přehled webhooků Clerk](https://clerk.com/docs/guides/development/webhooks/overview)

## Související

- [Všechny integrace](https://brew.new/cs/browse/integrations.md)
- [Registrace](https://brew.new/cs/sign-up.md)
- Web: https://brew.new