Wysyłaj e-maile po zdarzeniach w Clerk

Połącz Clerk, aby wysyłać e-maile spójne z marką, gdy ktoś się rejestruje, dołącza do organizacji, zakłada subskrypcję w Clerk Billing lub zapisuje się na Twoją listę oczekujących. Clerk podpisuje każdy webhook, a Brew zamienia 13 typów zdarzeń w wyzwalacze automatyzacji.

Za logowanie, organizacje i płatności nadal odpowiada Clerk. Brew tylko nasłuchuje zdarzeń. Nie może zmieniać użytkowników, tworzyć organizacji ani pobierać opłat za subskrypcje.

• E-maile powitalne: Clerk wysyła zdarzenie user.created, gdy rejestruje się nowy użytkownik. Oprócz imienia i nazwiska dostępne są pola username, imageUrl i lastSignInAt.
• Onboarding zespołu: zdarzenie organizationMembership.created zawiera pola organizationName, organizationSlug i roleName nowego członka – zarówno po przyjęciu zaproszenia, jak i po bezpośrednim dodaniu do organizacji. Po przyjęciu zaproszenia Clerk wysyła też zdarzenie organizationInvitation.accepted, więc wybierz jeden wyzwalacz, aby uniknąć podwójnych powitań.
• E-maile w sprawie zaproszeń: zdarzenia organizationInvitation.created, organizationInvitation.accepted i organizationInvitation.revoked są kierowane na zaproszony adres i zawierają pola roleName, status i expiresAt. Nie zawierają nazwy organizacji, danych osoby zapraszającej ani linku do przyjęcia zaproszenia.
• E-maile powitalne dla subskrybentów: zdarzenie subscription.created zawiera pola planName, planSlug, planAmount, currency, periodStart i periodEnd.
• Przypomnienia o końcu okresu próbnego: Clerk wysyła zdarzenie subscriptionItem.freeTrialEnding z polami planName, planAmount, currency i periodEnd tuż przed tym, jak bezpłatny okres próbny w Clerk Billing zamieni się w płatną subskrypcję.
• Powiadomienia o zaległej płatności: Clerk wysyła zdarzenie subscriptionItem.pastDue, gdy za pozycję subskrypcji nie wpłynie płatność. Dodaj link do własnej strony płatności.
• E-maile po anulowaniu subskrypcji lub porzuceniu okresu próbnego: Clerk wysyła zdarzenie subscriptionItem.canceled, gdy pozycja subskrypcji zostanie anulowana. Zdarzenie subscriptionItem.abandoned zwykle oznacza, że okres próbny zakończył się bez zapisanej metody płatności.
• Potwierdzenia zapisu na listę oczekujących: Clerk wysyła zdarzenie waitlistEntry.created, gdy adres e-mail trafi na Twoją listę oczekujących w Clerk.

Zdarzenie organization.created nie zawiera adresu e-mail. Brew szuka identyfikatora użytkownika, który utworzył organizację, wśród tożsamości znanych mu już z wcześniejszych zdarzeń Clerk w bieżącym połączeniu. Jeśli znajdzie prawdziwy adres e-mail, zdarzenie jest przetwarzane dalej. Jeśli nie, Brew zapisuje zdarzenie z nieustalonym odbiorcą, nie tworzy kontaktu i nie uruchamia automatyzacji.

Wybierz dla endpointu także zdarzenie user.created, aby Brew mógł poznać adresy twórców organizacji. Jeśli e-mail za każdym razem musi do kogoś dotrzeć, użyj zdarzenia organizationMembership.created, które zawiera adres członka.

• Otwórz Integracje, wybierz Clerk i kliknij „Wygeneruj adres URL webhooka”.
• W panelu Clerk otwórz Webhooks i dodaj endpoint z adresem URL Brew.
• Wybierz dla endpointu 13 obsługiwanych zdarzeń z grup user, organization, organizationInvitation, organizationMembership, paymentAttempt, subscription, subscriptionItem i waitlistEntry, a potem go utwórz.
• Wyświetl sekret podpisujący endpointu (zaczyna się od whsec_), wklej go w Brew i kliknij Połącz. Brew weryfikuje każde dostarczenie zgodnie ze specyfikacją Standard Webhooks (Svix).
• W Clerk otwórz kartę Testing endpointu, wybierz user.created i kliknij Send Example. Status w Brew zmieni się z „Czeka na zdarzenie testowe” na „Połączona”. Przykładowe zdarzenie służy tylko do weryfikacji webhooka. Brew nie dodaje kontaktu i nie uruchamia automatyzacji.
• Kliknięcie Połącz tworzy wyzwalacze dla wszystkich 13 zdarzeń. Nie ma przełącznika do włączania lub wyłączania zdarzeń.
• Utwórz automatyzację, wybierz dla niej zdarzenie Clerk i wyślij test, dopóki jest jeszcze wersją roboczą. Po nadejściu pasującego zdarzenia uruchamiają się tylko aktywne automatyzacje.

Brew obsługuje 13 typów zdarzeń:

• 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

Każde zweryfikowane zdarzenie z prawdziwym adresem e-mail tworzy lub aktualizuje kontakt w Brew dopasowany po adresie e-mail – niezależnie od tego, czy jakaś automatyzacja korzysta z tego zdarzenia. Jeśli zdarzenie zawiera odpowiednie dane, Brew ustawia imię, nazwisko i pole clerk_user_id.

Zdarzenie user.created ustawia też pola clerk_username, clerk_image_url, clerk_signed_up_at i clerk_last_sign_in_at. Zdarzenia zaproszeń i członkostwa ustawiają pola clerk_organization_id, clerk_org_role i clerk_org_role_name. Zaproszenia dodają pole clerk_org_invitation_status, a członkostwa – pola clerk_organization_name i clerk_organization_slug.

Zdarzenia płatności ustawiają pola clerk_subscription_status i clerk_plan_name, a niektóre dodają clerk_plan_slug, clerk_subscription_period_end lub clerk_is_trialing. Zdarzenie paymentAttempt.created ustawia pola clerk_last_payment_attempt_status i clerk_last_payment_attempt_at. Zdarzenie waitlistEntry.created ustawia pole clerk_waitlist_status.

W tagach personalizacji korzystaj ze schematu danych zadeklarowanego dla wybranego zdarzenia. Każde zdarzenie zawiera pola email, firstName, lastName i createdAt. Pozostałe pola, np. planName, planAmount, roleName, organizationName i grandTotalFormatted, zależą od zdarzenia. Wartości planAmount i grandTotalAmount są podawane w najmniejszej jednostce waluty, więc dla dolarów amerykańskich wartość 2000 oznacza 20,00 USD. Znaczniki czasu są podawane jako czas uniksowy w sekundach.

Identyfikatory obiektów Clerk, np. identyfikatory użytkowników, organizacji i subskrypcji, nie są tagami personalizacji. Identyfikator użytkownika trafia do kontaktu jako pole clerk_user_id.

Konto w Clerk nie oznacza zgody na e-maile marketingowe. Zapisuj zgodę przy rejestracji i sprawdzaj ją przed wysyłkami promocyjnymi.

Nie można na tym polegać. Brew odbiera tylko zdarzenie paymentAttempt.created, a nie późniejsze aktualizacje tej próby płatności. Pole status tego zdarzenia może mieć wartość pending, paid lub failed, ale płatność, która nie powiedzie się już po utworzeniu próby, dociera do Brew jako nieobsługiwane zdarzenie. W przypadku zaległych płatności użyj zdarzenia subscriptionItem.pastDue. Jeśli chcesz podać łączną kwotę w treści e-maila, skorzystaj z pola grandTotalFormatted, które zawiera gotową, sformatowaną wartość, np. „$22.00”.

Odebranie zdarzenia i wysłanie e-maila to osobne kroki. Upewnij się, że pasująca automatyzacja jest aktywna, a potem przejrzyj jej filtry i historię uruchomień, sprawdź, czy odbiorca może otrzymać wiadomość, i skontroluj domenę wysyłkową. Zdarzenie wysłane przyciskiem Send Example weryfikuje webhook, ale nigdy nie uruchamia automatyzacji, a zdarzenie organization.created bez znanego twórcy jest zapisywane z nieustalonym odbiorcą.

• Brew nie może tworzyć ani zmieniać w Clerk użytkowników, organizacji ani subskrypcji.
• Automatyzacje uruchamia tylko 13 wymienionych zdarzeń. Inne zdarzenia Clerk, np. aktualizacje i usunięcia użytkowników, są zapisywane jako nieobsługiwane.
• Jeśli Clerk przy każdym dostarczeniu zgłasza błąd 401, sekret podpisujący w Brew nie pasuje do sekretu endpointu w Clerk. Wyświetl aktualny sekret w Clerk i użyj go, aby połączyć Clerk ponownie.
• Brew wymaga, aby sekret podpisujący zaczynał się od whsec_ i miał co najmniej 24 znaki.
• Sprawdź zgody i cel każdego e-maila. Synchronizacja użytkowników Clerk nie upoważnia do wysyłek promocyjnych.

• Instrukcja konfiguracji Clerk
• Zbuduj automatyzację
• Tagi personalizacji
• Co możesz wysyłać przez Brew
• Przegląd webhooków Clerk